AgentDock Docs

OpenClaw Bot Quickstart (Telegram First)

Follow this production path to create an OpenClaw bot, connect Telegram, and verify live replies.

Before You Start

  • - An active AgentDock workspace (bot creation is blocked if billing/trial is inactive).
  • - A Telegram bot token from BotFather (format: 123456:ABC...).
  • - At least one healthy worker node connected to the control plane.
1

Log in and open Bots

Sign in to your workspace, then go to /app/bots from the left navigation.
2

Create an OpenClaw bot

In Create bot, choose the OpenClaw template, pick a version, enter a bot name, and click Create. AgentDock redirects you to /app/bots/:id/setup.
3

Set model + provider

In Model + provider, choose provider/model, add provider API key, then click Save model settings and Apply model settings.
4

Configure Telegram (first channel)

In the Telegram card, paste Telegram bot token, click Save, then Apply, then Verify. Status should move toward CONNECTED and APPLIED.
5

Approve pairing requests

If a Telegram pairing code appears, approve it in Pairing requests (or use Manual pairing fallback with code from chat).
6

Run final verification

Use Run verify checks, then send a real Telegram message to confirm first reply from your bot.

Troubleshooting

tenant_not_active / Workspace not active

Go to Billing and start trial or activate subscription before creating bots.

worker_unreachable / worker_timeout

Check worker health, network reachability, and worker token/base URL configuration.

telegram_apply_failed / missing_telegram_bot_token

Re-save token in Telegram card, then run Apply and Verify again.

openclaw_bootstrap_not_supported

Use Open OpenClaw UI for advanced setup or upgrade template/runtime version.

Quick Links