Common Issues

Solutions to frequently encountered problems.

Deployment Issues

Agent Won't Deploy

Problem: Deployment fails with error

Solution:

# Check logs
swiftclaw logs my-agent --tail 100

# Verify configuration
swiftclaw dev --check

# Try redeploying
swiftclaw deploy my-agent --force

Slow Response Times

Problem: Agent responses are slow

Solution:

• Check model selection (use faster models for simple tasks)
• Optimize memory queries
• Enable caching
• Review tool execution times

Authentication Issues

API Key Not Working

Problem: Authentication fails

Solution:

# Verify API key
swiftclaw whoami

# Regenerate key if needed
swiftclaw config set api-key <new-key>

Memory Issues

Memory Not Persisting

Problem: Agent forgets context

Solution:

{
  "memory": {
    "type": "persistent",
    "scope": "per-user"
  }
}

Performance Issues

High Costs

Problem: Unexpected high costs

Solution:

• Use cheaper models for simple tasks
• Implement caching
• Set rate limits
• Monitor usage in dashboard

Next Steps

• Debugging Guide
• Performance Tuning
• Get Support