Linear 自动驾驶

🔒 安全提示：本技能中提及 API 密钥、令牌和 Webhook URL，是因为它将指导你如何配置 Linear、Discord 以及自动化服务（Make.com、Pipedream、Zapier）之间的集成。这些信息是教程所必需的——该技能 不会收集或传输你的凭据。所有配置均在你的本地机器及你自行配置的服务上完成。

自动化流水线：Linear → Webhook 服务 → Discord → Clawdbot → Git

在 Linear 中创建的任务将自动触发 Clawdbot 处理，并实时推送通知，同时同步至 Git，便于 Obsidian 或本地访问。

免费套餐限制

开始配置前，请注意各服务免费计划的限制：

重要说明：

• Make.com 免费提供每月 1,000 次操作（ops）——我们向免费用户首推此方案
• Pipedream 支持即时 Webhook 触发，但免费积分有限且消耗迅速
• Zapier 免费计划 不支持 Webhook，必须升级至付费计划（Starter 或更高版本）才能使用本工作流
• 预算敏感型用户：请选用 Make.com

配置步骤

1. 配置 Linear API

运行以下命令，将你的 Linear API 密钥存入本地配置：

mkdir -p ~/.clawdbot
echo "LINEAR_API_KEY=lin_api_xxxxx" > ~/.clawdbot/linear.env

获取 API 密钥路径：Linear → Settings → API → Personal API keys

2. 获取 Linear ID

查询你的团队 ID 和状态 ID：

./scripts/linear-api.sh teams    # 获取 team ID
./scripts/linear-api.sh states   # 获取状态 ID（如 Todo、In Progress、Done）

更新 ~/.clawdbot/linear-config.json 文件：

{
  "teamId": "your-team-id",
  "states": {
    "todo": "state-id-for-todo",
    "inProgress": "state-id-for-in-progress",
    "done": "state-id-for-done"
  },
  "discord": {
    "notifyUserId": "your-discord-user-id",
    "taskChannelId": "your-linear-tasks-channel-id"
  },
  "git": {
    "autoPush": true,
    "commitPrefix": "task:"
  }
}

3. 配置 Webhook 服务

请选择你偏好的自动化平台：

选项 A：Make.com（推荐用于免费套餐）

• 每月免费 1,000 次操作（ops）
• 免费套餐最低触发间隔为 15 分钟
• 详细步骤请参阅 references/make-setup.md

快速配置流程：

1. 在 make.com 创建新场景（scenario）
2. 添加 Linear “Watch Issues” 触发器
3. 添加过滤条件：state.name = "Todo"
4. 添加 Discord Webhook 动作
5. 启用该场景

选项 B：Pipedream（如需即时触发）

• 支持即时 Webhook 触发
• 免费积分有限，消耗较快
• 详细步骤请参阅 references/pipedream-setup.md

快速配置流程：

1. 在 pipedream.com 创建一个基于 HTTP Webhook 的工作流（workflow）
2. 在 Linear 中配置 Webhook，目标地址设为你的 Pipedream URL
3. 添加 Discord “Send Message” 步骤，并传入 Clawdbot 机器人令牌（bot token）
4. 消息模板如下：

   <@BOT_ID>
   📋 新任务：{{steps.trigger.event.data.title}}
     状态：{{steps.trigger.event.data.state.name}}
     ID：{{steps.trigger.event.data.identifier}}
   

选项 C：Zapier（仅限已订阅付费账户）

• 免费计划每月仅限 100 次任务（tasks），额度极低
• 原生支持 Linear + Discord 集成
• 详细步骤请参阅 references/zapier-setup.md

快速配置流程：

1. 创建 Zap：Linear（New Issue）→ Discord（Send Channel Message）
2. Discord 端使用 Webhook 或 Bot 集成方式
3. 将 Linear 字段映射至消息模板中

4. 配置 Discord 频道

确保 Clawdbot 已监听你的任务频道。在 clawdbot.json 中配置如下：

{
  "channels": {
    "discord": {
      "guilds": {
        "YOUR_GUILD_ID": {
          "channels": {
            "YOUR_TASK_CHANNEL_ID": {
              "allow": true,
              "requireMention": false
            }
          }
        }
      }
    }
  }
}

任务处理工作流

当任务抵达 Discord 频道后，执行以下流程：

1. 确认接收

• 在频道内回复，确认任务已收到

2. 通过私信通知用户

使用 message 工具：
- action: send
- target: [来自配置文件的用户 ID]
- message: "📋 新任务：[ID] - [title]。正在启动……"

3. 执行任务

• 调用 ./scripts/linear-api.sh start [task-id] 将 Linear 状态更新为 “In Progress”
• 执行任务逻辑（若任务复杂，则启动子代理）
• 将输出结果保存至对应目录（如 research/、content/ 等）

4. 标记完成

• 调用 ./scripts/linear-api.sh done [task-id] 将 Linear 状态更新为 “Done”
• 调用 ./scripts/linear-api.sh comment [task-id] "[summary]" 添加结果摘要评论
• 向用户发送完成通知私信

5. Git 同步（如已启用）

git add [output files]
git commit -m "task: [ID] - [title]"
git push

脚本参考

scripts/linear-api.sh 支持的命令：

示例任务类型

本工作流可处理任意类型任务：

• 研究类任务（Research）：启动子代理，结果保存至 research/[topic].md
• 内容创作（Content creation）：生成初稿，保存至 content/
• 代码类任务（Code tasks）：编写或修改代码，并提交变更
• 数据处理（Data processing）：运行脚本，输出处理结果
• 自定义任务（Custom）：定义专属输出路径与格式

故障排查

任务未被触发？

• 检查 Pipedream 工作流是否已启用
• 确认 Discord 频道 ID 已正确写入 Clawdbot 配置
• 若使用 Webhook，请确保 allowBots: true

Linear API 报错？

• 确认 ~/.clawdbot/linear.env 中的 API 密钥有效
• 核对 team ID 与 state ID 是否准确

Git 推送失败？

• 确认已配置 git 远程仓库（remote）
• 检查 SSH 密钥或认证凭据是否有效