你想要一个自己机器上常驻的 AI 助手：能接多个聊天通道（Telegram/WhatsApp/Slack/Discord…）、能定时干活（每天 9 点汇总）、能操控浏览器、能跨会话记忆——而不是每次打开网页版聊天。OpenClaw 就是干这个的：一个本地 Gateway（控制面）+ CLI/TUI/网页控制台 + 通道接入 + 定时自动化（cron）的一体化个人 AI 助手平台，GitHub 38.8 万 stars（2026 顶流开源项目）。

什么时候用：

• 你要一个常驻的本地 AI 助手，通过聊天软件遥控它干活（多通道）；
• 你要定时/触发式自动化（每天自动跑任务、定期汇总、定时提醒）——openclaw cron 内置；
• 你要 AI 帮你操作浏览器（填表、发帖、跨页面任务）——openclaw browser 内置；
• 你要 skills/插件生态（ClawHub 5.4 万+ skills）扩展助手能力。

什么时候别用：只是临时跑一次对话（用聊天客户端就行）；只需要单命令的代码工具（那是 CLI 工具的活）；对常驻服务/Node 运行时敏感的环境（它是 Node 平台 + 常驻 Gateway）。

零账号红线：onboard/通道接入需要模型 API key 或聊天账号，本指南只覆盖安装与 CLI 验证，不碰任何账号。

一条命令装好并验证（国内实测路径：清华 npm 镜像前缀）：

# 来源: Trove 详细指南 · 验证于 2026-09-01
npm_config_registry=https://registry.npmmirror.com npm install -g openclaw@latest --no-audit --no-fund && openclaw --version

预期输出: OpenClaw 2026.8.1 (ea80657)（版本号以 latest 为准；实测 331 包 9s 完成）

前置条件：Node ≥ 22.22.3（或 24.15.0+ / 25.9.0+）。系统 Node 不满足时不要动系统 Node——用隔离部署（见「安装变体」）。

装好确认：

• openclaw --version 输出版本号；
• openclaw --help 能列出完整命令面（cron/browser/channels/gateway 都在）；
• openclaw gateway status 正常退出（exit 0）并能给出诊断信息（未 onboard 时 config 显示 missing 属正常）。

OpenClaw 是 Gateway 架构：一个本地常驻的 Gateway 进程是控制面（管理会话、工具、事件、通道连接），CLI/TUI/网页 Control UI 都连它；通道（Channels）把助手接到 WhatsApp/Telegram/Slack/Discord 等；cron/automations 子命令在 Gateway 上跑定时任务；browser 子命令管理专属浏览器实例。模型层支持 hosted 和本地 provider（可接 ollama）。

装完它动哪里：npm 全局包（Node 运行时）+ 首次 openclaw onboard 会建 ~/.openclaw/ 工作区（配置 + 数据库 + 日志）+ 可选 systemd user 服务（daemon）。

凭据行为（实测关键）：cron/browser/channels 的子命令都通过本地 Gateway 执行，未 onboard 时命令会明确报错而不是静默失败——这是「还没配置」的正常提示，不是故障（见第 5 节真实输出）。

与 moltis 的区别：OpenClaw = Node 平台的完整个人 AI 助手（多通道 + cron + 浏览器 + skills 生态）；moltis = Rust 单二进制轻量 Agent 服务器（安全优先）。定位相邻、形态不同，按「你要完整助手还是轻量服务器」选。

第 1 步：检查 Node 版本（前置条件）

为什么是这一步：openclaw 对 Node 版本有硬下限（22.22.3+），不满足时 npm postinstall 直接拒绝（实测报 [openclaw] detected Node 22.22.1）。不要动系统 Node，用隔离部署。

# 来源: Trove 详细指南 · 验证于 2026-09-01
node --version

预期输出: 22.22.3 或更高（22.22.3+ / 24.15.0+ / 25.9.0+ 任一满足）

卡住怎么办：

• node: command not found → 先装 Node（apt/nvm/官方二进制）；
• 版本 <22.22.3 → 隔离部署一个满足版本的 Node（实测路径 /opt/node-v24.15.0-linux-x64/bin 前置 PATH），不碰系统环境。

第 2 步：安装（清华镜像）

