Channels & integrations

Your agent isn't locked in the dashboard. Pair it with Telegram or WhatsApp, connect your Google account, or give it its own phone number and email.

Chat in the dashboard

Every agent has a full chat and control surface built in. Open the agent and click OpenClaw Dashboard (or use the Console tab). Sessions, files, cron jobs, and usage live alongside the conversation.

Live recording: asking the agent to draft a welcome email; the reply streams in as it writes.

Where integrations live

Open your agent → Integrations tab. Pairing needs the agent running. Start it first if it's asleep (config saved while sleeping is applied on the next wake).

The Integrations tab showing Telegram, WhatsApp, and Gmail connection cards — The Integrations tab: Telegram one-tap pairing, WhatsApp phone pairing, and Google connect.

Fastest path: use Maritime's shared bot. Click the one-tap connect link, tap START in Telegram, and the card flips to Connected within a few seconds.
Your own bot: create one with @BotFather (/newbot), paste the token, and Connect. Your bot, your branding.
DM policy controls who can talk to it: pairing via approval code (default), allowlist, open, or disabled.

Connect your own bot via the API

Everything the dashboard card does is one API call. Every agent lives in a project (its projectId is on the agent object); pointing a bot at the project makes it the agent's Telegram front door. Maritime validates the token with Telegram, registers the webhook, and routes each chat to the right agent. Needs an API key with the secrets scope; the token is stored encrypted.

# 1. Find your agent's project id
curl -s https://api.maritime.sh/api/agents/<agent-id> \
  -H "Authorization: Bearer $MARITIME_API_KEY" | jq -r .projectId

# 2. Point your @BotFather bot at it
curl -X POST https://api.maritime.sh/api/projects/<project-id>/channels/telegram \
  -H "Authorization: Bearer $MARITIME_API_KEY" -H "Content-Type: application/json" \
  -d '{"botToken": "123456:ABC-your-botfather-token"}'

# Disconnect (also removes the Telegram-side webhook):
curl -X DELETE https://api.maritime.sh/api/projects/<project-id>/channels/telegram \
  -H "Authorization: Bearer $MARITIME_API_KEY"

With the project's newChatPolicy set to spawn, each Telegram user who DMs the bot gets their own agent instance, same policy engine as the HTTP front door.

Connect WhatsApp pairs your phone to the agent (QR / phone pairing, like WhatsApp Web). Available for OpenClaw-family agents while they're running. Once paired, the badge on the card shows the connection and your agent answers your WhatsApp messages.

Google Workspace

Connect Google runs a standard OAuth consent and lets the agent use Gmail, Drive, Calendar, Docs, and Sheets on your behalf: read and send email, check your calendar, edit documents. Tokens are stored encrypted with the agent's environment; disconnect anytime from the same card.

Other channels

Discord, Slack, Signal, and Microsoft Teams can be wired through the agent's gateway configuration (bot token + DM policy, same model as Telegram). The per-channel setup guides live in the upstream OpenClaw docs. Cron schedules, webhooks, and email triggers (which wake a sleeping agent rather than chat with it) are covered in Configuration → Triggers.