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