Telegram

The Telegram channel connects your agent to a Telegram bot. Messages flow through the OpenComputer gateway to your agent’s sandbox, and the agent replies directly to Telegram.

Connect

oc agent connect my-agent telegram --bot-token <token>

curl -X POST https://api.opencomputer.dev/v1/agents/my-agent/channels/telegram \
  -H "X-API-Key: $OC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bot_token": "<token>"}'

If you omit --bot-token, the CLI prompts for it interactively.

What happens

The bot token is stored in the agent’s secret store
A webhook is registered with Telegram pointing to https://<gateway>/gw/agents/<id>/telegram
The core config is updated for webhook mode
The gateway is restarted (Hermes) or hot-reloaded (OpenClaw)

Prerequisites

Create a Telegram bot first:

Open Telegram and message @BotFather
Send /newbot, choose a name and username
Copy the bot token

Disconnect

oc agent disconnect my-agent telegram

curl -X DELETE https://api.opencomputer.dev/v1/agents/my-agent/channels/telegram \
  -H "X-API-Key: $OC_API_KEY"

Disconnecting removes the webhook registration and config entry. The bot token is removed from the secret store.

List channels

oc agent channels my-agent

curl https://api.opencomputer.dev/v1/agents/my-agent/channels \
  -H "X-API-Key: $OC_API_KEY"

How it works

Telegram → webhook POST → OpenComputer gateway → agent sandbox → reply → Telegram

The gateway receives Telegram updates at /gw/agents/:agentId/telegram and enqueues them for the agent. The agent processes the message through its core runtime and sends a response back via the Telegram Bot API. Channels are stateless from the platform’s perspective — disconnecting removes the webhook and config. Nothing to clean up inside the sandbox.

Getting Started

Sandboxes

Reserved Capacity

Agent SDK

Hosted Agents

CLI

Guides

TypeScript SDK

Python SDK

CLI Reference

API Reference

Resources

Connect

What happens

Prerequisites

Disconnect

List channels

How it works

​Connect

​What happens

​Prerequisites

​Disconnect

​List channels

​How it works

Connect

What happens

Prerequisites

Disconnect

List channels

How it works