{

"id": "openclaw-linear",

"name": "Linear",

"description": "Linear project management integration for OpenClaw",

"skills": ["./skills"],

"configSchema": {

"type": "object",

"additionalProperties": false,

"properties": {

"apiKey": {

"type": "string",

"sensitive": true,

"description": "Linear API key for authentication (create at linear.app/settings/account/security)"

},

"webhookSecret": {

"type": "string",

"sensitive": true,

"description": "Webhook signing secret for HMAC verification"

},

"teamIds": {

"type": "array",

"items": { "type": "string" },

"description": "Linear team keys to listen for (e.g. [\"ENG\", \"OPS\"]). Empty = all teams."

},

"eventFilter": {

"type": "array",

"items": { "type": "string" },

"description": "Event types to handle (e.g. [\"Issue\", \"Comment\"]). Empty = all types."

},

"agentMapping": {

"type": "object",

"additionalProperties": { "type": "string" },

"description": "Map Linear user IDs to OpenClaw agent IDs for routing (e.g. {\"linear-user-uuid\": \"agent-name\"})"

},

"debounceMs": {

"type": "integer",

"description": "Debounce window in milliseconds for batching webhook events before dispatch (default: 30000)"

},

"stateActions": {

"type": "object",

"additionalProperties": { "type": "string", "enum": ["add", "remove", "ignore"] },

"description": "Map Linear state types or names to queue actions. Keys can be state types (triage, backlog, unstarted, started, completed, canceled) or state names (e.g. \"In Review\", \"Todo\"). Name matches take precedence over type matches (case-insensitive). Actions: add (re-add to queue), remove (remove from queue), ignore (do nothing). Defaults: backlog/unstarted=add, completed/canceled=remove, others=ignore."

}

},

"required": ["webhookSecret", "apiKey"]

}

}