Connection Issues and Network Errors

Common Connection Errors

• "Connection timeout"
• "Failed to connect to API"
• "Network error"
• "Service unavailable"
• "502 Bad Gateway"

AI Provider Connection Issues

Symptoms

• Bot receives messages but doesn't respond
• Logs show timeout or connection errors
• Intermittent responses

Solutions

1. Check AI provider status page:
   • OpenAI Status
   • Anthropic Status
2. Verify API key is valid and has credits
3. Check for rate limiting in provider dashboard
4. Try restarting your instance
5. If issue persists, contact provider support

Messaging Platform Connection Issues

Telegram

• Verify bot token is valid (check with @BotFather)
• Ensure Telegram API is not blocked in your region
• Check instance logs for Telegram connection status
• Try regenerating bot token

Discord

• Verify bot token in Discord Developer Portal
• Ensure Message Content Intent is enabled
• Check bot has proper permissions in server
• Verify bot is still in the server (not kicked)

Rate Limiting

If seeing "429 Too Many Requests":

• Too many API calls in short time
• OpenClaw implements automatic retry with backoff
• Check provider dashboard for rate limits
• Consider upgrading provider tier for higher limits
• Reduce message volume if possible

DNS and Network Issues

If logs show DNS resolution failures:

• Usually temporary, resolves automatically
• Restart instance after a few minutes
• Contact support if persists > 30 minutes

Timeout Settings

If experiencing frequent timeouts:

• May indicate slow AI responses
• Try faster model (e.g., GPT-3.5 instead of GPT-4)
• Reduce MAX_TOKENS to limit response length
• Check AI provider latency in their dashboard

Checking Logs

To diagnose connection issues:

1. Go to instance Logs tab
2. Look for ERROR entries with "connect", "timeout", or "network"
3. Note the timestamp and service affected
4. Check if error is recurring or one-time

When to Contact Support

Contact support@agentclaw.app if:

• Connection issues persist > 1 hour
• Multiple instances affected
• Provider status pages show no issues
• Error messages reference AgentClaw infrastructure

Next Steps

• Learn about troubleshooting startup failures
• Read about API key errors
• See how to read and interpret logs