附录F：命令速查手册

本附录汇总 OpenClaw 的终端 CLI 命令与聊天斜杠命令，供日常操作时快速查阅。命令参数可能随版本演进，建议以 openclaw <命令> --help 的实际输出为准。

F.1 基础操作与服务管理

命令	说明	关联章节
openclaw --version	查看当前版本号	2.1
openclaw --help	查看所有可用命令与用法	—
openclaw tui	打开终端交互对话界面	2.3
openclaw dashboard	打开网页控制台（Dashboard）	3.1
openclaw restart	重启服务（改完配置后必须执行）	4.1
openclaw stop	停止服务	—
openclaw update	更新到最新版本	2.2
openclaw update --channel stable	切换到稳定版通道并更新	2.2
openclaw update --channel beta	切换到测试版通道并更新	2.2

F.2 安装、初始化与配置

命令	说明	关联章节
openclaw onboard	启动交互式配置向导	2.3
openclaw onboard --install-daemon	配置向导 + 安装为系统后台服务	2.3
openclaw configure	重新进入配置向导（可随时修改设置）	2.3
openclaw config	查看当前生效配置	4.1
openclaw config edit	在编辑器中打开配置文件	4.1

F.3 诊断与排障

命令	说明	关联章节
openclaw doctor	全面健康检查（配置、端口、依赖）	3.2
openclaw doctor --fix	健康检查 + 尝试自动修复	3.2
openclaw health --json	健康探针（适合自动化）	3.2
openclaw status	查看运行状态（Gateway 是否在线、端口等）	3.2
openclaw status --deep	详细状态（含网关健康探测）	3.2
openclaw logs	查看最近日志	3.2
openclaw logs --follow --json	实时跟踪结构化日志	3.2

遇到问题时的推荐排查顺序：doctor → logs → status → restart → doctor --fix。详见附录C。

F.4 模型管理

命令	说明	关联章节
openclaw models list	列出所有已配置的模型	4.3
openclaw models set <供应商/模型名>	切换默认模型	4.3
openclaw models status --check	模型接口连通性验证	4.2
openclaw models auth login --provider <供应商>	以 OAuth 方式登录模型供应商	4.2
openclaw models auth paste-token --provider <供应商>	粘贴 API Token 认证	4.2

F.5 渠道管理

命令	说明	关联章节
openclaw channels list	列出已配置的渠道	7.2
openclaw channels status	查看所有渠道状态	3.2
openclaw channels status --probe	渠道状态与探针	3.2
openclaw channels add	添加新渠道（交互式向导）	7.1
openclaw channels add --channel telegram --token <TOKEN>	非交互式添加 Telegram 渠道	7.1
openclaw channels add --channel feishu	添加飞书渠道	7.3
openclaw channels remove --channel <名称>	移除渠道	7.2
openclaw channels logs	查看渠道日志	3.2
openclaw channels login	登录渠道（如 WhatsApp Web）	7.1
openclaw channels logout	登出渠道	7.1

支持的渠道类型：whatsapp、telegram、discord、slack、googlechat、signal、imessage、msteams、mattermost、feishu（需插件）。

F.6 插件与技能

插件管理

命令	说明	关联章节
openclaw plugins list	列出所有插件	12.1
openclaw plugins install <插件名>	安装插件	12.1
openclaw plugins enable <插件名>	启用插件	12.1
openclaw plugins disable <插件名>	禁用插件	12.1
openclaw plugins doctor	检查插件加载错误	12.1

技能管理

命令	说明	关联章节
openclaw skills list	列出已安装的技能	5.3
openclaw skills install <技能名>	安装技能	5.3

F.7 网关管理

命令	说明	关联章节
openclaw gateway	启动网关	9.1
openclaw gateway --port <端口>	指定端口启动	9.1
openclaw gateway --verbose	启动并显示详细日志	9.1
openclaw gateway restart	重启网关	9.1
openclaw gateway --token <token>	带 token 启动	9.2

F.8 沙箱与浏览器

沙箱管理

命令	说明	关联章节
openclaw sandbox explain	查看当前沙箱配置状态	11.4
openclaw sandbox explain --json	JSON 格式查看沙箱配置	11.4
openclaw sandbox list	列出所有沙箱容器	11.4
openclaw sandbox list --browser	只列出浏览器容器	11.4
openclaw sandbox recreate --all	重建所有容器	11.4
openclaw sandbox recreate --all --force	强制重建（跳过确认）	11.4

浏览器控制

命令	说明	关联章节
openclaw browser open <URL>	打开网页	5.4
openclaw browser snapshot	截取当前页面快照	5.4
openclaw browser screenshot	截图	5.4
openclaw browser click <元素>	点击页面元素	5.4
openclaw browser type <元素> <文字>	在输入框中输入文字	5.4
openclaw browser close	关闭浏览器	5.4
openclaw browser console	查看浏览器控制台日志	5.4

F.9 消息与配对

命令	说明	关联章节
openclaw message send --to <号码> --message "内容"	发送消息	7.1
openclaw agent --message “任务内容”	直接给 Agent 发任务	7.4
openclaw agent --message “任务” --thinking high	发任务（高思考深度）	7.4
openclaw pairing approve <渠道> <配对码>	批准设备配对	9.4

F.10 聊天斜杠命令

以下命令在 OpenClaw 的聊天窗口中使用（WebChat、飞书、Telegram 等通用）。

会话管理

命令	说明	关联章节
/new	开始新会话（清除上下文）	6.1
/new <任务描述>	开始新会话并附带任务	6.1
/compact	压缩当前上下文（保留要点，减少 Token）	6.4
/status	查看当前会话状态（Token 用量、模型等）	6.1
/help 或 /commands	查看所有可用斜杠命令	—

模型切换

命令	说明	关联章节
/model	查看当前使用的模型	4.3
/model <模型名>	切换到指定模型	4.3

会话历史

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

工具与执行控制

命令	说明	关联章节
/approve	批准待确认的操作	5.2
/deny	拒绝待确认的操作	5.2
/cancel	取消当前正在执行的任务	—
/undo	撤销上一步操作	—

技能与记忆

命令	说明	关联章节
/skills	查看已加载的技能	5.3
/memory	查看记忆内容	6.3
/forget <内容>	删除指定记忆	6.3

信息查询

命令	说明	关联章节
/cost	查看 Token 消耗与费用估算	6.2
/version	查看版本信息	—
/ping	测试连接是否正常	—

F.11 关键文件路径速查

路径	说明	关联章节
~/.openclaw/openclaw.json	主配置文件	4.1
~/.openclaw/workspace/	默认工作区	2.3
~/.openclaw/workspace/AGENTS.md	核心提示词	3.3
~/.openclaw/skills/	全局技能目录	5.3
~/.openclaw/agents/	Agent 数据目录	—
~/.openclaw/agents/<ID>/USER.md	用户偏好文件	3.3
~/.openclaw/agents/<ID>/memory/	记忆存储	6.3
~/.openclaw/agents/<ID>/cron/jobs.json	定时任务配置	8.2
~/.openclaw/agents/<ID>/sessions/	会话记录	6.1

Windows 用户注意：~ 等于 %USERPROFILE%，即 C:\Users\<你的用户名>。