Troubleshooting
Having trouble? Find solutions to common issues below.
Start here: run openacp doctor
The built-in diagnostic command checks your configuration, bot tokens, agent commands, and platform connectivity automatically. It catches the majority of setup issues in seconds:
openacp doctor
Each check reports a pass, warning, or failure with a specific message — fix the reported issues first before diving into the guides below.
Guides by topic
- Telegram issues — bot not responding, missing rights, topics, rate limits
- Discord issues — slash commands, intents, thread creation, interactions
- Slack issues — Socket Mode, token types, interactivity, channel creation
- Agent issues — command not found, crashes, timeouts, dependency errors
- FAQ — supported platforms, multiple users, costs, privacy, offline support