前言

OpenClaw (小龙虾) 很火, 没想到我很早取名字(铅笔侠爱小龙虾)的时候居然预言到了, 当时小龙虾只是一种食物, 没想到它的影响力居然如此疯狂。那我也来蹭一下小龙虾。

万事开头难，安装卸载也麻烦。网上沸沸扬扬从安装到卸载都收费，就是个骗子行径，掉钱眼了。不过经过我的踩坑，总结可行安装经验，现记录如下：

参考

官方项目及文档

https://github.com/openclaw/openclaw.git
https://docs.openclaw.ai/

open-claw-cn

https://open-claw.org.cn
https://gitee.com/OpenClaw-CN/openclaw-cn.git

环境准备

因为小龙虾很强大也很危险, 所以建议在服务器上运行。它有超级管理权限，可以控制你的服务器，所以要谨慎使用。这里我准备了一台云服务器，配置都可以不用太高，里面没啥重要东西，它就用来跑 OpenClaw，随便 OpenClaw 它怎么搞，我都不带怕的，哈哈，当然还是希望它作为一个工具能有一些帮助吧。

大模型

OpenClaw 支持多个大模型，我这里用的是 deepseek，拿到它的 API 密钥 sk-xxxxx, 参考 https://platform.deepseek.com/api_keys

服务器环境

随便准备一台 Ubuntu 服务器，配置都可以不用太高, 我的云服务器信息如下:

 系统信息：
 - 主机名： VM-0-14-ubuntu
 - 操作系统： Ubuntu 24.04.3 LTS (Noble Numbat)
 - 内核版本： Linux 6.8.0-90-generic
 - 架构： x86_64
 - 当前用户： root

 硬件配置：
 - CPU： Intel(R) Xeon(R) Platinum 8255C @ 2.50GHz (4核心)
 - 内存： 3.6GB (已用1.0GB，可用2.6GB)
 - 硬盘： 40GB (已用39GB，使用率100% ⚠️)
 - 虚拟化： KVM 虚拟机

前端环境

nvm, pnpm 环境准备参考 https://blog.csdn.net/weixin_43719312/article/details/156449639

官网要求 node 22.16+ https://docs.openclaw.ai/install/node:

OpenClaw requires Node 22.16 or newer. Node 24 is the default and recommended runtime for installs, CI, and release workflows. Node 22 remains supported via the active LTS line. The installer script will detect and install Node automatically — this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs).

查看当前 node版本:

root:~# nvm ls
->     v22.22.1
       v24.12.0
