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.
Create a dedicated Linear user for your agent
- Create or invite a separate user in your Linear workspace for the agent.
- Add it only to teams and projects it should access.
- Avoid using your personal owner account token for day-to-day automation.
Generate a Linear API key
- Sign in as that agent user, then open Settings → API → Personal API keys.
- Create a new key and give it a clear name (for example, "OpenClaw agent").
- 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.
Add the Linear key to your agent
- Add the token to your agent's integrations/secrets (for example as
LINEAR_API_KEY). - Save and restart the integration if your setup requires a reload.
- Tell your agent to connect to Linear and verify workspace access.
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.