OpenClaw命令速查手册表格版:核心命令榜单
摘要
刚上手 OpenClaw,命令行那一串串指令是不是有点眼花?别急,这份手册把终端 CLI 命令、聊
刚上手 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. 模型管理
想换模型?用 models 系列命令搞定:
| 命令 | 说明 |
|---|---|
openclaw models list | 列出已配置模型 |
openclaw models set <提供商/模型名> | 切换默认模型 |
openclaw models auth login --provider <提供商> | OAuth 登录模型提供商 |
openclaw models auth paste-token --provider <提供商> | 粘贴 API Token 认证 |
切换示例
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 启动 |
6. 聊天通道(Channel)管理
目前支持的通道包括:whatsapp、telegram、discord、slack、googlechat、signal、imessage、msteams、mattermost,以及需要插件支持的飞书。通道相关命令:
| 命令 | 说明 |
|---|---|
openclaw channels status | 查看所有通道状态 |
openclaw channels list | 列出已配置通道 |
openclaw channels add | 交互式添加通道 |
openclaw channels add --channel telegram --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 | 检查插件错误 |
常用示例
openclaw plugins enable feishu openclaw plugins enable qwen-portal-auth openclaw models auth login --provider qwen-portal --set-default
8. 技能(Skill)管理
技能可以通过命令行安装,也能从 ClawHub 商店搜索获取:
| 命令 | 说明 |
|---|---|
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 | 打开网页 |
openclaw browser snapshot | 页面快照 |
openclaw browser click <元素> | 点击页面元素 |
openclaw browser type <元素> <文字> | 输入框填写内容 |
openclaw browser screenshot | 截图 |
openclaw browser close | 关闭浏览器 |
openclaw browser console | 查看浏览器控制台 |
12. 配置文件操作
查看和编辑配置,两种方式任选:
| 命令 | 说明 |
|---|---|
openclaw config | 查看当前配置 |
openclaw config edit | 编辑配置文件 |
手动编辑配置
# 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/:用户偏好/USER.md ~/.openclaw/agents/:记忆存储/memory/ ~/.openclaw/agents/:定时任务/cron/jobs.json ~/.openclaw/agents/:会话记录/sessions/ ~/.openclaw/workspace/AGENTS.md:核心提示词
四、新手标准急救流程
遇到异常按这个顺序来,不用盲目乱试:
openclaw doctoropenclaw logsopenclaw statusopenclaw restartopenclaw doctor --fix
配置修改固定流程:编辑 ~/.openclaw/openclaw.json → 保存 → 执行 openclaw restart
完全重置配置:openclaw configure
来源:互联网
本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。