Linear for Openclaw

Integrate Linear project management into your agentic workflow to automate issue tracking, notification handling, and team synchronization.

stepandel
v0.7.1
Mar 5, 2026
0
125
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install linear-plugin

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install linear-plugin 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?

The Linear skill for Openclaw Skills provides a powerful interface for AI agents to interact directly with the Linear GraphQL API. It allows agents to manage the entire lifecycle of project tasks, from triaging incoming notifications in a prioritized queue to creating, updating, and resolving complex issue trees. By bridging the gap between development work and project management, this skill enables autonomous agents to maintain organized backlogs and respond to team mentions in real-time.

This integration is designed for high-velocity teams who need their AI agents to not only write code but also participate actively in the project management lifecycle. It handles authentication, data formatting, and error handling, allowing the agent to focus on completing work and updating stakeholders through a structured, predictable workflow.

Linear Use Cases

  • Automated triaging and resolution of high-priority Linear notifications and mentions.
  • Dynamic creation and assignment of sub-issues to break down complex development tasks.
  • Real-time synchronization of code progress with Linear issue status and workflow states.
  • Managing complex project dependencies by adding and deleting issue relations like blocks or duplicates.

How Linear Works

  1. The agent uses the peek action to view all pending items in the notification inbox.
  2. High-priority items are popped from the queue, which automatically marks them as in-progress to prevent duplicate work.
  3. The agent fetches detailed context by viewing the specific issue and listing all related comments.
  4. After performing the necessary technical work, the agent updates the issue state and adds relevant comments.
  5. Finally, the agent completes the queue item to remove it from the inbox and proceed to the next task.

Linear Setup

To enable this skill, ensure your environment is configured with the necessary Linear API credentials. Update your configuration file to include the extension settings for Openclaw Skills:

# Ensure the following configuration key is present in your environment
# extensions.openclaw-linear

The skill requires a valid Linear API key or OAuth token to communicate with the GraphQL endpoint and manage your team resources.

Linear Data Schema & Taxonomy

The skill organizes data around the Linear notification queue and issue metadata. Key data structures include:

Object Key Properties
Queue Item id, issueId, event (ticket/mention), priority, status, addedAt
Issue title, description, assignee, state, priority, labels, project, dueDate
Comment issueId, body, parentCommentId (for threading)
Relation issueId, type (blocks, related, etc.), relatedIssueId

Priority is handled numerically where 0 represents a mention (highest priority) and 1-5 maps to Linear's internal priority levels.

Linear Advanced Features

  • Priority-first processing where mentions are automatically moved to the front of the queue.
  • Support for threaded comments to maintain organized discussions within issue histories.
  • Advanced issue relation management to handle blockers and duplicate tickets programmatically.
  • Detailed team and member lookup capabilities to ensure tasks are assigned to the correct personnel.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*