Troubleshooting 🔧

Scope

This page is a placeholder generated from the official source file structure.

What to verify

• TODO: Add prerequisites and validation checklist.

Outline (from official headings)

• Status & Diagnostics
• Common Issues
• No API key found for provider “anthropic”
• OAuth token refresh failed (Anthropic Claude subscription)
• Control UI fails on HTTP (“device identity required” / “connect failed”)
• CI Secrets Scan Failed
• Service Installed but Nothing is Running
• “Gateway start blocked: set gateway.mode=local”
• Service Environment (PATH + runtime)
• Skill missing API key in sandbox
• Service Running but Port Not Listening
• Address Already in Use (Port 18789)
• Extra Workspace Folders Detected
• Main chat running in a sandbox workspace
• “Agent was aborted”
• “Agent failed before reply: Unknown model: anthropic/claude-haiku-3-5”
• Messages Not Triggering
• Pairing Code Not Arriving
• Image + Mention Not Working
• Session Not Resuming

Further reading

• Official source file: gateway/troubleshooting.md