Common Issues

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