Linear Webhook Skill

Enables Linear issue comment @mentions to dispatch tasks to Clawdbot agents.

How It Works

1. 1. Comment in Linear: @mason implement user authentication or INLINECODE1
2. Linear webhook fires on comment creation
3. Clawdbot receives webhook via exposed endpoint
4. Transform parses payload:

1. 5. Routes to agent session:

1. 6. Agent processes task and returns result
2. Result posted back as Linear comment

Setup

1. Configure Clawdbot Webhooks

Add to your config.json5:

CODEBLOCK0

2. Expose Webhook Endpoint

Use Cloudflare Tunnel or Tailscale Funnel to make webhook publicly accessible:

Option A: Cloudflare Tunnel (Recommended)
CODEBLOCK1

Option B: Tailscale Funnel
CODEBLOCK2

Note the public URL (e.g., https://your-tunnel.trycloudflare.com)

3. Configure Linear Webhook

1. 1. Go to Linear Settings → API → Webhooks
2. Click "Create new webhook"
3. Set URL: INLINECODE6
4. Add custom header: INLINECODE7
5. Select events: Comment → Created
6. Save webhook

4. Test

Comment in a Linear issue:
CODEBLOCK3

Expected flow:

1. 1. Webhook fires to Clawdbot
2. Mason agent receives task
3. Mason implements or responds
4. Result posted back to Linear issue as comment

Agent Routing

• - @mason → Code implementation, debugging, technical tasks
• @eureka → Planning, strategy, research, communication
• Other mentions → Ignored (not handled)

Issue Context Provided

The agent receives:

• - Issue title
• Issue description
• Issue labels
• Comment text (the @mention)
• Issue URL
• Commenter name

Customization

Add More Agents

Edit linear-transform.js:

CODEBLOCK4

Change Response Behavior

Modify deliver and channel in config:

CODEBLOCK5

This will also send agent responses to Telegram.

Security

• - Never commit hook token to version control
• Use environment variables: INLINECODE11
• Verify webhook source (Linear's IP ranges if needed)
• Use HTTPS only (Cloudflare Tunnel provides this)

Troubleshooting

Webhook not firing

• - Check Linear webhook logs (Settings → API → Webhooks → View logs)
• Verify tunnel is running: INLINECODE12
• Check Clawdbot logs: INLINECODE13

Agent not responding

• - Check transform is loading: Look for errors in gateway logs
• Verify agent session exists: INLINECODE14
• Test transform manually: INLINECODE15

Response not posting to Linear

• - Implement Linear API comment posting in transform
• Add Linear API token to config
• See linear-transform.js for example

Linear API Access

To post comments back to Linear, you need a Linear API token:

1. 1. Go to Linear Settings → API → Personal API keys
2. Create new token with write scope
3. Add to environment: INLINECODE18
4. Transform will use this to post responses

Files

• - SKILL.md - This documentation
• INLINECODE20 - Webhook payload parser and agent router
• INLINECODE21 - Linear GraphQL API client (for posting comments)
• INLINECODE22 - Sample Linear webhook payload for testing

References

• - Clawdbot Webhook Docs
• Linear Webhooks API
• Cloudflare Tunnel