Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Comment @mason or @eureka in Linear issues to dispatch tasks to agents. Webhook receives Linear comments and routes to correct agent.
Comment @mason or @eureka in Linear issues to dispatch tasks to agents. Webhook receives Linear comments and routes to correct agent.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Enables Linear issue comment @mentions to dispatch tasks to Clawdbot agents.
Comment in Linear: @mason implement user authentication or @eureka plan Q2 roadmap Linear webhook fires on comment creation Clawdbot receives webhook via exposed endpoint Transform parses payload: Extracts @mason or @eureka mention Gets issue context (title, description, labels) Prepares task prompt Routes to agent session: @mason โ mason agent (code/implementation) @eureka โ eureka agent (planning/strategy) Agent processes task and returns result Result posted back as Linear comment
Add to your config.json5: { hooks: { enabled: true, token: "your-secret-token-here", // Generate with: openssl rand -base64 32 path: "/hooks", transformsDir: "/home/sven/clawd-mason/skills/linear-webhook", mappings: [ { name: "linear", match: { path: "/linear", method: "POST" }, action: "agent", transform: { module: "./linear-transform.js", export: "transformLinearWebhook" }, deliver: false, // Don't auto-deliver to chat - Linear comments handle responses } ] } }
Use Cloudflare Tunnel or Tailscale Funnel to make webhook publicly accessible: Option A: Cloudflare Tunnel (Recommended) # Install if needed brew install cloudflared # Start tunnel (replace with your domain) cloudflared tunnel --url http://localhost:18789 Option B: Tailscale Funnel # Enable funnel tailscale funnel 18789 Note the public URL (e.g., https://your-tunnel.trycloudflare.com)
Go to Linear Settings โ API โ Webhooks Click "Create new webhook" Set URL: https://your-tunnel.trycloudflare.com/hooks/linear Add custom header: x-clawdbot-token: your-secret-token-here Select events: Comment โ Created Save webhook
Comment in a Linear issue: @mason add user authentication to the login page Expected flow: Webhook fires to Clawdbot Mason agent receives task Mason implements or responds Result posted back to Linear issue as comment
@mason โ Code implementation, debugging, technical tasks @eureka โ Planning, strategy, research, communication Other mentions โ Ignored (not handled)
The agent receives: Issue title Issue description Issue labels Comment text (the @mention) Issue URL Commenter name
Edit linear-transform.js: const AGENT_MENTIONS = { '@mason': 'mason', '@eureka': 'eureka', '@designer': 'designer', // Add your own agents };
Modify deliver and channel in config: { deliver: true, channel: "telegram", to: "1878354815", // Your Telegram chat ID } This will also send agent responses to Telegram.
Never commit hook token to version control Use environment variables: CLAWDBOT_HOOK_TOKEN Verify webhook source (Linear's IP ranges if needed) Use HTTPS only (Cloudflare Tunnel provides this)
Check Linear webhook logs (Settings โ API โ Webhooks โ View logs) Verify tunnel is running: curl https://your-tunnel.trycloudflare.com/hooks/linear Check Clawdbot logs: clawdbot gateway logs
Check transform is loading: Look for errors in gateway logs Verify agent session exists: clawdbot sessions list Test transform manually: node linear-transform.js
Implement Linear API comment posting in transform Add Linear API token to config See linear-transform.js for example
To post comments back to Linear, you need a Linear API token: Go to Linear Settings โ API โ Personal API keys Create new token with write scope Add to environment: CLAWDBOT_LINEAR_API_KEY=lin_api_... Transform will use this to post responses
SKILL.md - This documentation linear-transform.js - Webhook payload parser and agent router linear-api.js - Linear GraphQL API client (for posting comments) example-payload.json - Sample Linear webhook payload for testing
Clawdbot Webhook Docs Linear Webhooks API Cloudflare Tunnel
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.