#openclaw onboard telegram
1 messages ยท Page 1 of 1 (latest)
Yep โ first thing: please paste openclaw --version and donโt paste your Telegram token publicly.
Quick checklist:
openclaw --version
openclaw status
openclaw channels status --probe
openclaw logs --follow
For Telegram, you donโt use openclaw channels login telegram. You create a bot in @BotFather, then configure the token:
{
channels: {
telegram: {
enabled: true,
botToken: "123:abc",
dmPolicy: "pairing",
groups: { "*": { requireMention: true } }
}
}
}
Then restart/start the gateway and approve your DM:
openclaw gateway restart
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
Common failures:
/startworks but no reply โ pairing not approvedgetMe returned 401โ wrong/revoked BotFather token- group silent โ mention the bot, disable BotFather privacy mode, or make it admin
- group IDs go under
channels.telegram.groups; user IDs go underallowFrom/groupAllowFrom
why its taking so long for processing whenever i enter any command
even simplest command like openclaw --version
If openclaw --version is slow in your server/PC terminal, thatโs not a Telegram issue โ it means the CLI install/runtime is slow or stuck.
First check whether youโre accidentally running through npx/pnpm dlx every time:
type -a openclaw
command -v openclaw
time openclaw --version
node -v
If type -a openclaw shows an alias/function using npx, thatโs likely the delay. Install globally instead:
npm install -g openclaw@latest
If you mean youโre sending openclaw --version inside Telegram chat, that goes through the AI/model/tool loop, so it wonโt be instant. Run version checks in the terminal.
Please paste the output of the 4 commands above, plus what OS/VPS youโre using. Donโt paste bot tokens. ๐ฆ
it says -a cpommand not found
and i have run npm command
what next??
The command is:
type -a openclaw
all on one line โ donโt run -a by itself.
Next, open a new terminal and run:
node -v
openclaw --version
command -v openclaw
If openclaw --version works, continue Telegram setup:
openclaw gateway restart
openclaw status
openclaw pairing list telegram
If openclaw is still โcommand not foundโ, your global install bin folder is probably not in PATH. Paste the output of:
node -v
pnpm -v
command -v node
command -v pnpm
command -v openclaw
Also tell us your OS: Windows / WSL / macOS / Linux VPS.
โNo pending telegram pairing reqโ usually means OpenClaw hasnโt received a new DM from your Telegram bot yet.
Do this in order:
- In Telegram, open your bot directly and send:
/start
or any message like hi.
- Immediately run:
openclaw logs --follow
- In another terminal run:
openclaw channels status --probe
openclaw pairing list telegram
If pairing still shows nothing:
- you may be messaging the wrong bot
- the BotFather token in config may be wrong
- Telegram channel may not be enabled
- gateway may not be running
- another process may be using the same bot token
Please paste the output of these, with tokens redacted:
openclaw --version
openclaw status
openclaw channels status --probe
Also: pairing is for DMs only. If youโre testing in a Telegram group, first get DMs working, then configure group access.
Ah, on Windows that explains the type -a issue โ that was a Linux/macOS shell command.
If youโre in PowerShell, use these instead:
Get-Command openclaw
node -v
npm -v
openclaw --version
Windows support works, but WSL2 is the recommended/stabler path for OpenClaw. Native Windows can work for CLI/Gateway, but setup is still rougher.
If openclaw --version works, run:
openclaw gateway status
openclaw channels status --probe
openclaw logs --follow
Then DM your Telegram bot /start, and check:
openclaw pairing list telegram
Docs: https://docs.openclaw.ai/platforms/windows and https://docs.openclaw.ai/channels/telegram
PS C:\Users\ADMIN> openclaw logs --follow
Config warnings:
- plugins: plugin: ignored plugins.load.paths entry that points at OpenClaw's current bundled plugin directory; remove this redundant path or run openclaw doctor --fix
๐ฆ OpenClaw 2026.4.26 (be8c246) โ Making 'I'll automate that later' happen now.
โ
โ Config warnings โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ - plugins: plugin: ignored plugins.load.paths entry that points at OpenClaw's current โ
โ bundled plugin directory; remove this redundant path or run openclaw doctor --fix โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Config warnings:
- plugins: plugin: ignored plugins.load.paths entry that points at OpenClaw's current bundled plugin directory; remove this redundant path or run openclaw doctor --fix
Gateway not reachable. Is it running and accessible?
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: C:\Users\ADMIN.openclaw\openclaw.json
Bind: loopback
Hint: runopenclaw doctor.
PS C:\Users\ADMIN>
what now ???
The important line is:
Gateway not reachable. Is it running?
So Telegram pairing wonโt appear yet because the Gateway isnโt running.
In PowerShell, run:
openclaw doctor --fix
openclaw gateway run
Keep that terminal open. If the gateway starts, open a second PowerShell and run:
openclaw gateway status
openclaw channels status --probe
openclaw pairing list telegram
Then DM your Telegram bot /start.
If openclaw gateway run exits or shows an error, paste that error here. The plugin warning is probably not the main blocker; the Gateway being down is. ๐ฆ
roubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting
PS C:\Users\ADMIN> openclaw channel status --probe
error: unknown command 'channel'
(Did you mean channels?)
Yep, tiny typo โ itโs plural:
openclaw channels status --probe
But first make sure the gateway is actually running. Use this sequence:
Terminal 1:
openclaw gateway run
Leave it open.
Terminal 2:
openclaw gateway status
openclaw channels status --probe
openclaw pairing list telegram
Then message your Telegram bot /start.
If Terminal 1 shows an error, paste that error โ thatโs the real blocker.
[assistant turn failed before producing content]
why its not replying on openclaw dashboard
If OpenClaw Dashboard/WebChat isnโt replying, that usually means the issue is gateway/model/session, not Telegram yet.
Please paste these first:
openclaw --version
openclaw status --all
openclaw gateway status
Then watch logs while sending one test message in the dashboard:
openclaw logs --follow
If Telegram is the thing youโre setting up, quick checklist:
{
channels: {
telegram: {
enabled: true,
botToken: "YOUR_BOTFATHER_TOKEN",
dmPolicy: "pairing",
},
},
}
Then restart/start gateway and approve your first DM:
openclaw gateway restart
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
Important: Telegram does not use openclaw channels login telegram; it needs a BotFather token in config/env.
Docs: https://docs.openclaw.ai/channels/telegram and https://docs.openclaw.ai/help/faq
WSL2 is good โ thatโs the recommended Windows path.
Run these inside WSL/Ubuntu, not PowerShell, and paste the output:
openclaw --version
openclaw status --all
openclaw gateway status
openclaw models status
For the Dashboard specifically: send /status in the dashboard/WebChat.
- If
/statusreplies but normal messages donโt โ likely model/auth issue. - If
/statusalso doesnโt reply โ likely dashboard โ gateway auth/connection issue.
Then keep logs open and send one dashboard message:
openclaw logs --follow
For Telegram after that, make sure your config has the BotFather token โ Telegram does not use a login command:
channels: {
telegram: {
enabled: true,
botToken: "YOUR_BOTFATHER_TOKEN",
dmPolicy: "pairing",
},
}
Docs: https://docs.openclaw.ai/platforms/windows and https://docs.openclaw.ai/channels/telegram
@jovial leaf bro please help me i am setting up openclaw for 3 days
Got it โ then Telegram setup may be fine; letโs isolate Dashboard/WebChat.
Inside WSL run:
openclaw dashboard
Open the URL it prints. If the UI says disconnected/unauthorized, go to:
Control โ Overview โ Gateway Access
Paste the Gateway Token or Password there, then click Connect.
Then in Dashboard/WebChat try:
/status
If /status works but normal messages donโt, check model auth:
openclaw models status
If /status doesnโt work, keep logs open and send one dashboard message:
openclaw logs --follow
Paste the first error you see there. Docs: https://docs.openclaw.ai/web/dashboard https://docs.openclaw.ai/gateway/troubleshooting
Oof, 3 days is rough โ letโs make this smaller. Donโt change Telegram stuff for now if itโs already connected.
Please run this inside WSL/Ubuntu and paste the output here โ donโt paste your bot token/API keys:
openclaw --version
openclaw status --all
openclaw gateway status
openclaw models status
Then run this:
openclaw dashboard
Open the URL it prints, send /status in the dashboard, and tell us:
- Does
/statusreply in Dashboard? - Does Telegram reply if you DM the bot?
- What error appears in:
openclaw logs --follow
The key split is:
- Telegram replies but Dashboard doesnโt โ Dashboard/Gateway token or browser connection issue.
/statusreplies but normal messages donโt โ model/auth issue.- Nothing replies anywhere โ Gateway/session issue.
Docs for reference: https://docs.openclaw.ai/gateway/troubleshooting
@jovial leaf I have installed openclaw
set auth provider to gemini
set search provider to gemini
setup telegram channel
downloaded skills using homebrew
and now when i am trying to run openclaw dashboard its not replyin on the chatbox in browser of openclaw
That helps. Telegram being connected means the channel side is probably okay โ now we debug Dashboard/WebChat + Gemini model auth.
Important: search provider = Gemini only affects web search, not whether the assistant can answer normal chat. Normal replies need the chat model/auth working.
Please run this inside WSL/Ubuntu and paste the output, with keys/tokens redacted:
openclaw --version
openclaw status --all
openclaw gateway status
openclaw models status --probe
Then:
openclaw dashboard
Open the URL it prints, send exactly:
/status
If /status replies but โhelloโ doesnโt, itโs almost certainly Gemini/model auth. If /status also doesnโt reply, itโs Dashboard โ Gateway auth/connection.
Also run logs while sending one dashboard message:
openclaw logs --follow
Paste the first error line after the message. Thatโll tell us where itโs failing. Docs: https://docs.openclaw.ai/gateway/troubleshooting
13:19:56 Embedded agent failed before reply: โ ๏ธ Google Generative AI API error (429): You exceeded your current quota, please check your plan and billing details. For more information on this error, head to: https://ai.google.dev/gemini-api/docs/rate-limits. To monitor your current usage, head to: https:โฆ [code=RESOURCE_EXHAUSTED]
Yep โ that log is the root cause.
OpenClaw is reaching Gemini, but Gemini is rejecting the request:
429 RESOURCE_EXHAUSTED = quota/rate limit exhausted
So Dashboard isnโt replying because the agent fails before it can produce a reply.
Fix options:
- Wait for Gemini quota/rate limit reset.
- Enable/upgrade billing/quota on the Google/Gemini API project.
- Switch OpenClaw to another working model/provider:
openclaw models status
openclaw models list
openclaw models set <model-from-list>
openclaw gateway restart
Then test again in Dashboard with:
hello
Also: Gemini as search provider doesnโt fix chat replies โ your main chat model quota is whatโs failing here.
Docs: https://docs.openclaw.ai/cli/models https://docs.openclaw.ai/concepts/model-providers
does ollama reuqiores api key?? for setting up it for auth provider and search provider
Short answer: local Ollama does not need a real API key.
But there are two separate things:
1) Ollama as model/chat provider
- Local/LAN Ollama: no real key needed; OpenClaw can use the local marker/placeholder.
- Ollama Cloud /
https://ollama.com: needsOLLAMA_API_KEY.
For local Ollama, first make sure OpenClaw can reach it from WSL:
curl http://127.0.0.1:11434/api/tags
If that fails, Ollama is not reachable from WSL yet.
2) Ollama as search provider
- Local/self-hosted Ollama Web Search: no separate search API key, but you need:
ollama signin
- Direct hosted Ollama search via
https://ollama.com: needsOLLAMA_API_KEY.
Setup path Iโd use:
openclaw configure --section model
openclaw configure --section web
openclaw gateway restart
Then test: