Troubleshooting

Common issues and solutions.

"No API key configured"

Cause: Your OpenRouter API key is missing or invalid.

Fix:

1. Go to Dashboard → Settings
2. Enter your OpenRouter API key
3. Click Validate to confirm it works
4. Click Save

Get a key at openrouter.ai/keys.

"Daily limit reached"

Cause: You've exhausted your plan's daily AI request quota.

Fix:

• Wait until the limit resets (midnight UTC)
• Switch to a free model (Gemini Flash, Llama 3.3) which doesn't count against limits
• Upgrade your plan for higher limits

"Tool call failed"

Cause: The tool API key is missing or the external service is down.

Fix:

1. Go to Dashboard → Settings → Tool API Keys
2. Add the required key (Tavily for search, Firecrawl for browsing, etc.)
3. Retry the mission or editor action

Mission stuck in "running"

Cause: A step may have timed out or hit a rate limit.

Fix:

• Check the step details for error messages
• The heartbeat system automatically retries failed steps (up to 3 times)
• If stuck for more than 10 minutes, try creating a new mission

Agent produces low-quality output

Fix:

1. Rate it 👎 — This triggers automatic correction rules
2. Be more specific — Add details to your mission description
3. Try a better model — Switch the agent to Claude Sonnet or GPT-4o in Dashboard → Agents
4. Check the Team page — See if the agent's trend is declining

Editor AI not responding

Fix:

1. Check your API key in Settings
2. Check your daily request limit in the editor status bar
3. Try a different model from the model selector
4. Check browser console for network errors

GitHub push failing

Fix:

1. Validate your GitHub token in Settings → GitHub Integration
2. Ensure the token has `repo` scope
3. Check that the repository exists and you have write access
4. Verify the repository name format: `owner/repo`