The Linear Webhook Skill enables users to trigger specialized AI agents by simply @mentioning them within Linear issue comments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install linear-webhook
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install linear-webhook using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Linear Webhook Skill?
The Linear Webhook Skill is a specialized integration designed to bridge the gap between project management and autonomous execution. By leveraging this tool among your Openclaw Skills, you can turn your Linear issue tracker into a command center for AI agents. When a user mentions a specific agent in a comment, the skill captures the context of the issue and routes the task to the appropriate agent session.
This skill is particularly valuable for teams using Clawdbot agents like mason for technical implementation or eureka for high-level strategy. It ensures that your project metadata, labels, and descriptions are seamlessly passed to the AI, allowing for highly contextualized and accurate task processing without leaving the Linear interface.
Linear Webhook Skill Use Cases
- Triggering code implementation tasks by mentioning @mason in a Linear issue.
- Requesting strategic planning or roadmap summaries from @eureka within a project ticket.
- Automating the transition from a bug report to an agent-led investigation using Openclaw Skills.
- Streamlining communication between project managers and AI-driven development agents.
How Linear Webhook Skill Works
- A user posts a comment in a Linear issue containing a mention like @mason or @eureka.
- Linear triggers a webhook event that is sent to the configured Clawdbot endpoint.
- The skill parses the incoming payload to extract the specific mention and the full context of the Linear issue.
- The system routes the task to the designated agent session based on the mention.
- The agent processes the request using the issue title, description, and labels as input.
- The resulting output or status update is posted back to the Linear issue as a new comment.
Linear Webhook Skill Setup
1. Update Config
Add the webhook configuration to your config.json5 file:
{
hooks: {
enabled: true,
token: "your-secret-token",
path: "/hooks",
transformsDir: "./skills/linear-webhook",
mappings: [
{
name: "linear",
match: { path: "/linear", method: "POST" },
action: "agent",
transform: { module: "./linear-transform.js", export: "transformLinearWebhook" }
}
]
}
}
2. Expose the Endpoint
Use Cloudflare Tunnel to make your local instance reachable by Openclaw Skills via the web:
cloudflared tunnel --url http://localhost:18789
3. Configure Linear
In Linear Settings > API > Webhooks, create a new webhook pointing to your tunnel URL (e.g., https://your-tunnel.com/hooks/linear) and select the Comment Created event.
Linear Webhook Skill Data Schema & Taxonomy
The skill organizes and processes data using a structured transformation layer:
| Field | Description |
|---|---|
issue_context |
Contains the title, description, and labels of the ticket. |
agent_mention |
Identifies the target agent (e.g., mason, eureka). |
payload_metadata |
Includes the commenter's name and the direct URL to the issue. |
api_token |
Securely stored environment variable for posting replies back to Linear. |
Linear Webhook Skill Advanced Features
- Custom Agent Mapping: Easily add new agents by updating the mapping object in the transformation script.
- Multi-Agent Routing: Direct tasks to different specialized agents based on the specific @mention used.
- Cross-Platform Delivery: Optionally configure the skill to send agent responses to other channels like Telegram simultaneously.
- Secure Webhook Verification: Protects your Openclaw Skills environment using secret tokens and HTTPS-only communication.
SKILL.md
Loading
Related Openclaw Skills
jq JSON Processor
A lightweight and flexible command-line tool for processing, filtering, and transforming JSON data.
Git Essentials
A comprehensive guide and toolset for mastering essential Git commands and professional version control workflows.
fzf-fuzzy-finder
A blazingly fast, interactive command-line fuzzy finder that filters lists from any source for seamless terminal navigation.
fd-find: Fast and Intuitive File Search
A high-performance command-line tool designed as a user-friendly and faster alternative to the classic find utility.
ripgrep
A blazingly fast recursive search tool that respects .gitignore rules to find regex patterns across complex directories.
SSH Essentials
A comprehensive toolkit for mastering Secure Shell operations, from basic remote access to advanced port forwarding and security hardening.
Featured*
