Skip to Content
REDCELLDocs

Discord and Telegram

Chat with RedCell from Discord or Telegram, with the same tools, sessions, and approvals as the CLI.

A gateway connects a Discord or Telegram bot to RedCell running on your machine. You send tasks from chat; RedCell runs them locally and replies, including approval requests you can answer with a button.

Only the user IDs you allowlist can use the bot. The gateway won't start without at least one.

Set up Discord

Create the bot

  1. In the Discord Developer Portal, create an application and add a bot.
  2. Under Bot → Privileged Gateway Intents, turn on Message Content Intent.
  3. Copy the bot token and the application ID.
  4. Turn on Developer Mode in Discord, then right-click your name and copy your user ID.

Connect it to RedCell

redcell gateway setup discord --application-id YOUR_APPLICATION_ID --allowed-users YOUR_USER_ID --cwd /absolute/path/to/workspace

Replace the values. --cwd is the folder RedCell works in. RedCell asks for the bot token without showing it, checks it with Discord, and prints an invite link.

Invite the bot

Open the invite link and add the bot to your server.

Run it

redcell gateway discord

Mention the bot in a channel to start. It creates a thread; follow-ups in the thread don't need a mention. DMs never need one.

Run it at login

To start the Discord gateway automatically when you log in:

redcell gateway service install

Check it with redcell gateway service status. Remove it with redcell gateway service uninstall. No admin rights needed.

Chat commands

CommandWhat it does
/newStart a new conversation
/stopStop the current task
/statusShow session status
/modelShow or change the model for this chat
/approve / /denyAnswer an approval request (or use the buttons)
/sessions, /resume IDList and resume conversations
/helpList all commands

Discord also supports /review, /diff, /permissions, /usage, /mcp, /skills, /plugins, and more. Settings you change in chat apply only to that chat.

Settings and security

  • Allow several users with comma-separated IDs: --allowed-users 111,222.
  • By default, the bot only answers in group channels when mentioned. Use --require-mention false to change that.
  • Settings are saved in ~/.redcell/messaging/. Don't share or commit those files; they contain your bot token.
  • You can use environment variables instead: DISCORD_BOT_TOKEN and DISCORD_ALLOWED_USERS, or TELEGRAM_BOT_TOKEN and TELEGRAM_ALLOWED_USERS.

Troubleshooting

ProblemFix
Bot is offlineRun the gateway command in the foreground and check the token. On Discord, check Message Content Intent
Bot ignores youMake sure your numeric user ID is allowlisted, and mention the bot in group channels
Discord slash commands missingThey can take a few minutes to appear. Check the bot was invited with applications.commands
Telegram 409 ConflictAnother process is using the same bot token. Stop it