OpenClaw 命令速查手册

还在为记不住 OpenClaw 命令烦恼?这份CLI 命令 + 聊天斜杠命令 + 关键路径 + 急救流程一站式手册,帮你快速上手、高效排错,轻松驾驭全功能。


一、终端 CLI 命令

格式:openclaw <命令>

1. 基础操作(高频必备)

命令 说明 使用场景
openclaw --version 查看版本号 验证安装是否成功
openclaw --help 查看全部命令 忘记指令时查询
openclaw tui 终端对话界面 新手快速聊天
openclaw dashboard 网页控制台 浏览器可视化管理
openclaw restart 重启服务 修改配置后必执行
openclaw stop 停止服务 临时暂停程序
openclaw update 更新至最新版 版本升级

2. 安装与初始化

命令 说明
openclaw onboard 启动交互式配置向导
openclaw onboard --install-daemon 配置 + 安装系统后台服务(开机自启)
openclaw configure 重新进入配置向导

3. 诊断与排错

命令 说明 使用场景
openclaw doctor 全面健康检查(配置、端口、依赖) 出现问题首选命令
openclaw doctor --fix 健康检查 + 自动修复 尝试自动解决故障
openclaw status 查看运行状态(网关、端口) 确认服务是否正常
openclaw status --deep 深度状态检测 进阶问题排查
openclaw logs 查看最近日志 定位错误信息

4. 模型管理

命令 说明
openclaw models list 列出已配置模型
openclaw models set <提供商/模型名> 切换默认模型
openclaw models auth login --provider <提供商> OAuth 登录模型提供商
openclaw models auth paste-token --provider <提供商> 粘贴 API Token 认证

切换示例

bash 复制代码
openclaw models set bailian/qwen3-max-2026-01-23
openclaw models set minimax/MiniMax-M2.1

5. 网关(Gateway)管理

命令 说明
openclaw gateway 启动网关
openclaw gateway --port 18789 指定端口启动
openclaw gateway --verbose 启动并输出详细日志
openclaw gateway restart 重启网关
openclaw gateway --token <token> 带 Token 启动

6. 聊天通道(Channel)管理

支持通道:whatsapp、telegram、discord、slack、googlechat、signal、imessage、msteams、mattermost、feishu(需插件)

命令 说明
openclaw channels status 查看所有通道状态
openclaw channels list 列出已配置通道
openclaw channels add 交互式添加通道
openclaw channels add --channel telegram --token <TOKEN> 非交互式添加 Telegram
openclaw channels add --channel feishu 添加飞书通道
openclaw channels remove --channel <名称> 移除通道
openclaw channels logs 查看通道日志
openclaw channels login 登录通道
openclaw channels logout 登出通道

7. 插件(Plugin)管理

命令 说明
openclaw plugins list 列出插件
openclaw plugins enable <插件名> 启用插件
openclaw plugins disable <插件名> 禁用插件
openclaw plugins install <插件名> 安装插件
openclaw plugins doctor 检查插件错误

常用示例

bash 复制代码
openclaw plugins enable feishu
openclaw plugins enable qwen-portal-auth
openclaw models auth login --provider qwen-portal --set-default

8. 技能(Skill)管理

命令 说明
openclaw skills list 列出已安装技能
openclaw skills install <技能名> 安装技能

ClawHub 技能商店

命令 说明
clawhub search <关键词> 搜索技能
clawhub install <技能名> 安装技能
clawhub list 查看已安装技能
clawhub sync --all 更新所有技能
clawhub update <技能名> 更新指定技能

9. 消息与配对

命令 说明
openclaw message send --to <号码> --message "内容" 发送消息
openclaw agent --message "任务内容" 下发 Agent 任务
openclaw agent --message "任务" --thinking high 高思考深度任务
openclaw pairing approve <通道> <配对码> 批准设备配对

10. 沙箱(Sandbox)管理

命令 说明
openclaw sandbox explain 查看沙箱配置
openclaw sandbox explain --json JSON 格式查看配置
openclaw sandbox list 列出沙箱容器
openclaw sandbox list --browser 仅查看浏览器容器
openclaw sandbox recreate --all 重建所有容器
openclaw sandbox recreate --all --force 强制重建(无确认)

11. 浏览器控制

命令 说明
openclaw browser open <URL> 打开网页
openclaw browser snapshot 页面快照
openclaw browser click <元素> 点击页面元素
openclaw browser type <元素> <文字> 输入框填写内容
openclaw browser screenshot 截图
openclaw browser close 关闭浏览器
openclaw browser console 查看浏览器控制台

12. 配置文件操作

命令 说明
openclaw config 查看当前配置
openclaw config edit 编辑配置文件

手动编辑配置

bash 复制代码
# Windows
notepad %USERPROFILE%\.openclaw\openclaw.json

# macOS / Linux
nano ~/.openclaw/openclaw.json
cat ~/.openclaw/openclaw.json

13. 更新与维护

命令 说明
openclaw update 更新至稳定版
openclaw update --channel stable 切换稳定版通道
openclaw update --channel beta 切换测试版通道
npm install -g openclaw@latest npm 强制更新

二、聊天斜杠命令(Web/飞书/Telegram 通用)

1. 会话管理

命令 说明 重要度
/new 新建会话(清空上下文) 最高
/new 任务描述 新建会话并附带任务 最高
/compact 压缩上下文(节省 Token) 最高
/status 查看会话状态(模型、Token) 常用
/help / /commands 查看斜杠命令 常用

2. 模型切换

命令 说明
/model 查看当前模型
/model <模型名> 切换模型

3. 会话历史

命令 说明
/sessions list 列出所有会话
/sessions history 查看历史记录
/sessions send <会话ID> <消息> 向指定会话发消息
/sessions spawn <任务> 创建子会话执行任务

4. 工具与执行

命令 说明
/approve 批准待确认操作
/deny 拒绝待确认操作
/cancel 取消当前任务
/undo 撤销上一步

5. 技能与记忆

命令 说明
/skills 查看已加载技能
/memory 查看记忆内容
/forget <内容> 删除指定记忆

6. 信息查询

命令 说明
/cost 查看 Token 消耗与费用
/version 查看版本
/ping 测试连接

三、关键文件路径速查

~ 在 Windows 下为 %USERPROFILE%

  • ~/.openclaw/openclaw.json:主配置文件
  • ~/.openclaw/workspace/:默认工作区
  • ~/.openclaw/skills/:全局技能目录
  • ~/.openclaw/agents/:Agent 数据目录
  • ~/.openclaw/agents/<ID>/USER.md:用户偏好
  • ~/.openclaw/agents/<ID>/memory/:记忆存储
  • ~/.openclaw/agents/<ID>/cron/jobs.json:定时任务
  • ~/.openclaw/agents/<ID>/sessions/:会话记录
  • ~/.openclaw/workspace/AGENTS.md:核心提示词

四、新手标准急救流程

遇到异常,按以下顺序执行:

  1. openclaw doctor
  2. openclaw logs
  3. openclaw status
  4. openclaw restart
  5. openclaw doctor --fix

配置修改固定流程

编辑 ~/.openclaw/openclaw.json → 保存 → 执行 openclaw restart

完全重置配置
openclaw configure


用好工具,效率翻倍。这份 OpenClaw 完整命令手册,覆盖安装、运行、管理、排错全流程,无论是日常使用还是故障处理,都能快速定位指令、解决问题,让 AI 工具真正为你所用。