default -> 22 (-> v22.22.1)
iojs -> N/A (default)
unstable -> N/A (default)
node -> stable (-> v24.12.0) (default)
stable -> 24.12 (-> v24.12.0) (default)
lts/* -> lts/krypton (-> N/A)
lts/argon -> v4.9.1 (-> N/A)
lts/boron -> v6.17.1 (-> N/A)
lts/carbon -> v8.17.0 (-> N/A)
lts/dubnium -> v10.24.1 (-> N/A)
lts/erbium -> v12.22.12 (-> N/A)
lts/fermium -> v14.21.3 (-> N/A)
lts/gallium -> v16.20.2 (-> N/A)
lts/hydrogen -> v18.20.8 (-> N/A)
lts/iron -> v20.20.1 (-> N/A)
lts/jod -> v22.22.1
lts/krypton -> v24.14.0 (-> N/A)

pnpm 安装 OpenClaw

最简单就是用 pnpm 安装 OpenClaw:

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

配置 OpenClaw

主要是配置模型及 api-key, 其他都可以在后续配置中再添加。最新版 openclaw 支持deepseek模型, 在旧版中可能没有,没有的话就随便选一个openAI模型, 后面可以在配置中改。

🦞 OpenClaw 2026.3.23-2 (7ffe7e4) — Powered by open source, sustained by spite and good documentation.

▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
                  🦞 OPENCLAW 🦞

┌  OpenClaw setup
│
◇  Security ─────────────────────────────────────────────────────────────────────────────────╮
│                                                                                            │
│  Security warning — please read.                                                           │
│                                                                                            │
│  OpenClaw is a hobby project and still in beta. Expect sharp edges.                        │
│  By default, OpenClaw is a personal agent: one trusted operator boundary.                  │
│  This bot can read files and run actions if tools are enabled.                             │
│  A bad prompt can trick it into doing unsafe things.                                       │
│                                                                                            │
│  OpenClaw is not a hostile multi-tenant boundary by default.                               │
│  If multiple users can message one tool-enabled agent, they share that delegated tool      │
│  authority.                                                                                │
│                                                                                            │
│  If you’re not comfortable with security hardening and access control, don’t run           │
│  OpenClaw.                                                                                 │
│  Ask someone experienced to help before enabling tools or exposing it to the internet.     │
│                                                                                            │
│  Recommended baseline:                                                                     │
│  - Pairing/allowlists + mention gating.                                                    │
│  - Multi-user/shared inbox: split trust boundaries (separate gateway/credentials, ideally  │
│    separate OS users/hosts).                                                               │
│  - Sandbox + least-privilege tools.                                                        │
│  - Shared inboxes: isolate DM sessions (`session.dmScope: per-channel-peer`) and keep      │
│    tool access minimal.                                                                    │
│  - Keep secrets out of the agent’s reachable filesystem.                                   │
│  - Use the strongest available model for any bot with tools or untrusted inboxes.          │
│                                                                                            │
│  Run regularly:                                                                            │
│  openclaw security audit --deep                                                            │
│  openclaw security audit --fix                                                             │
│                                                                                            │
│  Must read: https://docs.openclaw.ai/gateway/security                                      │
│                                                                                            │
├────────────────────────────────────────────────────────────────────────────────────────────╯
│
◆  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  ○ Yes / ● No
◆  Setup mode
│  ● QuickStart (Configure details later via openclaw configure.)
│  ○ Manual
│
◆  Config handling
│  ● Use existing values
│  ○ Update values
│  ○ Reset
│
◆  Model/auth provider
│  ○ Anthropic
│  ○ BytePlus
│  ○ Chutes
│  ○ Cloudflare AI Gateway
│  ○ Copilot
│  ○ Custom Provider
│  ● DeepSeek (API key)
│  ○ Google
│  ○ Hugging Face
│  ○ Kilo Gateway
│  ○ Kimi Code
│  ○ LiteLLM
│  ○ MiniMax
│  ○ Mistral AI
│  ○ Moonshot AI (Kimi K2.5)
│  ○ Ollama
│  ○ OpenAI
│  ○ OpenCode
│  ○ OpenRouter
│  ○ Qianfan
│  ○ Qwen
│  ○ Qwen (Alibaba Cloud Model Studio)
│  ○ SGLang
│  ○ Synthetic
│  ○ Together AI
│  ○ Venice AI
│  ○ Vercel AI Gateway
│  ○ vLLM
│  ○ Volcano Engine
│  ○ xAI (Grok)
│  ○ Xiaomi
│  ○ Z.AI
│  ○ Skip for now
│
◇  Model/auth provider
│  DeepSeek
│
◇  Enter DeepSeek API key
│  sk-xxxxxx<your-deepseek-api-key>xxxxx
│
◇  Model configured ────────────────────────────╮
│                                               │
│  Default model set to deepseek/deepseek-chat  │
│                                               │
├───────────────────────────────────────────────╯
│
◆  Default model
│  ● Keep current (deepseek/deepseek-chat)
│  ○ Enter model manually
│  ○ deepseek/deepseek-chat
│  ○ deepseek/deepseek-reasoner
│
◆  Select channel (QuickStart)
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ IRC (Server + Nick)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ LINE (Messaging API)
│  ○ Feishu/Lark (飞书)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Synology Chat (Webhook)
│  ○ Tlon (Urbit)
│  ○ Twitch (Chat)
│  ● Skip for now (You can add channels later via `openclaw channels add`)
◆  Search provider
│  ○ Brave Search
│  ● DuckDuckGo Search (experimental) (Free web search fallback with no API key required · key-free)
│  ○ Exa Search
│  ○ Firecrawl Search
│  ○ Gemini (Google Search)
│  ○ Grok (xAI)
│  ○ Kimi (Moonshot)
│  ○ Perplexity Search
│  ○ Tavily Search
│  ○ Skip for now
◆  Configure skills now? (recommended)
│  ○ Yes / ● No
│
... 其他配置可以先跳过
│
◇  Dashboard ready ────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Dashboard link (with token):                                                    │
│  http://127.0.0.1:18789/#token=xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx  │
│  Copy/paste this URL in a browser on this machine to control OpenClaw.           │
│  No GUI detected. Open from your computer:                                       │
│  ssh -N -L 18789:127.0.0.1:18789 root@172.16.0.9                                 │
│  Then open:                                                                      │
│  http://localhost:18789/                                                         │
│  http://localhost:18789/#token=xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx  │
│  Docs:                                                                           │
│  https://docs.openclaw.ai/gateway/remote                                         │
│  https://docs.openclaw.ai/web/control-ui                                         │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────╯
◇  Web search ──────────────────────────────────────────────────────────────────────╮
│                                                                                   │
│  Provider DuckDuckGo Search (experimental) is selected but no API key was found.  │
│  web_search will not work until a key is added.                                   │
│    openclaw configure --section web                                               │
│                                                                                   │
│  Get your key at: https://duckduckgo.com/                                         │
│  Docs: https://docs.openclaw.ai/tools/web                                         │
│                                                                                   │
├───────────────────────────────────────────────────────────────────────────────────╯
│
◇  What now ─────────────────────────────────────────────────────────────╮
│                                                                        │
│  What now: https://openclaw.ai/showcase ("What People Are Building").  │
│                                                                        │
├────────────────────────────────────────────────────────────────────────╯
│
└  Onboarding complete. Use the dashboard link above to control OpenClaw.

查看运行状态

root:~# openclaw status

🦞 OpenClaw 2026.3.23-2 (7ffe7e4)
   Running on your hardware, reading your logs, judging nothing (mostly).

│
◇
│
◇
OpenClaw status

Overview
┌──────────────────────┬────────────────────────────────────────────────────────────────────────────┐
│ Item                 │ Value                                                                      │
├──────────────────────┼────────────────────────────────────────────────────────────────────────────┤
│ Dashboard            │ http://127.0.0.1:18789/                                                    │
│ OS                   │ linux 6.8.0-90-generic (x64) · node 22.22.1                                │
│ Tailscale            │ off                                                                        │
│ Channel              │ stable (default)                                                           │
│ Update               │ pnpm · up to date · npm latest 2026.3.23-2                                 │
│ Gateway              │ local · ws://127.0.0.1:18789 (local loopback) · unreachable (connect       │
│                      │ failed: connect ECONNREFUSED 127.0.0.1:18789)                              │
│ Gateway service      │ systemd not installed                                                      │
│ Node service         │ systemd not installed                                                      │
│ Agents               │ 1 · 1 bootstrap file present · sessions 1 · default main active 22d ago    │
│ Memory               │ 0 files · 0 chunks · dirty · sources memory · plugin memory-core · vector  │
│                      │ ready · fts ready · cache on (0)                                           │
│ Plugin compatibility │ none                                                                       │
│ Probes               │ skipped (use --deep)                                                       │
│ Events               │ none                                                                       │
│ Heartbeat            │ 30m (main)                                                                 │
│ Sessions             │ 1 active · default deepseek-chat (200k ctx) · ~/.openclaw/agents/main/     │
│                      │ sessions/sessions.json                                                     │
└──────────────────────┴────────────────────────────────────────────────────────────────────────────┘

Security audit
Summary: 0 critical · 2 warn · 1 info
  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.
  WARN Some gateway.nodes.denyCommands entries are ineffective
    gateway.nodes.denyCommands uses exact node command-name matching only (for example `system.run`), not shell-text filtering inside a command payload. - Unknown …
    Fix: Use exact command names (for example: canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.push, canvas.a2ui.pushJSONL, canvas.a2ui.reset). If you need broader restrictions, remove risky command IDs from allowCommands/default workflows and tighten tools.exec policy.
Full report: openclaw security audit
Deep probe: openclaw security audit --deep

Channels
┌──────────┬─────────┬────────┬─────────────────────────────────────────────────────────────────────┐
│ Channel  │ Enabled │ State  │ Detail                                                              │
├──────────┼─────────┼────────┼─────────────────────────────────────────────────────────────────────┤
└──────────┴─────────┴────────┴─────────────────────────────────────────────────────────────────────┘

Sessions
┌──────────────────────────────┬────────┬─────────┬───────────────┬─────────────────────────────────┐
│ Key                          │ Kind   │ Age     │ Model         │ Tokens                          │
├──────────────────────────────┼────────┼─────────┼───────────────┼─────────────────────────────────┤
│ agent:main:main              │ direct │ 22d ago │ deepseek-chat │ 25k/200k (12%) · 🗄️ 100% cached │
└──────────────────────────────┴────────┴─────────┴───────────────┴─────────────────────────────────┘

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

查看配置

配置文件位于 ~/.openclaw/openclaw.json

{
  "meta": {
    "lastTouchedVersion": "2026.3.23-2",
    "lastTouchedAt": "2026-03-25T02:41:40.059Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-25T02:41:40.026Z",
    "lastRunVersion": "2026.3.23-2",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "deepseek:default": {
        "provider": "deepseek",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "apiKey": "sk-xxxxxx<your-deepseek-api-key>xxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "api": "openai-completions",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner",
            "api": "openai-completions",
            "reasoning": true,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 131072,
            "maxTokens": 65536,
            "compat": {
              "supportsUsageInStreaming": true
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      },
      "models": {
        "deepseek/deepseek-chat": {
          "alias": "DeepSeek"
        }
      },
      "workspace": "/root/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "tools": {
    "profile": "coding",
    "web": {
      "search": {
        "enabled": true,
        "provider": "duckduckgo"
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "plugins": {
    "allow": ["duckduckgo"],
    "entries": {
      "duckduckgo": {
        "enabled": true
      }
    }
  }
}

使用

可以在终端运行 openclaw tui，进入 OpenClaw 的 TUI 界面。

root~# openclaw tui

🦞 OpenClaw 2026.3.23-2 (7ffe7e4)
   The only open-source project where the mascot could eat the competition.

 openclaw tui - ws://127.0.0.1:18789 - agent main - session main

 session agent:main:main


 查询当前机器信息


 我来帮你查询当前机器的信息。让我运行一些命令来获取系统详情。

 当前机器信息汇总：

 系统信息：
 - 主机名： VM-0-14-ubuntu
 - 操作系统： Ubuntu 24.04.3 LTS (Noble Numbat)
 - 内核版本： Linux 6.8.0-90-generic
 - 架构： x86_64
 - 当前用户： root

 硬件配置：
 - CPU： Intel(R) Xeon(R) Platinum 8255C @ 2.50GHz (4核心)
 - 内存： 3.6GB (已用1.0GB，可用2.6GB)
 - 硬盘： 40GB (已用39GB，使用率100% ⚠️)
 - 虚拟化： KVM 虚拟机

 网络信息：
 - IP地址： 10.0.0.14, 172.18.0.1, 172.17.0.1

 运行状态：
 - 运行时间： 6分钟
 - 系统负载： 0.94, 0.54, 0.24 (1分钟/5分钟/15分钟)
 - 当前时间： 2026年3月3日 14:14:48 CST (北京时间)

 ⚠️ 重要提醒：
 磁盘空间已满（40GB中已用39GB，使用率100%），这可能会影响系统正常运行，建议立即清理磁盘空间。

 connected | idle
 agent main | session main (openclaw-tui) | deepseek/deepseek-chat | tokens 11k/200k (6%)
─────────────────────────────────────────────────────────────────────────────────────────────────────

Control UI

像上面那样黑框框着实不好看，也不方便用。Openclaw 提供了一个控制界面，你可以通过浏览器访问。

就像这样：

在上面安装时，会打印出一个 URL，你可以通过浏览器访问。

◇  Dashboard ready ────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Dashboard link (with token):                                                    │
│  http://127.0.0.1:18789/#token=xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx  │
│  Copy/paste this URL in a browser on this machine to control OpenClaw.           │
│  No GUI detected. Open from your computer:                                       │
│  ssh -N -L 18789:127.0.0.1:18789 root@172.16.0.9                                 │
│  Then open:                                                                      │
│  http://localhost:18789/                                                         │
│  http://localhost:18789/#token=xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx  │
│  Docs:                                                                           │
│  https://docs.openclaw.ai/gateway/remote                                         │
│  https://docs.openclaw.ai/web/control-ui                                         │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────╯

如果忘记了，也可通过 openclaw dashboard 来获取。

root@:~# openclaw dashboard

🦞 OpenClaw 2026.3.23-2 (7ffe7e4)
   I'm like tmux: confusing at first, then suddenly you can't live without me.

Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx
Copy to clipboard unavailable.
No GUI detected. Open from your computer:
ssh -N -L 18789:127.0.0.1:18789 root@172.16.0.9
Then open:
http://localhost:18789/
http://localhost:18789/#token=xxxxxxxxxxxxxxxx<your-token>xxxxxxxxxxxxxxxxxxxx
Docs:
https://docs.openclaw.ai/gateway/remote
https://docs.openclaw.ai/web/control-ui

本地访问

因为 OpenClaw 是在服务器中运行的，而且是 local 模式(为了安全考虑不暴露在公网)，所以你需要通过 SSH 来访问。

第一步，先建立一个 SSH 隧道，将 OpenClaw 的端口映射到本地。

# ssh -N -L <local-port>:127.0.0.1:18789 root@<server-ip>
ssh -N -L 18789:127.0.0.1:18789 root@172.16.0.9

第二步，通过浏览器访问 http://127.0.0.1:18789/#token=<your-token> 即可。

接下来，你可以在浏览器中愉快地探索养虾之道了。

命令帮助

可以直接访问官网文档 https://docs.openclaw.ai/cli，查看命令帮助，或者通过 openclaw -h 来查看。

root:~# openclaw -h

🦞 OpenClaw 2026.3.23-2 (7ffe7e4) — Alexa, but with taste.

Usage: openclaw [options] [command]

Options:
  --dev                Dev profile: isolate state under ~/.openclaw-dev, default gateway port 19001,
                       and shift derived ports (browser/canvas)
  -h, --help           Display help for command
  --log-level <level>  Global log level override for file + console
                       (silent|fatal|error|warn|info|debug|trace)
  --no-color           Disable ANSI colors
  --profile <name>     Use a named profile (isolates OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH under
                       ~/.openclaw-<name>)
  -V, --version        output the version number

Commands:
  Hint: commands suffixed with * have subcommands. Run <command> --help for details.
  acp *                Agent Control Protocol tools
  agent                Run one agent turn via the Gateway
  agents *             Manage isolated agents (workspaces, auth, routing)
  approvals *          Manage exec approvals (gateway or node host)
  backup *             Create and verify local backup archives for OpenClaw state
  browser *            Manage OpenClaw's dedicated browser (Chrome/Chromium)
  channels *           Manage connected chat channels (Telegram, Discord, etc.)
  clawbot *            Legacy clawbot command aliases
  completion           Generate shell completion script
  config *             Non-interactive config helpers (get/set/unset/file/validate). Default: starts
                       guided setup.
  configure            Interactive configuration for credentials, channels, gateway, and agent
                       defaults
  cron *               Manage cron jobs via the Gateway scheduler
  daemon *             Gateway service (legacy alias)
  dashboard            Open the Control UI with your current token
  devices *            Device pairing + token management
  directory *          Lookup contact and group IDs (self, peers, groups) for supported chat channels
  dns *                DNS helpers for wide-area discovery (Tailscale + CoreDNS)
  docs                 Search the live OpenClaw docs
  doctor               Health checks + quick fixes for the gateway and channels
  gateway *            Run, inspect, and query the WebSocket Gateway
  health               Fetch health from the running gateway
  help                 Display help for command
  hooks *              Manage internal agent hooks
  logs                 Tail gateway file logs via RPC
  memory *             Search and reindex memory files
  message *            Send, read, and manage messages
  models *             Discover, scan, and configure models
  node *               Run and manage the headless node host service
  nodes *              Manage gateway-owned node pairing and node commands
  onboard              Interactive onboarding for gateway, workspace, and skills
  pairing *            Secure DM pairing (approve inbound requests)
  plugins *            Manage OpenClaw plugins and extensions
  qr                   Generate iOS pairing QR/setup code
  reset                Reset local config/state (keeps the CLI installed)
  sandbox *            Manage sandbox containers for agent isolation
  secrets *            Secrets runtime reload controls
  security *           Security tools and local config audits
  sessions *           List stored conversation sessions
  setup                Initialize local config and agent workspace
  skills *             List and inspect available skills
  status               Show channel health and recent session recipients
  system *             System events, heartbeat, and presence
  tui                  Open a terminal UI connected to the Gateway
  uninstall            Uninstall the gateway service + local data (CLI remains)
  update *             Update OpenClaw and inspect update channel status
  webhooks *           Webhook helpers and integrations

Examples:
  openclaw models --help
    Show detailed help for the models command.
  openclaw channels login --verbose
    Link personal WhatsApp Web and show QR + connection logs.
  openclaw message send --target +15555550123 --message "Hi" --json
    Send via your web session and print JSON result.
  openclaw gateway --port 18789
    Run the WebSocket Gateway locally.
  openclaw --dev gateway
    Run a dev Gateway (isolated state/config) on ws://127.0.0.1:19001.
  openclaw gateway --force
    Kill anything bound to the default gateway port, then start it.
  openclaw gateway ...
    Gateway control via WebSocket.
  openclaw agent --to +15555550123 --message "Run summary" --deliver
    Talk directly to the agent using the Gateway; optionally send the WhatsApp reply.
  openclaw message send --channel telegram --target @mychat --message "Hi"
    Send via your Telegram bot.

Docs: docs.openclaw.ai/cli

常用命令

Gateway服务

  # 启动服务（后台运行）
  openclaw gateway start
  # 前台运行（调试用）
  openclaw gateway run
  # 停止服务
  openclaw gateway stop
  # 重启服务
  openclaw gateway restart

查看服务状态

  # 查看服务状态
  openclaw gateway status
  # 健康检查
  openclaw gateway health
  # 详细探测
  openclaw gateway probe

服务安装/卸载

  # 安装为系统服务
  openclaw gateway install
  # 卸载系统服务
  openclaw gateway uninstall