# 来源: Trove 详细指南 · 验证于 2026-09-01
npm_config_registry=https://registry.npmmirror.com npm install -g openclaw@latest --no-audit --no-fund

预期输出: changed 331 packages in 9s（包约 204MB unpacked；本机 9s 是缓存加速，首装 1-3 分钟属正常）

卡住怎么办：

• 报 [openclaw] detected Node xx → Node 版本不满足，回第 1 步隔离部署；
• 报 enoent spawn sh → PATH 被污染（检查 PATH 是否含 /usr/bin、/bin）；
• 超时 → 镜像不可达时换 registry.npmjs.org 直连（视网络）。

第 3 步：验证安装

# 来源: Trove 详细指南 · 验证于 2026-09-01
openclaw --version && openclaw --help | head -20

预期输出: 第一行 OpenClaw 2026.8.1 (ea80657)，随后列出命令面（acp/agent/channels/cron/gateway/memory/models/browser…）

卡住怎么办：

• openclaw: command not found → 确认全局 bin 在 PATH（npm prefix -g 查全局目录；隔离部署时前置其 bin）。

第 4 步：查看 Gateway 状态（诊断面，不启动服务）

# 来源: Trove 详细指南 · 验证于 2026-09-01
openclaw gateway status

预期输出: 显示 Service: systemd user (disabled) + Gateway: bind=loopback (127.0.0.1), port=18789 + Dashboard: http://127.0.0.1:18789/。未 onboard 时 config 显示 missing，属正常——首次完整使用需跑 openclaw onboard（交互向导，需要模型 API key，本指南不涉及）。

卡住怎么办：

• config missing → 不是坏。未执行 onboard 前的正常状态；onboard 会创建 ~/.openclaw/openclaw.json 并配置 Gateway。

第 5 步：认识未 onboard 时的真实报错（cron/browser/channels 通用）

讲解：cron/browser/channels 子命令都走 Gateway；未配置凭据时会明确报错。教你会认这个报错，避免误判故障。

# 来源: Trove 详细指南 · 验证于 2026-09-01
openclaw cron list

预期输出:

gateway cron.list requires credentials before opening a websocket Fix: configure gateway.auth token/password, pair this device, or pass --token/--password. Config: ~/.openclaw/openclaw.json

含义：还没 onboard / 设备未配对。按提示配置 gateway.auth（token/password）或配对设备后重试；不想配凭据就先用 openclaw doctor 看全局状态。

# 来源: Trove 详细指南 · 验证于 2026-09-01
openclaw browser doctor

预期输出:

FAIL gateway: GatewayCredentialsRequiredError: gateway browser.request requires credentials before opening a websocket Fix: configure gateway.auth token/password, pair this device, or pass --token/--password. Config: ~/.openclaw/openclaw.json

含义与上面同理：browser 子命令全走 Gateway，未 onboard 时统一报 credentials 错误。

卡住怎么办：

• 看到 credentials 报错就以为装坏了 → 不是。这是「还没 onboard」的正常提示，按 Fix 提示配置即可；
• 想先看全局状态 → openclaw doctor 健康检查报告（模型/网关/通道配置状态；未 onboard 时输出未配置项属正常诊断面）。

第 6 步：命令面速览（onboard 后可用）

讲解：以下子命令面在 --help/命令面实测可见；真正执行需 Gateway 凭据（onboard 后）。列出供查阅，参数细节见官方文档 docs.openclaw.ai。

• cron/automations：add 新增、list 列出、show/get 查看单个、edit 修改、enable/disable 启停、rm 删除、run 立即跑一次、runs 运行历史、status 调度器状态、scratch 读写私有暂存；
• browser：create-profile/delete-profile 管理专属浏览器配置、click/click-coords/fill/drag/highlight 页面交互、evaluate 对页面执行函数、close 关标签页、console/errors 取页面日志、download 保存下载、batch 一次跑一组动作、doctor 就绪检查；
• channels：add 新增/更新通道、login/logout 链接/退出会话、remove 删除、status --probe 状态探测、logs 通道日志、capabilities 各 provider 能力。非交互示例（需真实 token 才有意义）：openclaw channels add --channel telegram --token <token>。

与工具页矩阵同源；完整对子、状态与证据见 冲突对子（共装矩阵）。已知关联：

