本文说明:OpenClaw 是2026年最火的开源个人AI助手,通过命令行驱动,连接Telegram/WhatsApp/Discord,让AI真正替你打工。本文系统整理全部基础命令,附逐条解释,零基础新手也能看懂。
一、OpenClaw命令体系概览
OpenClaw 的所有操作都通过 命令行(CLI) 驱动。安装完成后,你会获得一个全局命令 openclaw,通过它完成安装、初始化、运行、调试等所有任务。
二、安装命令详解(3种方式)
curl -fsSL https://openclaw.ai/install.sh | bash
说明:自动安装 Node.js 和所有依赖,macOS/Linux/Windows 通用。执行后按提示操作即可,整个过程约2-5分钟。
npm i -g openclaw
说明:需已安装 Node.js 18+。安装完成后在任意终端输入 openclaw 即可使用。是大多数开发者的首选方式。
git clone https://github.com/openclaw/openclaw.gitcd openclaw && pnpm install && pnpm run buildpnpm run openclaw onboard说明:适合想自定义核心逻辑的高级用户。需安装 pnpm(npm i -g pnpm)。源码安装后用 pnpm run openclaw <命令> 代替 openclaw <命令>。
⚠️ 新手常见坑:安装失败怎么办?
- • 网络超时:npm 访问需要稳定的国际网络,国内直连经常超时
- • Node 版本过低:需要 Node.js 18 或以上,运行
node -v确认 - • 权限报错:macOS/Linux 可能需要 sudo,或配置 npm 全局目录
三、最重要的命令:openclaw onboard
openclaw onboard 是你使用 OpenClaw 的第一条命令,也是最重要的命令。它会引导你完成:
Q:onboard 过程中卡住了怎么办?
onboard 过程需要联网访问 Anthropic/OpenAI 服务器验证 API Key。如果卡在验证步骤,99% 是网络问题——国内直连这些海外服务器延迟极高。建议先开好网络加速再执行 onboard。
Q:onboard 能重新做吗?
可以。重新执行 openclaw onboard 即可重新配置。它不会删除你的历史记忆和 Skills,只会更新基础配置。
四、日常运行命令详解
openclaw start
启动助手
启动 OpenClaw 主进程,开始监听来自聊天平台的消息。这是每次使用前必须执行的命令。
💡 技巧:可以用 nohup openclaw start & 让它在后台持续运行,关闭终端窗口也不会停止。
openclaw stop
停止助手
优雅地停止 OpenClaw 进程,会先完成当前正在处理的任务再退出,防止数据丢失。
openclaw restart
重启助手
重启进程。修改配置或安装新 Skill 后,需要执行此命令让改动生效。等同于 stop + start 的组合。
openclaw status
查看状态
查看 OpenClaw 当前运行状态,包括:进程是否在跑、已连接的平台、已加载的 Skills 数量、最近的活动日志。
openclaw logs
查看日志
实时查看运行日志,方便排查问题。
openclaw update
更新版本
检查并更新到最新版本。OpenClaw 更新非常频繁(有时一天多次),建议定期执行。
五、配置与管理命令
openclaw config
配置管理
查看和修改 OpenClaw 的核心配置。
openclaw memory
记忆管理
管理 AI 助手的持久记忆系统。
openclaw skills
技能管理
管理已安装的 Skills(扩展功能)。
六、调试与诊断命令
openclaw diagnose
自动诊断常见问题:检查 Node.js 版本、网络连通性、API Key 有效性、平台 Token 状态等。出问题先跑这个命令。
openclaw ping
测试 AI 服务器连通性。如果 ping 很慢(>500ms)或失败,说明需要优化网络连接。
openclaw debug
以调试模式运行,输出详细日志。排查 Skill 不执行、命令无响应等问题时非常有用。
openclaw test
向 AI 发送测试消息,验证整个通讯链路是否正常,包括 Bot Token、Webhook、AI 响应全流程。
七、新手最常问的10个问题
Q1:输入命令提示 "command not found: openclaw"?
npm 全局安装路径未加入 PATH。运行 npm config get prefix 查看路径,然后将 /bin 加入系统 PATH 环境变量。或者直接用 npx:npx openclaw onboard。
Q2:openclaw start 之后没有任何输出?
正常现象,表示已在后台运行并等待消息。可以去你配置的聊天平台(如 Telegram)发一条消息测试,或用 openclaw status 确认进程状态。
Q3:如何让 OpenClaw 开机自动启动?
macOS 可用 launchd,Linux 可用 systemd。或者在 shell 配置文件(.zshrc/.bashrc)末尾加一行:openclaw start &,但更推荐官方的 PM2 方式:pm2 start "openclaw start" --name openclaw。
Q4:版本更新后原来的配置会丢失吗?
不会。OpenClaw 把所有配置和记忆存在 ~/.openclaw/ 目录下,更新只替换程序文件,不影响数据。建议定期备份此目录。
Q5:如何完全卸载 OpenClaw?
npm 安装的用 npm uninstall -g openclaw,再删除 ~/.openclaw/ 目录即可彻底清除。
七、2026年新增命令:OpenClaw最新功能速览
OpenClaw 更新极其频繁,2026年以来已新增多项重要命令功能,以下是最值得关注的新特性:
🆕 openclaw export / import(数据迁移)
将配置、记忆、Skills 全部打包,一条命令完成跨设备迁移。
🆕 openclaw companion(菜单栏伴侣)
不需要打开终端,从 macOS 菜单栏直接控制 OpenClaw 的启停和状态查看。
🆕 openclaw agent(多Agent模式)
创建多个有不同专长的 AI 助手实例,按需切换,实现更精细化的任务分工。
八、进阶命令技巧与最佳实践
💡 技巧1:用 PM2 守护 OpenClaw 进程
PM2 是 Node.js 进程管理器,能确保 OpenClaw 崩溃后自动重启,并随系统开机自启。
💡 技巧2:命令行快捷别名
在 ~/.zshrc 中添加别名,减少重复输入:
添加后执行 source ~/.zshrc 生效,之后输入 ocs 就等于 openclaw status。
💡 技巧3:多实例运行
同一台机器可以运行多个 OpenClaw 实例,每个使用不同配置目录:
💡 技巧4:通过命令行直接发消息给 AI
不需要打开聊天软件,直接在终端给 AI 发消息:
适合在脚本中调用 OpenClaw,实现命令行自动化。
新手上路建议:推荐的学习路径
npm i -g openclaw,安装全局命令
openclaw onboard,完成初始化向导
openclaw start,启动并在聊天软件里测试
九、OpenClaw 命令速查总表
| 命令 | 说明 | 使用频率 |
|---|---|---|
| openclaw onboard | 初始化配置向导 | 一次性 |
| openclaw start | 启动助手 | ⭐⭐⭐ |
| openclaw stop | 停止助手 | ⭐⭐⭐ |
| openclaw restart | 重启助手 | ⭐⭐⭐ |
| openclaw status | 查看运行状态 | ⭐⭐ |
| openclaw logs -f | 实时日志 | ⭐⭐ |
| openclaw update | 更新版本 | ⭐⭐ |
| openclaw config list | 列出所有配置 | ⭐ |
| openclaw skills list | 列出所有技能 | ⭐⭐ |
| openclaw skills install | 安装技能 | ⭐⭐ |
| openclaw memory list | 查看记忆 | ⭐ |
| openclaw diagnose | 自动诊断问题 | ⭐ |
| openclaw ping | 测试网络延迟 | ⭐ |
相关文章推荐
OpenClaw 所有命令都需要访问海外 AI 服务器。没有稳定网络,onboard 超时、API 响应慢、Skill 执行卡顿都是家常便饭。VPN07 提供 1000Mbps 千兆带宽,运营十年,专为 AI 工具用户优化节点路由,让每条 OpenClaw 命令都秒速响应。