From b76e76e70cb953a54d5d460edb62396509218068 Mon Sep 17 00:00:00 2001 From: Yanko Atanasov Aleksandrov Date: Thu, 9 Jul 2026 19:56:36 +0300 Subject: [PATCH 1/2] docs: clarify managed ClawBox messaging channels --- docs-site/guides/messaging-channels.mdx | 48 ++++++++++++++----------- docs-site/hardware/clawbox-connect.mdx | 2 +- docs-site/hardware/requirements.mdx | 2 +- docs-site/index.mdx | 4 +-- docs-site/quickstart.mdx | 4 +-- docs-site/setup/first-boot.mdx | 3 +- docs-site/setup/openclaw-setup.mdx | 5 +++ docs-site/support/faq.mdx | 5 +-- 8 files changed, 42 insertions(+), 31 deletions(-) diff --git a/docs-site/guides/messaging-channels.mdx b/docs-site/guides/messaging-channels.mdx index 9b7982b3..22302497 100644 --- a/docs-site/guides/messaging-channels.mdx +++ b/docs-site/guides/messaging-channels.mdx @@ -1,53 +1,59 @@ --- title: "Messaging Channels" icon: "comments" -summary: "Connect Telegram, WhatsApp, Discord, and other chat apps to your ClawBox." +summary: "Connect Telegram, use web chat, and understand which OpenClaw channels are managed by ClawBox versus advanced extensions." --- ClawBox runs OpenClaw, which connects to your favorite chat apps so you can message -your assistant from anywhere. One device serves multiple channels at once. +your assistant from anywhere. The managed ClawBox setup path currently focuses on +Telegram plus the on-device web chat. Other OpenClaw channels may be possible, but +they are advanced configuration unless they appear in your device UI. ## Supported channels - + - - - - -...and more, including Google Chat, Microsoft Teams, Matrix, and iMessage. +Telegram is the first-class ClawBox channel: setup, bot-token validation, pairing +approvals, and progress streaming are handled by the ClawBox UI. Web chat is built +into the ClawBox interface. + +Advanced users can add other OpenClaw-supported channels manually if their installed +OpenClaw version and plugins support them. Treat WhatsApp, Discord, Slack, Signal, +Matrix, Microsoft Teams, Google Chat, and iMessage as extension paths, not guaranteed +guided setup flows. ## Linking a channel -From the ClawBox settings page: +For Telegram, from the ClawBox settings page: - - Go to the **Channels** section in your ClawBox web interface. + + Go to **Settings → Telegram** in your ClawBox web interface. - - Choose the app you want to link (e.g. Telegram). + + Open Telegram, search **@BotFather**, create a bot, and copy the bot token. - - Follow the on-screen pairing flow — usually scanning a QR code or pasting a bot token. + + Paste the token into ClawBox and wait for the gateway restart to finish. - - Send a message from that app. Your ClawBox replies. + + New Telegram users send the bot a message and then approve the pairing request + on the ClawBox screen. -You can link several channels to the same ClawBox. Messages from each surface route to -the same assistant. +Use the web chat when you are on the same ClawBox interface and Telegram when you +want phone-based access. ## Group chats -ClawBox can participate in group chats. It's built to know when to chime in and when to -stay quiet, so it acts like a helpful participant rather than a noisy bot. +Telegram group behavior depends on your bot privacy settings and the OpenClaw channel +configuration. Start with one-to-one pairing first, then test group behavior deliberately. ## Troubleshooting diff --git a/docs-site/hardware/clawbox-connect.mdx b/docs-site/hardware/clawbox-connect.mdx index f33156bc..7ce66d87 100644 --- a/docs-site/hardware/clawbox-connect.mdx +++ b/docs-site/hardware/clawbox-connect.mdx @@ -27,7 +27,7 @@ The entry-tier ClawBox: a compact, low-power, always-on AI assistant for your de ## What it's good for -- A **24/7 personal assistant** you message from Telegram, WhatsApp, Discord, or the web. +- A **24/7 personal assistant** you message from Telegram or the web, with additional OpenClaw channels available for advanced setups when supported. - **Browser automation** and everyday agent tasks. - Running with **cloud AI providers** (ClawBox AI, Claude, GPT, Gemini) or smaller local models. diff --git a/docs-site/hardware/requirements.mdx b/docs-site/hardware/requirements.mdx index aaef6bd1..3ca2881c 100644 --- a/docs-site/hardware/requirements.mdx +++ b/docs-site/hardware/requirements.mdx @@ -36,7 +36,7 @@ This page covers what you actually need — from bare minimum to running local A ### Minimum — messaging only - **Specs:** 1 vCPU, 1 GB RAM, 10 GB storage, 1 Mbps+ -- **Can do:** Telegram/WhatsApp messaging, simple text commands, basic API integrations, scheduled messages +- **Can do:** Telegram and web messaging, simple text commands, basic API integrations, scheduled messages, and additional OpenClaw channels when configured - **Can't do:** browser automation, local AI models, multiple concurrent tasks, image processing - **Examples:** $5/mo VPS · Raspberry Pi 4 (2 GB) · old laptop diff --git a/docs-site/index.mdx b/docs-site/index.mdx index aea6c347..8df4a5f5 100644 --- a/docs-site/index.mdx +++ b/docs-site/index.mdx @@ -6,7 +6,7 @@ summary: "ClawBox is pre-configured AI hardware that runs OpenClaw — your own

