DocsChannelsDiscord

Discord

Run Ryvos as a Discord bot. Send messages in DMs, receive rich embed responses, and approve tool calls with buttons.

Setup

1. Create a Bot

  1. Go to the Discord Developer Portal
  2. Create a new application
  3. Go to Bot tab, create a bot
  4. Copy the bot token
  5. Enable Message Content Intent under Privileged Gateway Intents
  6. Invite the bot to your server with appropriate permissions

2. Get Your User ID

Enable Developer Mode in Discord settings, then right-click your username and copy your user ID.

3. Configure Ryvos

[channels.discord]
bot_token = "${DISCORD_BOT_TOKEN}"
dm_policy = "allowlist"
allowed_users = [123456789012345678]  # Your Discord user ID (u64)

4. Start

export DISCORD_BOT_TOKEN="your-token"
ryvos daemon

DM Policy

PolicyBehavior
allowlistOnly users in allowed_users can interact
openAnyone can DM the bot
disabledDiscord adapter doesn't start

Rich Embeds

Ryvos formats responses as Discord embeds with:

  • Code blocks with syntax highlighting
  • Tool call results in collapsed sections
  • Approval requests as button components

Approval Flow

Approval requests appear as embeds with interactive buttons:

⚠ Approval Required
Tool: bash
Tier: T3
Input: git push origin main

[Approve] [Deny]

Click the button to respond.

TelegramSlack