乐于分享
好东西不私藏

【2026 OPC计划】OpenClaw常用命令大全

【2026 OPC计划】OpenClaw常用命令大全

根据官方文档和多个技术社区的实践,OpenClaw的命令体系可以分为终端CLI命令聊天斜杠命令两大类。以下是从专业角度整理的常用命令速查手册。

一、终端CLI命令

终端CLI命令直接在操作系统的Shell中执行,格式为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 set bailian/qwen3-max-2026-01-23
openclaw models set minimax/MiniMax-M2.1

5. Gateway服务控制

命令
说明
openclaw gateway start
启动网关
openclaw gateway start --port 18789
指定端口启动
openclaw gateway start -d
以守护进程模式后台启动
openclaw gateway stop
停止网关
openclaw gateway restart
重启网关
openclaw gateway status
查看网关状态
openclaw gateway logs
查看网关日志

6. 技能管理

技能管理工具clawhub

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

7. 通道管理

命令
说明
openclaw channels status
查看所有通道状态
openclaw channels list
列出已配置通道
openclaw channels add --channel telegram --token <TOKEN>
添加Telegram通道
openclaw channels remove --channel <名称>
移除通道
openclaw channels logs
查看通道日志

8. 配置管理

命令
说明
openclaw config get
查看完整配置
openclaw config get models.default
查看特定配置项
openclaw config set models.default gpt-4
设置默认模型
openclaw config set providers.deepseek.apiKey "你的API-Key"
配置API Key
openclaw config edit
编辑配置文件
openclaw config path
显示配置文件路径
openclaw agents add XXXX
增加子Agent

二、聊天斜杠命令

斜杠命令在Web控制台、飞书、Telegram等聊天界面中使用,所有平台通用。

1. 会话管理

命令
说明
重要度
/new
新建会话(清空上下文),大幅节省Token成本
⭐⭐⭐⭐⭐
/new 任务描述
新建会话并附带任务
⭐⭐⭐⭐⭐
/compact
压缩上下文(保留摘要,节省Token)
⭐⭐⭐⭐
/status
查看会话状态(模型、Token用量)
⭐⭐⭐⭐⭐
/help

 或 /commands
查看所有斜杠命令
⭐⭐⭐⭐

2. 模型切换

命令
说明
/model
查看当前模型
/model list
查看可用模型列表
/model <模型名>
切换模型(如/model haiku
/model status
查看当前模型详情

模型别名简写/model haiku → claude-haiku-4-5

3. Token与成本监控

命令
说明
/usage full
显示完整用量详情(输入/输出Token)
/usage cost
查看成本统计
/usage off
关闭用量显示
/context detail
查看每个文件/工具的Token占用
/cost
查看Token消耗与费用

4. 权限与执行控制

命令
说明
/exec host=sandbox security=allowlist
设置沙箱执行+白名单模式
/exec ask=always
每次执行命令都询问
/approve <id> allow-once
允许当前操作一次
/approve <id> allow-always
永久允许该类操作
/elevated on
启用提升权限模式(减少询问)

5. 会话历史与子任务

命令
说明
/sessions list
列出所有会话
/sessions history
查看历史记录
/sessions spawn <任务>
创建子会话执行任务
/subagents list
列出所有子代理
/subagents stop <id>
停止指定子代理

三、核心文件路径

路径
说明
~/.openclaw/openclaw.json
主配置文件
~/.openclaw/workspace/
默认工作区
~/.openclaw/skills/
全局技能目录
~/.openclaw/agents/<ID>/USER.md
用户偏好
~/.openclaw/agents/<ID>/memory/
记忆存储
~/.openclaw/workspace/AGENTS.md
核心提示词
~/.openclaw/workspace/SOUL.md
Agent身份、人格、规则

四、标准急救流程

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

  1. 1. openclaw doctor – 全面健康检查
  2. 2. openclaw logs – 查看错误日志
  3. 3. openclaw status – 确认服务状态
  4. 4. openclaw restart – 重启服务
  5. 5. openclaw doctor --fix – 尝试自动修复

配置修改固定流程:编辑配置文件 → 保存 → 执行openclaw restart

以上命令体系覆盖了OpenClaw从安装、配置、日常使用到故障排查的全流程,可根据实际需求选择使用。