Ryvos

Run Ryvos as a Telegram bot. Send messages, receive responses, and approve tool calls — all from your phone.

Setup

1. Create a Bot

Message @BotFather on Telegram:

/newbot

Follow the prompts. You'll receive a bot token like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

2. Get Your User ID

Message @userinfobot to get your numeric Telegram user ID.

3. Configure Ryvos

[channels.telegram]
bot_token = "${TELEGRAM_BOT_TOKEN}"
allowed_users = [123456789]         # Your user ID
dm_policy = "allowlist"             # Only allowed users can interact

4. Start in Daemon Mode

export TELEGRAM_BOT_TOKEN="123456:ABC-DEF..."
ryvos daemon

Ryvos connects to Telegram and starts listening for messages.

DM Policy

Policy	Behavior
`allowlist`	Only users in `allowed_users` can interact
`open`	Anyone can message the bot
`disabled`	Telegram adapter doesn't start

Always use allowlist unless you have a specific reason not to. An open bot lets anyone run commands on your machine.

Approval Flow

When a tool needs approval, Ryvos sends a message with inline buttons:

⚠ Approval Required
Tool: bash (T3)
Command: cargo test

[✓ Approve]  [✕ Deny]

Tap to approve or deny. The 60-second timeout applies.

Message Threading

Each conversation is tracked by session ID. Ryvos maintains separate context per user.

Running with Web UI

ryvos daemon --gateway

This starts Telegram + the Web UI simultaneously on the same process.