Connect your agent to Linear

Connecting Linear lets your agent read issues, create tasks, and help triage work without manual copy/paste. The safest setup is to use a dedicated Linear account for your agent and grant only the access it needs.

Tip: Start read-only if you're unsure. After you confirm issue lookups work, add write access for creating and updating tasks.

1

Create a dedicated Linear user for your agent

  1. Create or invite a separate user in your Linear workspace for the agent.
  2. Add it only to teams and projects it should access.
  3. Avoid using your personal owner account token for day-to-day automation.
2

Generate a Linear API key

  1. Sign in as that agent user, then open Settings → API → Personal API keys.
  2. Create a new key and give it a clear name (for example, "OpenClaw agent").
  3. Copy the key once and store it in your password manager.

Treat this key like a password. If it leaks, revoke it immediately and create a replacement.

3

Add the Linear key to your agent

  1. Add the token to your agent's integrations/secrets (for example as LINEAR_API_KEY).
  2. Save and restart the integration if your setup requires a reload.
  3. Tell your agent to connect to Linear and verify workspace access.
4

Test with safe prompts first

  • "Show my open issues assigned to me in Linear."
  • "Summarize blockers in the Platform team this week."
  • "Draft a new bug issue from this error log, but ask before submitting."

Next: connect your agent to GitHub, or review safe setup best practices.

Sign up

Welcome to ClawNode

Pick a plan: OpenClaw (bring your own API key) or a Node (Ollama + open-source LLM preinstalled).

or

By selecting Agree and continue, I agree to ClawNode's Terms of Service and Privacy Policy.

or

Already have an account? Log in