#error
1 messages ยท Page 1 of 1 (latest)
Let me pull the actual docs paths first so I don't make up install steps.
Yeah, letโs make this boring and predictable.
Use one install path only. Donโt mix npm, git, Docker, Bun, etc. for the first try.
Recommended install
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
What should happen
- Installer runs
- Onboarding asks for your model provider/API key
- Gateway starts
- Dashboard opens
- You send a test message
If the normal installer keeps failing
Use the local-prefix installer instead, it avoids a lot of global npm / permission pain:
curl -fsSL https://openclaw.ai/install-cli.sh | bash -s -- --onboard
If openclaw says โcommand not foundโ
Run:
node -v
npm prefix -g
echo "$PATH"
If needed, add this to ~/.bashrc or ~/.zshrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Then open a new terminal.
Important notes
- Node 24 is recommended, Node 22.14+ also works
- On Windows, WSL2 is usually more stable
- If you build from source, use pnpm, not Bun
If it still breaks
Paste these 4 things here and Iโll walk through the exact failure:
openclaw --version
node --version
openclaw status --all
openclaw gateway status
And also tell me:
- your OS
- the exact install command you ran
- the full error text
Docs:
showing "[*] Installing OpenClaw (openclaw@latest)..." for a long time
Iโm checking what that installer step actually does, so I can tell you whether itโs normal or stuck.
That line is the npm global install step. It should usually finish in 2 to 5 minutes. If itโs been sitting there for 10+ minutes with no new output, Iโd treat it as stuck.
Do this next:
macOS / Linux / WSL2
Stop it with Ctrl+C, then rerun with verbose output:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard --verbose
Windows PowerShell
If youโre on native Windows, tell me, the debug command is different. Also, WSL2 is usually the smoother path for OpenClaw.
Then paste these:
node --version
npm --version
openclaw --version
If openclaw says not found, thatโs okay, just paste that too.
And most important, paste the last 30 to 50 lines from the verbose installer output after it hangs.
If you want, I can walk you through it live once you send:
- your OS
- those 3 version outputs
- the last chunk of verbose output
Docs:
openclaw installed now how to make it work
If anything fails, paste these here:
openclaw --version
openclaw status --all
openclaw gateway status
Docs:
Nice, youโre past the hard part ๐
Now do this:
openclaw onboard --install-daemon
That setup wizard will:
- ask you to choose a model provider
- ask for your API key
- set up the gateway/service
Then verify itโs running:
openclaw gateway status
Then open the dashboard:
openclaw dashboard
If that doesnโt open automatically, go to:
http://127.0.0.1:18789/
Then send a test message in the chat UI.
it says:
o QuickStart -------------------------+
| |
| Gateway port: 18789 |
| Gateway bind: Loopback (127.0.0.1) |
| Gateway auth: Token (default) |
| Tailscale exposure: Off |
| Direct to chat channels. |
| |
+--------------------------------------+
|
- Model/auth provider
| > Anthropic (Claude CLI + API key)
| Arcee AI
| BytePlus
| Chutes
| Cloudflare AI Gateway
| Copilot Proxy
| Custom Provider
| DeepSeek
| Fireworks
| Gemini CLI OAuth
| GitHub Copilot
| Google
| Hugging Face
| Kilo Gateway
| LiteLLM
| LM Studio
| Microsoft Foundry
| MiniMax
| Mistral AI
| Moonshot AI (Kimi K2.5)
| Ollama
| OpenAI
| OpenAI Codex
| OpenCode
| ...
what now ic ant type anything
Iโm checking the wizard controls so I donโt tell you the wrong keys.
Yep, that screen is a menu, not a text box.
Do this:
- Click into the terminal window
- Use โ / โ arrow keys to move
- Press Enter to choose
For Model/auth provider, pick the one you actually have access to:
- OpenAI if you have an OpenAI API key
- Anthropic if you have an Anthropic key / Claude setup
- Google if you want Google auth
- etc.
After you pick one, the wizard should move to the next step and start asking for details.
Easiest path
If you already have an API key, pick that provider, then:
- paste the API key when asked
- keep the default gateway settings
- finish onboarding
- then run:
openclaw dashboard
If the keys donโt work
Try:
- Enter
- arrow keys
- if still nothing, press Ctrl+C and rerun
openclaw onboardin a normal terminal app
If you want, tell me which provider you have and Iโll tell you exactly which option to pick next.
how to open openclaw again
To open OpenClaw again:
openclaw dashboard
If the gateway isnโt running yet, start it first:
openclaw gateway start
openclaw dashboard
You can also open it directly in your browser:
http://127.0.0.1:18789/
Useful checks:
openclaw gateway status
If you want to go back into setup again:
openclaw onboard
i need to change my ai
Got you. To change your AI, do this:
Change the default AI
Open terminal and run:
openclaw configure --section model
Then:
- use arrow keys
- pick the new AI/provider
- press Enter
- save/finish
After that, reopen OpenClaw:
openclaw dashboard
If you only want to change it in the current chat
Type this in the chat:
/model
If you want, tell me which AI you want to switch to and Iโll give you the exact next click.
it opens a dashboard but the link is invald. it says "This site canโt be reached"
That usually means one of two things:
- the gateway isnโt running, or
- youโre opening the link on a different device even though your gateway is bound to 127.0.0.1.
Your setup showed:
- Gateway bind: Loopback (127.0.0.1)
That means the dashboard only works on the same computer where OpenClaw is running.
Try this on that same computer
openclaw --version
openclaw gateway status
openclaw gateway start
openclaw dashboard
Then manually open:
http://127.0.0.1:18789/
If you are using another device
127.0.0.1 will not work there. It only points to that device itself.
If it still fails
Paste the output of:
openclaw --version
openclaw gateway status
openclaw status --all
and tell me:
- are you opening it on the same PC or a different phone/laptop
- what exact link it tried to open
Docs:
same PC and the link is: http://127.0.0.1:18789/
Perfect, that helps.
If http://127.0.0.1:18789/ says site canโt be reached, that usually means the gateway is not running.
Run these exactly:
openclaw gateway status
openclaw gateway start
openclaw gateway status
Then refresh:
http://127.0.0.1:18789/
If it still doesnโt open, run:
openclaw status --all
and paste the output here.
So, next thing I need from you is the result of:
openclaw gateway status
why it takes soo long to respond
Iโm checking the docs for the main causes of slow replies so I can give you the shortest useful checklist.
Usually itโs one of these:
- the model/provider is slow
- youโre using a local model like Ollama/LM Studio
- the gateway is unhealthy / reconnecting
- the agent is using tools, which adds extra time
If youโre on a local model, thatโs the big one. Local setups are often much slower unless you have pretty serious hardware.
Check these first
openclaw --version
openclaw status
openclaw models status
If you want the fastest fix
- switch to a cloud provider instead of a local model
- change to a faster provider/model in:
openclaw configure --section model
If it feels broken, not just slow
Run:
openclaw logs --follow
and send:
openclaw statusopenclaw models status
If you paste those two outputs, I can usually tell pretty fast whatโs slowing it down.
after the model select
Ah, got it, after you select the model.
That part can be slower because OpenClaw is:
- switching to the new provider/model
- checking auth
- starting the first request with that model
So the first reply after a model change is often slower than normal.
Normal vs not normal
- a few seconds to ~30s: can be normal
- every reply takes forever: somethingโs off
Big clue
If you picked a local model like Ollama or LM Studio, slow replies are pretty normal on weaker hardware.
Check this
openclaw status
openclaw models status
And tell me which provider you selected.
If you paste those, I can tell you whether itโs normal slow or broken slow.
โ Default model
โ Keep current (openai/gpt-5.4)
Error: Cannot find module 'axios'
Require stack:
- C:\Users\Somegh\AppData\Roaming\npm\node_modules\openclaw\node_modules@larksuiteoapi\node-sdk\lib\index.js
PS C:\Users\Somegh> .\Downloads
.\Downloads\ : The term '.\Downloads' is not recognized as the name of a cmdlet, function, script file, or operable
program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
- .\Downloads\
-
+ CategoryInfo : ObjectNotFound: (.\Downloads\:String) [], CommandNotFoundException + FullyQualifiedErrorId : CommandNotFoundException
PS C:\Users\Somegh>
Iโm checking whether that axios error is a known install packaging issue or just a broken global install, so I can give you the safest fix.
I found the package does depend on axios, so this smells like a broken/incomplete global install on Windows, not user error. Iโm checking the published package metadata next.
That one looks like a broken package/install, not something you did.
openclaw is trying to load @larksuiteoapi/node-sdk, and that package wants axios, but axios is missing.
Try this first in PowerShell
openclaw --version
npm i -g axios@1.15.0
openclaw onboard
If it still breaks
Do a clean reinstall:
npm uninstall -g openclaw
npm install -g openclaw@latest
npm i -g axios@1.15.0
openclaw onboard
Small note
This part:
.\Downloads\
isnโt a valid command by itself. If you wanted to go there, use:
cd .\Downloads
If you run the 3 commands above, paste the output if it still fails.
Honestly, this smells like a packaging bug on Windows. If it keeps happening after that, please file a GitHub issue here:
https://github.com/openclaw/openclaw/issues
Docs:
How can I make this AI that will help me to setup server and setup discord bot in their dashboard, and Iso need to make it so that this bot can chat through Discord DMs
Iโm grabbing the Discord setup docs so I can give you the shortest path without making up config steps.
Yep, you can do that.
Short version: create a Discord bot in the Discord Developer Portal, connect it to OpenClaw, then approve DM pairing.
1) Create the Discord bot
In the Discord Developer Portal:
- New Application
- go to Bot
- enable:
- Message Content Intent
- Server Members Intent (recommended)
- copy the Bot Token
- go to OAuth2
- enable:
botapplications.commands
- give it permissions:
- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
- invite it to your own server
2) Copy your IDs
In Discord, turn on Developer Mode, then copy:
- your Server ID
- your User ID
3) Connect the bot to OpenClaw
On the PC running OpenClaw, in PowerShell:
$env:DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json
openclaw gateway restart
Do not paste your bot token in Discord chat.
4) Enable DMs
In Discord:
- right-click your server
- Privacy Settings
- turn on Direct Messages
5) Pair Discord DMs
Now DM your bot in Discord.
It should send you a pairing code.
Approve it on your PC:
openclaw pairing list discord
openclaw pairing approve discord YOUR_CODE
After that, the bot can chat with you in Discord DMs.
If you also want it to reply inside your server channels, I can give you the next step for the guild allowlist too.
Docs:
openclaw : The term 'openclaw' is not recognized as the name of a cmdlet, function, script file, or operable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
- openclaw config set channels.discord.token --ref-provider default --r ...
-
+ CategoryInfo : ObjectNotFound: (openclaw:String) [], CommandNotFoundException + FullyQualifiedErrorId : CommandNotFoundException
That means PowerShell canโt find the OpenClaw command on your PATH.
Check where npm installed it
Run these:
node --version
npm --version
npm config get prefix
Get-ChildItem "$(npm config get prefix)\openclaw*"
If you see openclaw.cmd
Try running it directly:
& "$(npm config get prefix)\openclaw.cmd" --version
If that works, the fix is:
- add the folder from
npm config get prefixto your User PATH - close PowerShell
- open a new PowerShell window
- run:
openclaw --version
On Windows, that folder is usually:
%AppData%\npm
If you do not see openclaw.cmd
Reinstall it:
npm install -g openclaw@latest
Then run:
& "$(npm config get prefix)\openclaw.cmd" --version
If you want, paste the output of these two:
npm config get prefix
Get-ChildItem "$(npm config get prefix)\openclaw*"
Docs:
PS C:\Users\Somegh> node --version
v24.13.0
PS C:\Users\Somegh> npm --version
11.10.0
PS C:\Users\Somegh> npm config get prefix
C:\Users\Somegh\AppData\Roaming\npm
PS C:\Users\Somegh> Get-ChildItem "$(npm config get prefix)\openclaw*"
PS C:\Users\Somegh> & "$(npm config get prefix)\openclaw.cmd" --version
& : The term 'C:\Users\Somegh\AppData\Roaming\npm\openclaw.cmd' is not recognized as the name of a cmdlet, function,
script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is
correct and try again.
At line:1 char:3
- & "$(npm config get prefix)\openclaw.cmd" --version
-
+ CategoryInfo : ObjectNotFound: (C:\Users\Somegh...pm\openclaw.cmd:String) [], CommandNotFoundException + FullyQualifiedErrorId : CommandNotFoundException
Nice, that tells us a lot.
Your Node/npm setup is fine.
The real issue is simpler: OpenClaw is not actually installed right now.
Get-ChildItem "$(npm config get prefix)\openclaw*" returned nothing, so there is no openclaw.cmd yet.
Install it now
Run:
npm install -g openclaw@latest
Then check:
Get-ChildItem "$(npm config get prefix)\openclaw*"
& "$(npm config get prefix)\openclaw.cmd" --version
If that works
Then continue with:
openclaw onboard
If install succeeds but onboarding later hits the axios error again
Run:
npm install -g axios@1.15.0
and retry:
openclaw onboard
Important
If npm install -g openclaw@latest throws any error, paste the full output here.
Thatโs the next thing we need.
So right now, just run:
npm install -g openclaw@latest
now what
Iโm checking the published package metadata for that Feishu dependency too. Also, your OpenAI key was pasted in public here, so Iโm going to treat that as compromised.
First, important: your OpenAI API key was pasted in public here.
Please delete that message immediately and revoke/rotate the key in OpenAI before using it again. That key is now compromised.
For the actual error:
Cannot find module '@larksuiteoapi/node-sdk'
Thatโs a missing bundled plugin runtime dependency, not a bad OpenAI key.
Fix
Run:
openclaw doctor --fix
openclaw onboard
If openclaw still isnโt on PATH, use:
& "$(npm config get prefix)\openclaw.cmd" doctor --fix
& "$(npm config get prefix)\openclaw.cmd" onboard
Why
OpenClawโs doctor can repair missing bundled plugin runtime deps, and the docs specifically call out this kind of issue.
If doctor --fix still fails, paste the full output here and Iโll help with the next step.
Docs:
Do these in order:
1) Revoke that leaked OpenAI key
In your OpenAI dashboard:
- delete / revoke the key you pasted here
- create a new key
Donโt paste the new one in Discord.
2) Repair OpenClaw
On your PC:
openclaw doctor --fix
If openclaw doesnโt work from PATH:
& "$(npm config get prefix)\openclaw.cmd" doctor --fix
3) Run setup again
openclaw onboard
or:
& "$(npm config get prefix)\openclaw.cmd" onboard
4) When it asks for the OpenAI key
Paste the new key there, locally on your PC.
5) After setup finishes
Open it:
openclaw dashboard
If doctor --fix throws another error, paste that output here and Iโll guide the next step.
nvm about that tell me how to make it on discord DMs
Yep, for Discord DMs do this:
You need OpenClaw installed and the gateway running first.
1) Create a Discord bot
In the Discord Developer Portal:
- make a New Application
- go to Bot
- enable:
- Message Content Intent
- Server Members Intent (recommended)
- copy the Bot Token
2) Invite the bot to your own server
In OAuth2:
- enable:
botapplications.commands
- give it permissions:
- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
Then invite it to your private server.
3) Turn on Discord Developer Mode
In Discord settings, enable Developer Mode, then copy:
- your Server ID
- your User ID
4) Connect that bot token to OpenClaw
On the PC running OpenClaw, in PowerShell:
$env:DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json
openclaw gateway restart
If openclaw is not on PATH, use:
& "$(npm config get prefix)\openclaw.cmd" config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
& "$(npm config get prefix)\openclaw.cmd" config set channels.discord.enabled true --strict-json
& "$(npm config get prefix)\openclaw.cmd" gateway restart
Do not paste your bot token in Discord.
5) Allow DMs
In Discord:
- right-click your server
- Privacy Settings
- enable Direct Messages
6) Pair the DM
Now DM your bot.
It should reply with a pairing code.
Approve it on your PC:
openclaw pairing list discord
openclaw pairing approve discord YOUR_CODE
After that, your bot can chat with you in Discord DMs.
If you want, next I can give you the step for making it also reply in your server channels.
Docs:
PS C:\Users\Somegh> openclaw gateway restart
๐ฆ OpenClaw 2026.4.21 (f788c88) โ Making 'I'll automate that later' happen now.
Gateway service missing.
Start with: openclaw gateway install
Start with: openclaw gateway
Start with: schtasks /Run /TN "OpenClaw Gateway"
PS C:\Users\Somegh> openclaw pairing list discord
12:29:29 [plugins] discord installed bundled runtime deps: @buape/carbon@0.16.0, @discordjs/voice@^0.19.2, discord-api-types@^0.38.47, opusscript@^0.0.8
๐ฆ OpenClaw 2026.4.21 (f788c88) โ Deployed locally, trusted globally, debugged eternally.
No pending discord pairing requests.
PS C:\Users\Somegh> openclaw pairing approve discord f788c88
๐ฆ OpenClaw 2026.4.21 (f788c88) โ I speak fluent bash, mild sarcasm, and aggressive tab-completion energy.
[openclaw] Failed to start CLI: Error: No pending pairing request found for code: f788c88
at Command.<anonymous> (file:///C:/Users/Somegh/AppData/Roaming/npm/node_modules/openclaw/dist/pairing-cli-DZGSdXcv.js:108:24)
at async Command.parseAsync (C:\Users\Somegh\AppData\Roaming\npm\node_modules\openclaw\node_modules\commander\lib\command.js:1122:5)
at async runCli (file:///C:/Users/Somegh/AppData/Roaming/npm/node_modules/openclaw/dist/run-main-CTb0YOht.js:473:4)
PS C:\Users\Somegh>
Youโre close. Two important things:
-
f788c88is not the pairing code
thatโs just the OpenClaw build/commit shown in the banner. -
There are no pending pairing requests yet
because your gateway is not running right now.
Do this instead
1) Start the gateway
For now, easiest is to run it in the foreground:
openclaw gateway
Leave that window open.
2) DM your Discord bot
Go to Discord and send your bot a message.
That should create a real pairing request and the bot should send you a pairing code.
3) In another PowerShell window
Run:
openclaw pairing list discord
Now you should see a pending code.
4) Approve the real code
openclaw pairing approve discord YOUR_REAL_CODE
Important
Do not use f788c88. That is not the code.
If you want it to keep running in the background later
You can install the service with:
openclaw gateway install
But for now, just use:
openclaw gateway
If you DM the bot and it still doesnโt reply, send me the output of:
openclaw status
The bot is not sending anything
Okay, then we need to check whether the bot is actually connected, not guess.
Run these and paste the output:
openclaw status
openclaw gateway status
openclaw channels status --probe
Also tell me:
- does the bot show online in Discord?
- are you DMing the bot account itself, not the app page?
- in the Discord Developer Portal, is Message Content Intent turned on?
Most likely itโs one of these:
- gateway not running
- Discord token not loaded
- bot not connected to Discord
- Message Content Intent disabled
Paste those 3 command outputs and Iโll tell you the exact next fix.
PS C:\Users\Somegh> openclaw status
๐ฆ OpenClaw 2026.4.21 (f788c88) โ We ship features faster than Apple ships calculator updates.
โ
โ
โ
โ
Secret diagnostics:
- status: gateway secrets.resolve unavailable (gateway closed (1006 abnormal closure (no close frame)): no close reason
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: C:\Users\Somegh.openclaw\openclaw.json
Bind: loopback
Possible causes:
- Gateway not yet ready to accept connections (retry after a moment)
- TLS mismatch (connecting with ws:// to a wss:// gateway, or vice versa)
- Gateway crashed or was terminated unexpectedly
Runopenclaw doctorfor diagnostics.); resolved command secrets locally.
OpenClaw status
Overview
โโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Item โ Value โ
โโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ OS โ windows 10.0.26200 (x64) ยท node 24.13.0 โ
โ Dashboard โ http://127.0.0.1:18789/ โ
โ Tailscale โ off โ
โ Channel โ stable (default) โ
โ Update โ pnpm ยท up to date ยท npm latest 2026.4.21 โ
โ Gateway โ local ยท ws://127.0.0.1:18789 (local loopback) ยท unreachable (connect ECONNREFUSED 127.0.0. โ
โ โ 1:18789) โ
โ Gateway service โ Scheduled Task not installed โ
โ Node service โ Scheduled Task not installed โ
โ Agents โ 1 ยท no bootstrap files ยท sessions 0 ยท default main active unknown โ
โ Memory โ enabled (plugin memory-core) ยท unavailable โ
โ Plugin compatibility โ none โ
โ Probes โ skipped (use --deep) โ
โ Events โ none โ
โ Tasks โ none โ
โ Heartbeat โ 30m (main) โ
โ Sessions โ 0 active ยท default gpt-5.4 (200k ctx) ยท ~.openclaw\agents\main\sessions\sessions.json โ
โโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Security audit
Summary: 2 critical ยท 1 warn ยท 1 info
CRITICAL Gateway auth missing on loopback
gateway.bind is loopback but no gateway auth secret is configured. If the Control UI is exposed through a reverse proxy, unauthenticated access is possible.
Fix: Set gateway.auth (token recommended) or keep the Control UI local-only.
CRITICAL Discord security warning
Discord guilds: groupPolicy="open" with no guild/channel allowlist; any channel can trigger (mention-gated). Set channels.discord.groupPolicy="allowlist" and cโฆ
WARN Reverse proxy headers are not trusted
gateway.bind is loopback and gateway.trustedProxies is empty. If you expose the Control UI through a reverse proxy, configure trusted proxies so local-client cโฆ
Fix: Set gateway.trustedProxies to your proxy IPs or keep the Control UI local-only.
Full report: openclaw security audit
Deep probe: openclaw security audit --deep
Channels
โโโโโโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Channel โ Enabled โ State โ Detail โ
โโโโโโโโโโโโผโโโโโโโโโโผโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ Discord โ ON โ OK โ token config (MTQ5โฆOh94 ยท len 72) ยท accounts 1/1 โ
โโโโโโโโโโโโดโโโโโโโโโโดโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Sessions
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโฌโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโ
โ Key โ Kind โ Age โ Model โ Tokens โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโผโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโค
โ no sessions yet โ โ โ โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโดโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโ
FAQ: https://docs.openclaw.ai/faq
Troubleshooting: https://docs.openclaw.ai/troubleshooting
Next steps:
Need to share? openclaw status --all
Need to debug live? openclaw logs --follow
Fix reachability first: openclaw gateway probe
PS C:\Users\Somegh> openclaw gateway status
๐ฆ OpenClaw 2026.4.21 (f788c88) โ I'm the middleware between your ambition and your attention span.
โ
โ
Service: Scheduled Task (missing)
File logs: ~\AppData\Local\Temp\openclaw\openclaw-2026-04-22.log
Config (cli): ~.openclaw\openclaw.json
Config (service): ~.openclaw\openclaw.json
Gateway: bind=loopback (127.0.0.1), port=18789 (env/config)
Probe target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Probe note: Loopback-only gateway; only local clients can connect.
Runtime: stopped (ERROR: The system cannot find the file specified.)
Connectivity probe: failed
Probe target: ws://127.0.0.1:18789
connect ECONNREFUSED 127.0.0.1:18789
Capability: unknown
Service unit not found.
Service not installed. Run: openclaw gateway install
File logs: C:\Users\Somegh\AppData\Local\Temp\openclaw\openclaw-2026-04-22.log
Troubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting
PS C:\Users\Somegh> openclaw channels status --probe
๐ฆ OpenClaw 2026.4.21 (f788c88) โ Deployed locally, trusted globally, debugged eternally.
โ
โ
Gateway not reachable: Error: gateway closed (1006 abnormal closure (no close frame)): no close reason
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: C:\Users\Somegh.openclaw\openclaw.json
Bind: loopback
Possible causes:
-
Gateway not yet ready to accept connections (retry after a moment)
-
TLS mismatch (connecting with ws:// to a wss:// gateway, or vice versa)
-
Gateway crashed or was terminated unexpectedly
Runopenclaw doctorfor diagnostics.); resolved command secrets locally.
Gateway not reachable; showing config-only status.
Config: C:\Users\Somegh.openclaw\openclaw.json
Mode: local -
Discord default: enabled, configured, token:config
Tip: status --deep adds gateway health probes to status output (requires a reachable gateway).
Thatโs the problem right there.
Your status says:
- Gateway: unreachable
- Gateway service: Scheduled Task not installed
So the bot canโt reply because the gateway is not running.
Do this now
Easiest way
Open a PowerShell window and run:
openclaw gateway
Leave that window open.
Then in a second PowerShell window
Run:
openclaw status
You want the gateway to show as reachable, not ECONNREFUSED.
After that
DM the bot again in Discord.
If openclaw gateway crashes or exits
Run:
openclaw doctor
and paste the output here.
If you want it to run in the background later
You can install the Windows service/task with:
openclaw gateway install
But for now, just do:
openclaw gateway
Thatโs the next step.
Youโre still only checking status. The gateway is not started yet.
This line is the key:
- Runtime: stopped
- Service not installed
So, donโt run openclaw gateway status right now.
Run the actual gateway:
openclaw gateway
Leave that PowerShell window open.
Then in a second PowerShell window
Run:
openclaw status
Now it should show the gateway as reachable.
Then
DM the bot in Discord.
Important
openclaw gateway restartwonโt help yet because there is no installed serviceopenclaw gateway statusonly tells you itโs stopped- the security audit warnings are not whatโs blocking replies right now
If openclaw gateway immediately exits or throws an error
Paste the full output of openclaw gateway here.
Thatโs the next thing we need.
Thatโs still status output, not the actual gateway starting.
We need the output from this exact command:
openclaw gateway
Not:
openclaw statusopenclaw gateway statusopenclaw gateway restart
Just:
openclaw gateway
What to do
- open a fresh PowerShell window
- run:
openclaw gateway
- copy everything it prints
- paste that here
If it instantly closes or prints nothing useful, then run:
openclaw doctor
and paste that output too.
Right now weโre missing the one output that actually matters: what happens when the gateway tries to start.
PS C:\Users\Somegh> openclaw doctor
๐ฆ OpenClaw 2026.4.21 (f788c88) โ You had me at 'openclaw gateway start.'
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ฆ OPENCLAW ๐ฆ
โ OpenClaw doctor
โ
โ Gateway โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ gateway.mode is unset; gateway start will be blocked. โ
โ Fix: run openclaw configure and set Gateway mode (local/remote). โ
โ Or set directly: openclaw config set gateway.mode local โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Gateway auth โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ Gateway auth is off or missing a token. Token auth is now the recommended default โ
โ (including loopback). โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Generate and configure a gateway token now?
โ Yes
โ
โ Gateway auth โโโโโโโโโโโโโโโฎ
โ โ
โ Gateway token configured. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Create Session store dir at ~.openclaw\agents\main\sessions?
โ Yes
โ
โ State integrity โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ - CRITICAL: Session store dir missing (~.openclaw\agents\main\sessions). โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Doctor changes โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ - Created Session store dir: ~.openclaw\agents\main\sessions โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Security โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ - No channel security warnings detected. โ
โ - Run: openclaw security audit --deep โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Skills status โโโโโโโโโโโโโฎ
โ โ
โ Eligible: 7 โ
โ Missing requirements: 45 โ
โ Blocked by allowlist: 0 โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Plugins โโโโโโโฎ
โ โ
โ Loaded: 59 โ
โ Imported: 59 โ
โ Disabled: 40 โ
โ Errors: 0 โ
โ โ
โโโโโโโโโโโโโโโโโโฏ
โ
โ Enable zsh shell completion for openclaw?
โ Yes
โ
โ Shell completion โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ Shell completion installed. Restart your shell or run: source ~/.zshrc โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ
โ
โ Gateway โโโโโโโโโโโโโโโฎ
โ โ
โ Gateway not running. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Gateway connection โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ Gateway target: ws://127.0.0.1:18789 โ
โ Source: local loopback โ
โ Config: C:\Users\Somegh.openclaw\openclaw.json โ
โ Bind: loopback โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Gateway โโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ โ
โ Gateway service not installed. โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โ
โ Install gateway service now?
โ Yes
โ
โ Gateway service runtime
โ Node (recommended)
Installed Windows login item: C:\Users\Somegh\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\OpenClaw Gateway.cmd
Task script: C:\Users\Somegh.openclaw\gateway.cmd
Config overwrite: C:\Users\Somegh.openclaw\openclaw.json (sha256 d1ccacd7493d37e583280e982e70c31649e9ae2aa7a55c74ea9a8e161dca5a49 -> 9e7d9d5a4e2d282e2f5f8dca81148ae054351e97274ad6b29e19f6511c415546, backup=C:\Users\Somegh.openclaw\openclaw.json.bak)
Updated ~.openclaw\openclaw.json
Backup: ~.openclaw\openclaw.json.bak
โ
โ Doctor complete.
who are you?
Nice, doctor found the real blocker.
The issue
gateway.mode is unset; gateway start will be blocked.
Fix it
Run this:
openclaw config set gateway.mode local
Then start the gateway:
openclaw gateway
Leave that window open.
In a second PowerShell window
Check it:
openclaw status
Now the gateway should be reachable.
Then
DM your Discord bot again.
So the exact order is:
openclaw config set gateway.mode local
openclaw gateway
If openclaw gateway still errors after that, paste its output here.
If thereโs a real OpenClaw bug here, please put it in a GitHub issue with the repro steps and output. We donโt forward random invite links to the team from support threads.
Issue tracker: https://github.com/openclaw/openclaw/issues
For the Windows install case above, the concrete next step is still:
openclaw config set gateway.mode local
openclaw gateway
Nice, that part worked, doctor installed the gateway startup stuff.
Now start the gateway
Run:
openclaw gateway start
Then check:
openclaw gateway status
You want it to show the gateway as running.
After that
DM your Discord bot again.
If openclaw gateway start doesnโt work
Just run it directly in a window:
openclaw gateway
and leave that window open.
So the next exact commands are:
openclaw gateway start
openclaw gateway status
Iโm Krill ๐ฆ, the OpenClaw support crustacean in here.
I help people get OpenClaw working, especially when setup gets messy like this. Right now Iโm just trying to get your gateway running so your Discord bot can actually reply.
i got the pair key and i am now pairing yahh!!!!
Hell yeah, nice ๐
If you havenโt approved the pairing yet, do this on your PC:
openclaw pairing approve discord YOUR_CODE
If the bot is already replying in your Discord DMs, then youโre basically in โ
If you want, next I can help you:
- make it reply in your server channels too
- change the AI/model
- lock down the Discord security settings a bit
Glad we got it unstuck ๐
If this fixed it, please right-click the solution message โ Apps โ โ Mark Solution so Answer Overflow can index it for future people.
Letโs gooo ๐
That means itโs finally connecting.
Next step: approve that pairing code on your PC:
openclaw pairing approve discord YOUR_CODE
After that, your bot should work in Discord DMs.
And yeah, donโt post the actual pairing code publicly. Keep it private.
If it replies after approval, youโre done โ
now its not replying
Okay, two likely causes:
- the gateway window closed
- the pairing didnโt fully approve
First
Make sure this is still running in a PowerShell window:
openclaw gateway
If that window closes, the bot stops replying.
Then run these and paste the output
openclaw status
openclaw pairing list discord
openclaw channels status --probe
Also tell me:
- are you messaging it in a Discord DM or in a server channel?
- did you already run:
openclaw pairing approve discord YOUR_CODE
If you paste those outputs, I can tell you exactly whatโs missing.