linear-webhook

What This Skill Does

The linear-webhook skill transforms your Linear issue tracker into a powerful, agent-driven workflow engine. By enabling this skill, your OpenClaw agents become active participants in your development lifecycle. It listens for specific @mentions within Linear issue comments, routes the request to the designated agent, and posts the agent's output back to the thread. This eliminates context switching between your IDE, issue tracker, and terminal, allowing you to trigger technical implementation or strategic planning directly where the work is defined.

Installation

1. Install the module via Clawhub: clawhub install openclaw/skills/skills/arnarsson/linear-webhook.
2. Open your config.json5 file and add the hooks configuration block. Ensure the token matches your generated security key and point the transformsDir to the downloaded skill directory.
3. Expose your local OpenClaw server to the web using a secure tool like Cloudflare Tunnel or Tailscale Funnel.
4. Navigate to your Linear team's API settings, create a new Webhook, and paste your public tunnel URL (e.g., https://your-tunnel.trycloudflare.com/hooks/linear).
5. Set the headers to include your secret token, select the 'Comment Created' event, and save. Your agents are now live and listening.

Use Cases

• Technical Implementation: Assign coding tasks to the @mason agent directly from a bug ticket.
• Roadmap Planning: Tag @eureka on high-level epics to generate project timelines or strategic research.
• Feedback Loops: Automate documentation updates by having agents comment back their progress or finished code snippets directly onto the ticket.

Example Prompts

• "@mason implement the JWT authentication middleware for the user login flow, referring to the requirements in the issue description."
• "@eureka provide a phased Q3 roadmap based on the current backlog of performance optimization tasks."
• "@mason refactor the database query in the attached snippet to improve execution speed by 30%."

Tips & Limitations

• Security: Always use a strong base64-encoded secret token to verify webhook integrity; never expose your endpoint without authentication.
• Routing: You can map additional agents by modifying the AGENT_MENTIONS constant within the linear-transform.js file.
• Rate Limiting: Be aware of Linear's API rate limits; excessive automated comments may trigger restrictions. Monitor your agent's activity to avoid spamming team members.