• moltis × openclaw：定位相邻（完整助手 vs 轻量服务器），命令名不同、写面不重叠（各自 ~/.config 目录），静态判定可共存；
• herdr/ruflo/claude-mem 等 CLI 工具：写面不重叠，静态判定可共存；
• 其余：以矩阵页为准（possible-compatible 推断态居多）。

• 症状：npm 报 [openclaw] detected Node 22.22.1 → 系统 Node 不满足 22.22.3+；隔离部署满足版本的 Node（实测 /opt/node-v24.15.0-linux-x64），不碰系统 Node
• 症状：gateway status 显示 config missing → 不是坏；未 onboard 的正常状态，onboard 会创建配置
• 症状：cron/browser 报 credentials required → 还没 onboard/设备未配对；按 Fix 提示配置 gateway.auth 或配对设备
• 症状：enoent spawn sh → PATH 被污染（缺 /usr/bin、/bin）
• 症状：安装后 openclaw 命令找不到 → 全局 bin 不在 PATH（npm prefix -g 查全局目录；隔离部署前置其 bin）

四段式全文（症状→原因→解法→验证证据）：站内文档（如已收录）

# 来源: Trove 详细指南 · 验证于 2026-09-01
npm uninstall -g openclaw --no-audit --no-fund && rm -rf ~/.openclaw

预期输出: npm 移除输出（Removed N packages）；~/.openclaw 不存在即为清理干净

注意：删除工作区会丢失全部配置/记忆/通道绑定，卸载前如需保留先 openclaw backup；daemon 若启用需先停服务。

• 问：npm 报 [openclaw] detected Node 22.22.1 怎么办？答：系统 Node 不满足 22.22.3+。不要动系统 Node——隔离部署满足版本的 Node（如 24.15.0）到独立目录，用它前缀跑 npm 安装（本机实测路径：/opt/node-v24.15.0-linux-x64/bin 前置 PATH）。安装后 openclaw 命令也走该 Node 前缀。
• 问：gateway status 显示 config missing 是坏了吗？答：不是。未执行 onboard 前的正常状态；onboard 会创建 ~/.openclaw/openclaw.json 并配置 Gateway。
• 问：安装后 openclaw 命令找不到？答：检查全局 bin 是否在 PATH（npm prefix -g 查全局目录）；隔离 Node 部署时确认 PATH 前缀含其 bin。
• 问：onboard 一定要 API key 吗？能接本地模型吗？答：官方支持 hosted 和本地 provider（可配 ollama 等本地模型）。onboard 为交互向导，本指南零账号未实测，配置细节见官方文档 docs.openclaw.ai/concepts/model-providers。
• 问：定时任务需要 Gateway 一直跑吗？答：是——cron/automations 跑在 Gateway 上，需要 daemon 常驻。未实测（零账号 + 避免常驻进程干扰），如实标注。
• 问：OpenClaw 和 moltis 有什么区别？答：OpenClaw = Node 平台的完整个人 AI 助手（多通道 + cron + 浏览器 + skills 生态）；moltis = Rust 单二进制轻量 Agent 服务器（安全优先）。定位相邻、形态不同，按「你要完整助手还是轻量服务器」选。
• 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口；项目自身问题请向作者仓库反馈。

• 版本：2026.8.1（manifest 锁定；npm 实测 2026-09-01）。
• 环境：Node ≥22.22.3（24.15.0+/25.9.0+ 亦可）；隔离部署路径实测 /opt/node-v24.15.0-linux-x64。
• 网络：npm 走清华镜像（实测 331 包 9s）；官方 registry 直连慢。
• 写面：~/.openclaw/（配置/数据库/日志）+ npm 全局包；可选 systemd user 服务。
• 端口：Gateway 18789（loopback）；onboard/通道接入需凭据（零账号不涉及）。

• 条目签名：openclaw 官方 npm 包（原样收录 2026.8.1）

• 实测：实测复现日志（2026-09-01）（Node 24.15.0 隔离部署 npmmirror 31MB/10s + npm 清华镜像安装 331 包 9s + openclaw --version 2026.8.1 + --help 命令面 + gateway status loopback 18789 exit 0）
• 未实测：onboard 向导（需 API key，零账号）、Gateway 常驻服务、通道接入、cron/browser 实际执行（命令面可见但需 onboard 后生效）。