VPN07

OpenClaw 2026命令大全:新手必看保姆级基础使用教程

2026-02-19 阅读约12分钟 AI工具教程 命令教程

本文说明:OpenClaw 是2026年最火的开源个人AI助手,通过命令行驱动,连接Telegram/WhatsApp/Discord,让AI真正替你打工。本文系统整理全部基础命令,附逐条解释,零基础新手也能看懂。

一、OpenClaw命令体系概览

OpenClaw 的所有操作都通过 命令行(CLI) 驱动。安装完成后,你会获得一个全局命令 openclaw,通过它完成安装、初始化、运行、调试等所有任务。

安装命令
npm/curl 一键部署
🤖
运行命令
onboard / start / run
🔧
配置命令
Skills / Config / Debug

二、安装命令详解(3种方式)

方式1:一键安装(推荐新手)
curl -fsSL https://openclaw.ai/install.sh | bash

说明:自动安装 Node.js 和所有依赖,macOS/Linux/Windows 通用。执行后按提示操作即可,整个过程约2-5分钟。

方式2:npm 全局安装
npm i -g openclaw

说明:需已安装 Node.js 18+。安装完成后在任意终端输入 openclaw 即可使用。是大多数开发者的首选方式。

方式3:源码安装(适合开发者/可Hack版)
git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build
pnpm 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 的第一条命令,也是最重要的命令。它会引导你完成:

设置 AI 模型(Claude/GPT/本地模型)
配置 API Key
连接通讯平台(Telegram/WhatsApp 等)
创建你的 AI 助手人格和记忆

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 logs # 查看最近日志
openclaw logs -f # 实时跟踪日志(tail -f 效果)
openclaw logs --lines 100 # 查看最近100行
openclaw update 更新版本

检查并更新到最新版本。OpenClaw 更新非常频繁(有时一天多次),建议定期执行。

五、配置与管理命令

openclaw config 配置管理

查看和修改 OpenClaw 的核心配置。

openclaw config list # 列出所有配置项
openclaw config get model # 查看当前AI模型设置
openclaw config set model claude-3-5-sonnet # 切换模型
openclaw config set apiKey sk-xxx # 设置API Key
openclaw memory 记忆管理

管理 AI 助手的持久记忆系统。

openclaw memory list # 查看所有记忆
openclaw memory search "关键词" # 搜索记忆
openclaw memory delete <id> # 删除某条记忆
openclaw memory clear # 清空所有记忆(谨慎!)
openclaw skills 技能管理

管理已安装的 Skills(扩展功能)。

openclaw skills list # 列出所有已安装 Skills
openclaw skills install <name> # 安装 Skill
openclaw skills remove <name> # 删除 Skill
openclaw skills enable <name> # 启用 Skill
openclaw skills disable <name> # 禁用 Skill

六、调试与诊断命令

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(数据迁移)

openclaw export --output backup.zip # 导出所有数据
openclaw import --input backup.zip # 导入数据(换电脑时用)

将配置、记忆、Skills 全部打包,一条命令完成跨设备迁移。

🆕 openclaw companion(菜单栏伴侣)

openclaw companion start # 启动macOS菜单栏App(Beta)

不需要打开终端,从 macOS 菜单栏直接控制 OpenClaw 的启停和状态查看。

🆕 openclaw agent(多Agent模式)

openclaw agent create "研究助手" # 创建专职Agent
openclaw agent list # 列出所有Agent
openclaw agent switch "研究助手" # 切换到指定Agent

创建多个有不同专长的 AI 助手实例,按需切换,实现更精细化的任务分工。

八、进阶命令技巧与最佳实践

💡 技巧1:用 PM2 守护 OpenClaw 进程

PM2 是 Node.js 进程管理器,能确保 OpenClaw 崩溃后自动重启,并随系统开机自启。

npm i -g pm2 # 安装PM2
pm2 start "openclaw start" --name claw # 用PM2启动
pm2 save # 保存配置
pm2 startup # 设置开机自启
pm2 status # 查看状态
pm2 logs claw # 查看日志
pm2 restart claw # 重启

💡 技巧2:命令行快捷别名

~/.zshrc 中添加别名,减少重复输入:

alias oc='openclaw'
alias ocs='openclaw status'
alias ocl='openclaw logs -f'
alias ocr='openclaw restart'
alias ocsk='openclaw skills'

添加后执行 source ~/.zshrc 生效,之后输入 ocs 就等于 openclaw status

💡 技巧3:多实例运行

同一台机器可以运行多个 OpenClaw 实例,每个使用不同配置目录:

OPENCLAW_HOME=~/.openclaw-work openclaw start # 工作用助手
OPENCLAW_HOME=~/.openclaw-home openclaw start # 家用助手

💡 技巧4:通过命令行直接发消息给 AI

不需要打开聊天软件,直接在终端给 AI 发消息:

openclaw chat "今天的天气怎么样?" # 直接发消息
openclaw chat --json '{"msg":"你好"}' # JSON格式

适合在脚本中调用 OpenClaw,实现命令行自动化。

新手上路建议:推荐的学习路径

1 先保证网络畅通(推荐 VPN07),再开始安装
2 执行 npm i -g openclaw,安装全局命令
3 执行 openclaw onboard,完成初始化向导
4 执行 openclaw start,启动并在聊天软件里测试
5 安装几个热门 Skills,感受 OpenClaw 的真正威力

九、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命令必备
VPN07 — 让命令飞起来

OpenClaw 所有命令都需要访问海外 AI 服务器。没有稳定网络,onboard 超时、API 响应慢、Skill 执行卡顿都是家常便饭。VPN07 提供 1000Mbps 千兆带宽,运营十年,专为 AI 工具用户优化节点路由,让每条 OpenClaw 命令都秒速响应。

¥9/月
超低月费
1000Mbps
千兆带宽
70+国
全球节点
30天
无理由退款
月费¥9 · 运营十年
免费试用 VPN07