Your own AI assistant, running 24/7 on hardware you own.
- ClawBox ships pre-configured with OpenClaw — message it from Telegram, WhatsApp, Discord, or the web, and it gets things done. + ClawBox ships pre-configured with OpenClaw — message it from Telegram or the web, and extend it with additional OpenClaw channels when your setup supports them.

@@ -38,7 +38,7 @@ A small, always-on computer running **OpenClaw** — a self-hosted gateway that **What makes it different?** - **Owned hardware** — it lives on your desk, drawing as little as 7–15 W. -- **Multi-channel** — Telegram, WhatsApp, Discord, web, and more from one device. +- **Multi-channel foundation** — Telegram and web are the managed ClawBox paths; advanced users can add more OpenClaw channels where supported. - **Flexible AI** — ClawBox AI out of the box, or connect Claude / GPT / Gemini / OpenRouter / local Ollama. - **Pre-configured** — no Linux setup, no Docker wrangling. Plug in and go. diff --git a/docs-site/quickstart.mdx b/docs-site/quickstart.mdx index 9e2dfeb9..ba3dbcc8 100644 --- a/docs-site/quickstart.mdx +++ b/docs-site/quickstart.mdx @@ -23,7 +23,7 @@ Get from a sealed box to a working AI assistant in a few minutes. follow [Choose Your AI Provider](/setup/choose-ai-provider). - Connect Telegram, WhatsApp, or Discord and message your ClawBox. + Connect Telegram and message your ClawBox. You can also use the web chat from the ClawBox interface. See [Messaging Channels](/guides/messaging-channels). @@ -36,7 +36,7 @@ Get from a sealed box to a working AI assistant in a few minutes. - Add Telegram, WhatsApp, Discord, and more. + Connect Telegram, use web chat, and understand advanced channel options. Can't reach the box? Start here. diff --git a/docs-site/setup/first-boot.mdx b/docs-site/setup/first-boot.mdx index 53bdd547..695b6a1b 100644 --- a/docs-site/setup/first-boot.mdx +++ b/docs-site/setup/first-boot.mdx @@ -36,8 +36,7 @@ Wi-Fi or Ethernet connection. Open your phone camera or a QR scanner and scan the QR code on the quick-start card. - Choose your messaging platform (Telegram recommended) and follow the pairing wizard - to link your account. + Connect Telegram when prompted, then follow the pairing wizard to link your account. Send your first message to test the connection. Try a question or a command, then diff --git a/docs-site/setup/openclaw-setup.mdx b/docs-site/setup/openclaw-setup.mdx index 5910c03c..e11153e7 100644 --- a/docs-site/setup/openclaw-setup.mdx +++ b/docs-site/setup/openclaw-setup.mdx @@ -34,6 +34,11 @@ options — whether you're on a ClawBox or a DIY install. ## Discord + +ClawBox's guided setup manages Telegram. Configure Discord only if your installed +OpenClaw version and channel plugins support it. + + Go to the **Discord Developer Portal** and create a new application. diff --git a/docs-site/support/faq.mdx b/docs-site/support/faq.mdx index 28ea4432..2fa85002 100644 --- a/docs-site/support/faq.mdx +++ b/docs-site/support/faq.mdx @@ -23,8 +23,9 @@ summary: "Frequently asked questions about ClawBox hardware, software, and subsc [Workstation page](/hardware/clawbox-workstation). - Telegram, WhatsApp, Discord, Slack, Signal, Web Chat, and more. See - [Messaging Channels](/guides/messaging-channels). + Telegram and the on-device web chat are the managed ClawBox paths today. + Advanced users can add other OpenClaw channels manually when their installed + OpenClaw version and plugins support them. See [Messaging Channels](/guides/messaging-channels). ClawBox Connect draws ~7–15 W (about €39/year in electricity). ClawBox Workstation From 25cb9f262c672dc999c16391a03d2f0e733d9f14 Mon Sep 17 00:00:00 2001 From: Yanko Atanasov Aleksandrov Date: Thu, 9 Jul 2026 20:12:45 +0300 Subject: [PATCH 2/2] docs: point Telegram setup to guided ClawBox flow --- docs-site/setup/openclaw-setup.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs-site/setup/openclaw-setup.mdx b/docs-site/setup/openclaw-setup.mdx index e11153e7..5702b0c2 100644 --- a/docs-site/setup/openclaw-setup.mdx +++ b/docs-site/setup/openclaw-setup.mdx @@ -17,6 +17,12 @@ options — whether you're on a ClawBox or a DIY install. ## Telegram + +For ClawBox's guided setup, use **Settings → Telegram** and see +[Messaging Channels](/guides/messaging-channels). Use the manual steps below for +self-hosted OpenClaw setups or fallback configuration. + + Open Telegram and search **@BotFather**.