openclaw.plugin.json

{
  "id": "linear-agent-bridge",
  "name": "Linear",
  "description": "Linear agent webhook bridge for OpenClaw dev runs",
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "devAgentId": {
        "type": "string",
        "description": "Agent ID to handle Linear issues (default: 'dev')"
      },
      "linearWebhookSecret": {
        "type": "string",
        "description": "Linear webhook signing secret for signature verification"
      },
      "linearApiKey": {
        "type": "string",
        "description": "Linear OAuth token for posting activities and updating issues"
      },
      "linearOauthClientId": {
        "type": "string",
        "description": "Linear OAuth client ID for code exchange/refresh"
      },
      "linearOauthClientSecret": {
        "type": "string",
        "description": "Linear OAuth client secret for code exchange/refresh"
      },
      "linearOauthRedirectUri": {
        "type": "string",
        "description": "Redirect URI configured in Linear app settings"
      },
      "linearTokenStorePath": {
        "type": "string",
        "description": "Workspace-local path for persisted Linear OAuth tokens"
      },
      "notifyChannel": {
        "type": "string",
        "description": "Optional channel to deliver agent responses (e.g., 'discord')"
      },
      "notifyTo": {
        "type": "string",
        "description": "Optional target for notifications (e.g., 'channel:123456')"
      },
      "notifyAccountId": {
        "type": "string",
        "description": "Optional account ID for notifications"
      },
      "repoByTeam": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "Map Linear team keys to repository directories"
      },
      "repoByProject": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        },
        "description": "Map Linear project keys to repository directories"
      },
      "defaultDir": {
        "type": "string",
        "description": "Default repository directory when no team/project mapping matches"
      },
      "delegateOnCreate": {
        "type": "boolean",
        "description": "Auto-delegate issues to the app user on session create (default: true)"
      },
      "startOnCreate": {
        "type": "boolean",
        "description": "Move issues to 'started' state on session create (default: true)"
      },
      "externalUrlBase": {
        "type": "string",
        "description": "Base URL for external session links (supports {session} and {issue} placeholders)"
      },
      "externalUrlLabel": {
        "type": "string",
        "description": "Label for external session links (default: 'OpenClaw session')"
      },
      "enableAgentApi": {
        "type": "boolean",
        "description": "Enable agent-callable API proxy endpoints (default: true)"
      },
      "apiBaseUrl": {
        "type": "string",
        "description": "Override auto-detected base URL for agent API calls"
      },
      "strictAddressing": {
        "type": "boolean",
        "description": "Process only explicitly addressed events (mentions/delegation/thread replies)"
      },
      "mentionHandle": {
        "type": "string",
        "description": "App mention handle used for strict addressing (e.g. personal-openclaw)"
      },
      "apiCorsOrigins": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Allowed origins for CORS on /plugins/linear/api (use [\"*\"] to allow any origin)"
      },
      "apiCorsAllowCredentials": {
        "type": "boolean",
        "description": "Set Access-Control-Allow-Credentials on /plugins/linear/api responses"
      }
    }
  },
  "uiHints": {
    "linearWebhookSecret": {
      "label": "Webhook secret",
      "sensitive": true
    },
    "linearApiKey": {
      "label": "API key / OAuth token",
      "sensitive": true
    },
    "linearOauthClientId": {
      "label": "OAuth client ID",
      "sensitive": true
    },
    "linearOauthClientSecret": {
      "label": "OAuth client secret",
      "sensitive": true
    },
    "linearOauthRedirectUri": {
      "label": "OAuth redirect URI"
    },
    "linearTokenStorePath": {
      "label": "OAuth token store path",
      "placeholder": "/home/ubuntu/.openclaw/workspace/.pi/linear-oauth.json"
    },
    "delegateOnCreate": {
      "label": "Auto delegate"
    },
    "startOnCreate": {
      "label": "Move to started"
    },
    "externalUrlBase": {
      "label": "External session URL",
      "placeholder": "https://your-gateway/sessions/{session}"
    },
    "externalUrlLabel": {
      "label": "External URL label",
      "placeholder": "OpenClaw session"
    },
    "enableAgentApi": {
      "label": "Enable agent API"
    },
    "apiBaseUrl": {
      "label": "API base URL override",
      "placeholder": "https://your-hostname.ts.net"
    },
    "strictAddressing": {
      "label": "Strict addressing mode"
    },
    "mentionHandle": {
      "label": "Mention handle",
      "placeholder": "personal-openclaw"
    },
    "apiCorsOrigins": {
      "label": "API CORS origins",
      "placeholder": "https://linear.app"
    },
    "apiCorsAllowCredentials": {
      "label": "API CORS allow credentials"
    }
  }
}