Platform

Channels Configuration

Config keys and Settings for Telegram, Slack, Discord, Signal, and Viber in Agent OS.

Overview

Channel credentials and default agents are stored in ~/.agent-os/config.json (or under AGENT_OS_HOME). You can edit the file or use the dashboard Settings → Channels to set them. Each channel has a webhook endpoint; in production the server must be reachable over HTTPS.

Config keys (config.json)

KeyDescription
telegram_bot_tokenTelegram bot token (from BotFather).
telegram_default_agent_idAgent id used for Telegram chats when not overridden.
slack_bot_tokenSlack bot token (xoxb-...).
slack_signing_secretSlack signing secret (verify Events API / slash requests).
slack_default_agent_idAgent id for Slack messages.
discord_bot_tokenDiscord bot token.
discord_public_keyDiscord application public key (hex) for verifying interactions.
discord_default_agent_idAgent id for Discord.
signal_bridge_urlSignal bridge base URL (e.g. http://localhost:8080).
signal_default_agent_idAgent id for Signal.
viber_auth_tokenViber bot auth token.
viber_default_agent_idAgent id for Viber.

Dashboard

In Settings → Channels, each channel (Telegram, Slack, Discord, Signal, Viber) has:

  • Configure — Enter token and default agent; optional signing secret (Slack) or public key (Discord).
  • Status — Shows whether the channel is configured and, where applicable, webhook status.
  • Set webhook — For Telegram and Viber, you can set the webhook URL (must be HTTPS in production).

Webhook URLs

  • Telegram: https://your-domain.com/api/channels/telegram/webhook
  • Slack: https://your-domain.com/api/channels/slack/webhook
  • Discord: https://your-domain.com/api/channels/discord/webhook
  • Signal: https://your-domain.com/api/channels/signal/webhook (bridge posts here)
  • Viber: https://your-domain.com/api/channels/viber/webhook

Register these URLs in each platform’s app settings. For step-by-step setup see the repo docs: doc/TELEGRAM_SETUP.md, doc/SLACK_SETUP.md, doc/DISCORD_SETUP.md, doc/SIGNAL_SETUP.md, doc/VIBER_SETUP.md.