Linear Autopilot
🔒 Security Note: This skill mentions API keys, tokens, and webhook URLs because it teaches you how to set up integrations with Linear, Discord, and automation services (Make.com, Pipedream, Zapier). These are necessary for the tutorial — the skill does NOT collect or transmit your credentials. All setup happens on your local machine and the services you configure.
Automated pipeline: Linear → Webhook Service → Discord → Clawdbot → Git
Tasks created in Linear automatically trigger Clawdbot processing with real-time notifications and git sync for Obsidian/local access.
Free Tier Limitations
Before setup, be aware of free plan limits:
| Service | Free Tier Limits | Recommendation |
|---|
| Linear | 250 issues, unlimited members | Sufficient for most personal/small team use |
| Make.com |
1,000 ops/month, 2 scenarios, 15-min interval | ✅
Best free option — generous limits |
|
Pipedream | ~100 credits (unclear reset), instant triggers | Good if you need real-time, burns credits fast |
|
Zapier | 100 tasks/month, 5 zaps, 15-min polling,
no webhooks | ⚠️ Paid plan required for this workflow |
Important notes:
- - Make.com offers 1,000 ops/month free — our recommendation for free tier users
- Pipedream has instant webhooks but limited free credits that deplete quickly
- Zapier free plan does NOT support webhooks. You need a paid Zapier plan (Starter+)
- For budget-conscious users: use Make.com
Setup
1. Configure Linear API
Run setup to store your Linear API key:
CODEBLOCK0
Get your API key from: Linear → Settings → API → Personal API keys
2. Get Linear IDs
Find your team and state IDs:
CODEBLOCK1
Update ~/.clawdbot/linear-config.json:
CODEBLOCK2
3. Set Up Webhook Service
Choose your preferred automation platform:
Option A: Make.com (Recommended for free tier)
- - 1,000 operations/month free
- 15-minute minimum interval on free tier
- See
references/make-setup.md for step-by-step guide
Quick setup:
- 1. Create scenario at make.com
- Add Linear "Watch Issues" trigger
- Add filter: state.name = "Todo"
- Add Discord webhook action
- Activate scenario
Option B: Pipedream (If you need instant triggers)
- - Instant webhook triggers
- Limited free credits (deplete fast)
- See
references/pipedream-setup.md for step-by-step guide
Quick setup:
- 1. Create workflow at pipedream.com with HTTP webhook trigger
- Add Linear webhook pointing to your Pipedream URL
- Add Discord "Send Message" step with Clawdbot bot token
- Message template:
CODEBLOCK3
Option B: Zapier (If you have a paid account)
- - 100 tasks/month on free (very limited)
- Native Linear + Discord integrations
- See
references/zapier-setup.md for step-by-step guide
Quick setup:
- 1. Create Zap: Linear (New Issue) → Discord (Send Channel Message)
- Use webhook or bot integration for Discord
- Map Linear fields to message template
4. Configure Discord Channel
Ensure Clawdbot listens to your task channel. In clawdbot.json:
CODEBLOCK4
Task Processing Workflow
When a task arrives in the Discord channel:
1. Acknowledge
- - Reply in channel confirming receipt
2. Notify User via DM
CODEBLOCK5
3. Process Task
- - Update Linear status → "In Progress" via INLINECODE5
- Execute the task (spawn sub-agent if complex)
- Save outputs to appropriate location (research/, content/, etc.)
4. Complete
- - Update Linear status → "Done" via INLINECODE6
- Add comment with results via INLINECODE7
- Send completion DM to user
5. Git Sync (if enabled)
CODEBLOCK6
Script Reference
INLINECODE8 commands:
| Command | Description |
|---|
| INLINECODE9 | List teams and IDs |
| INLINECODE10 |
List workflow states |
|
get [id] | Get task details |
|
pending | List pending tasks |
|
start [id] | Mark as In Progress |
|
done [id] | Mark as Done |
|
comment [id] "text" | Add comment to task |
Example Task Types
This workflow handles any task type:
- - Research: Spawn sub-agent, save to INLINECODE16
- Content creation: Generate drafts, save to INLINECODE17
- Code tasks: Write/modify code, commit changes
- Data processing: Run scripts, output results
- Custom: Define your own output patterns
Troubleshooting
Tasks not triggering?
- - Check Pipedream workflow is enabled
- Verify Discord channel is in Clawdbot config
- Ensure
allowBots: true if using webhook
Linear API errors?
- - Verify API key in INLINECODE19
- Check team/state IDs are correct
Git push failing?
- - Ensure git remote is configured
- Check SSH key or credentials
线性自动驾驶仪
🔒 安全说明： 本技能涉及API密钥、令牌和Webhook URL，因为它会教你如何设置与Linear、Discord以及自动化服务（Make.com、Pipedream、Zapier）的集成。这些是教程必需的——本技能不会收集或传输你的凭证。所有设置都在你的本地机器和你配置的服务上完成。
自动化流水线：Linear → Webhook服务 → Discord → Clawdbot → Git
在Linear中创建的任务会自动触发Clawdbot处理，并附带实时通知和用于Obsidian/本地访问的Git同步。
免费版限制
在设置之前，请注意免费计划的限制：
| 服务 | 免费版限制 | 推荐 |
|---|
| Linear | 250个问题，无限成员 | 足以满足大多数个人/小团队使用 |
| Make.com |
每月1,000次操作，2个场景，15分钟间隔 | ✅
最佳免费选项 — 慷慨的限制 |
|
Pipedream | ~100个积分（重置时间不明确），即时触发 | 如果需要实时处理则不错，但积分消耗快 |
|
Zapier | 每月100个任务，5个Zap，15分钟轮询，
无Webhook | ⚠️ 此工作流需要付费计划 |
重要说明：
- - Make.com 免费提供每月1,000次操作 — 我们推荐免费用户使用
- Pipedream 有即时Webhook但免费积分有限且消耗很快
- Zapier 免费计划不支持Webhook。你需要付费的Zapier计划（Starter+）
- 对于预算有限的用户：使用Make.com
设置
1. 配置Linear API
运行设置以存储你的Linear API密钥：
bash
mkdir -p ~/.clawdbot
echo LINEARAPIKEY=linapixxxxx > ~/.clawdbot/linear.env
从以下位置获取你的API密钥：Linear → 设置 → API → 个人API密钥
2. 获取Linear ID
找到你的团队和状态ID：
bash
./scripts/linear-api.sh teams # 获取团队ID
./scripts/linear-api.sh states # 获取状态ID（待办、进行中、已完成）
更新 ~/.clawdbot/linear-config.json：
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次操作
- 免费版最低15分钟间隔
- 参见 references/make-setup.md 获取分步指南
快速设置：
- 1. 在make.com创建场景
- 添加Linear监控问题触发器
- 添加筛选条件：state.name = Todo
- 添加Discord webhook操作
- 激活场景
选项B：Pipedream（如果需要即时触发）
- - 即时Webhook触发
- 免费积分有限（消耗快）
- 参见 references/pipedream-setup.md 获取分步指南
快速设置：
- 1. 在pipedream.com创建带有HTTP webhook触发器的工作流
- 添加指向你Pipedream URL的Linear webhook
- 添加带有Clawdbot机器人令牌的Discord发送消息步骤
- 消息模板：
<@BOT_ID>
📋 新任务：{{steps.trigger.event.data.title}}
状态：{{steps.trigger.event.data.state.name}}
ID：{{steps.trigger.event.data.identifier}}
选项B：Zapier（如果有付费账户）
- - 免费版每月100个任务（非常有限）
- 原生Linear + Discord集成
- 参见 references/zapier-setup.md 获取分步指南
快速设置：
- 1. 创建Zap：Linear（新问题）→ Discord（发送频道消息）
- 为Discord使用webhook或机器人集成
- 将Linear字段映射到消息模板
4. 配置Discord频道
确保Clawdbot监听你的任务频道。在 clawdbot.json 中：
json
{
channels: {
discord: {
guilds: {
YOURGUILDID: {
channels: {
YOURTASKCHANNEL_ID: {
allow: true,
requireMention: false
}
}
}
}
}
}
}
任务处理工作流
当任务到达Discord频道时：
1. 确认
2. 通过私信通知用户
使用消息工具：
- - action: send
- target: [配置中的用户ID]
- message: 📋 新任务：[ID] - [标题]。现在开始...
3. 处理任务
- - 通过 ./scripts/linear-api.sh start [task-id] 将Linear状态更新为进行中
- 执行任务（如果复杂则生成子代理）
- 将输出保存到适当位置（research/、content/等）
4. 完成
- - 通过 ./scripts/linear-api.sh done [task-id] 将Linear状态更新为已完成
- 通过 ./scripts/linear-api.sh comment [task-id] [摘要] 添加带结果的评论
- 向用户发送完成私信
5. Git同步（如果启用）
bash
git add [输出文件]
git commit -m task: [ID] - [标题]
git push
脚本参考
scripts/linear-api.sh 命令：
列出工作流状态 |
| get [id] | 获取任务详情 |
| pending | 列出待处理任务 |
| start [id] | 标记为进行中 |
| done [id] | 标记为已完成 |
| comment [id] 文本 | 向任务添加评论 |
任务类型示例
此工作流处理任何任务类型：
- - 研究：生成子代理，保存到 research/[主题].md
- 内容创作：生成草稿，保存到 content/
- 代码任务：编写/修改代码，提交更改
- 数据处理：运行脚本，输出结果
- 自定义：定义你自己的输出模式
故障排除
任务未触发？
- - 检查Pipedream工作流是否已启用
- 验证Discord频道是否在Clawdbot配置中
- 如果使用webhook，确保 allowBots: true
Linear API错误？
- - 验证 ~/.clawdbot/linear.env 中的API密钥
- 检查团队/状态ID是否正确
Git推送失败？
