Skip to main content
This guide walks through creating a managed Hermes agent on OpenComputer, connecting it to Telegram, and chatting with it. By the end you’ll have a personal AI agent running Claude via OpenRouter, reachable from your phone.

​
Prerequisites

​
Install the CLI

Install the oc binary from the CLI installation guide.

​
Step 1: Create the agent

This creates the agent, provisions its environment, configures the LLM provider, and starts the Hermes gateway. Check that the agent is running:
Wait for the status to show running before proceeding. Provisioning typically takes 20–30 seconds.

​
Step 2: Create a Telegram bot

Open this link to BotFather in Telegram (or search for @BotFather in the app). Then:
  1. Tap Start if it’s your first time
  2. Send /newbot
  3. Enter a display name when prompted (e.g. “My Hermes Agent”)
  4. Enter a username — must end in bot (e.g. my_hermes_test_bot)
  5. BotFather replies with a token like 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw — copy it

​
Step 3: Connect Telegram

The CLI will prompt you to paste the bot token. Alternatively, use the API directly:
This registers a webhook with Telegram, configures Hermes for webhook mode, and restarts the gateway. Verify it worked:

​
Step 4: Chat with your agent

Open Telegram, find your bot by its username, and send a message. The agent responds using Claude (via OpenRouter) with the full Hermes personality — memory, tool use, and multi-turn conversation. If the bot suggests setting a home channel (/sethome), do it — this is where Hermes delivers cron job results and cross-platform messages.

​
Shell access

You can shell into the agent’s sandbox at any time:
This opens an interactive terminal inside the agent’s environment. You have full access — inspect logs, edit Hermes config, install tools, change the model, add skills. Anything you can do with Hermes locally, you can do here. See the Hermes docs for what’s possible.

​
Cleanup

Disconnect the channel and delete the agent:
Disconnecting deregisters the Telegram webhook and removes the channel config from Hermes. Deleting the agent tears down the sandbox.

​
What’s next

  • Install gbrain for persistent memory: oc agent install my-hermes gbrain
  • Connect Slack instead of Telegram (planned)
  • Create an OpenClaw Agent — same journey, different core: multi-channel gateway with plugin SDK and hot-reload config
  • Custom cores — bring your own agent runtime with oc shell and the raw sandbox API
  • Hermes docs — see the full Hermes documentation for skills, cron jobs, voice, browser tools, and more