分为 5 大类：CLI 终端命令（Linux‑WSL/Shell 执行）、Gateway 网关服务命令、会话斜杠命令（TUI 聊天内）、Agent / 子智能体命令、运维备份命令，适配 WSL、VMware‑Ubuntu 两套部署环境，适配六份 MD 文件调试流程。

一、基础全局 CLI 命令（在 Ubuntu 终端执行）

命令	释义	实操场景
openclaw --version	查看 OpenClaw 版本	验证是否安装成功
openclaw --help	展示全部 CLI 命令	遗忘指令时查阅
openclaw onboard	交互式初始化向导	首次部署，配置 API 密钥、飞书通道、workspace 目录，--install‑daemon安装后台服务
openclaw setup	极简初始化	生成默认配置文件
openclaw configure	菜单式修改配置	调整模型、网关、通道参数，替代手动修改 json 配置
openclaw tui	打开终端交互式聊天界面	本地直接调试六份 MD 规则、测试工具调用
openclaw dashboard	启动网页控制面板后服务程序，通过Web访问	浏览器可视化管理 Agent、日志、会话
openclaw update	升级 OpenClaw 到最新版本	迭代更新小龙虾程序
openclaw doctor	系统健康诊断	排查权限、端口、模型、工具报错
openclaw doctor --fix	自动修复异常	一键修复权限缺失、目录缺失、WSL 权限错乱（高频）
openclaw status	整体运行状态查看	查看网关、通道、模型、Agent 状态
openclaw status --deep	深度模式诊断	排查隐藏配置错误、网络问题

二、Gateway 网关核心命令（最重要，OpenClaw 调度核心）

Gateway 负责 WebSocket 通信、Agent 调度、消息路由、工具调用，修改 IDENTITY.md、AGENTS.md、MEMORY.md 配置后必须重启网关生效。

bash

运行

#前台运行（调试模式，输出实时日志，开发阶段首选）
openclaw gateway run --verbose
#后台启动服务（正式常驻运行）
openclaw gateway start
#强制启动，杀掉占用端口进程
openclaw gateway start --force
#停止后台网关服务
openclaw gateway stop
#重启网关（修改MD配置后必执行）
openclaw gateway restart
#安装为systemd系统服务（7*24运行，VMware正式环境用）
openclaw gateway install
#卸载系统服务
openclaw gateway uninstall
#指定端口启动，默认19000
openclaw gateway run --port 19001
#网络绑定：仅本机访问/局域网访问
openclaw gateway --bind loopback
openclaw gateway --bind lan

三、日志 & 会话管理命令

1、日志排查命令（工具调用失败、Web‑Search、Web‑Fetch 报错优先查日志）

bash

运行

openclaw logs --follow      #实时滚动查看日志
openclaw logs --limit 200   #读取末尾200行日志
openclaw logs --json        #JSON结构化日志，用于问题分析

2、Sessions 会话命令（清理旧会话，防止上下文堆积、token 溢出）

bash

运行

openclaw sessions                     #列出全部会话
openclaw sessions --active 60         #仅展示60分钟内活跃会话
openclaw sessions cleanup --dry-run   #预览要清理的会话（不实际删除）
openclaw sessions cleanup --enforce   #强制清理过期会话，释放内存

四、Agent、子智能体 CLI 命令（主‑子 Agent 架构，对应 AGENTS.md）

bash

运行

openclaw agents list                   #查看所有主Agent
openclaw agents add mainagent --workspace ~/openclaw/workspace  #新建Agent，绑定workspace（六份MD目录）
openclaw agents reload                 #重载Agent配置，刷新MD文件规则

五、TUI 聊天窗口内的斜杠命令（进入 openclaw tui 后使用）

1、基础会话控制

表格

命令	功能
/new	新建会话，隔离上下文，避免旧对话干扰
/stop	终止当前正在执行的任务
/status	查看当前模型、token 用量、加载的 MD 配置、工具列表
/compact	压缩当前对话上下文，缩减 Token 占用
/context list	查看加载的 IDENTITY、AGENTS、MEMORY 等文件内容
/export‑session ./record.html	导出会话记录归档复盘
/model 模型名称	切换大模型
/elevated full	开启完整工具权限，可执行 Shell、Web‑Search‑Fetch、文件读写（必须开启才能调用工具）

2、子 Agent（Sub‑Agent）多任务命令（搭建虚拟数字团队）

plaintext

/subagents list                #查看运行的全部子智能体
/subagents spawn               #生成新子Agent，并行处理任务
/subagents info 【run‑id】     #查看单个子Agent运行详情
/subagents steer 【run‑id】 指令  #对正在运行的子Agent实时下发新指令
/subagents kill 【run‑id】      #终止指定子Agent
/subagents kill all            #批量关闭全部子Agent

六、备份、迁移命令（WSL 迁移 VMware、备份 workspace）

bash

运行

openclaw backup --dir ~/openclaw-backup   #备份配置、workspace、记忆文件
openclaw reset                            #重置配置（不会删除workspace业务文件）

七、WSL 与 VMware 环境使用区别（结合你之前部署场景）

1. WSL（开发调试）

• 日常命令：openclaw tui、openclaw gateway run --verbose前台调试；
• Windows 通过\\wsl$修改六份 MD 文件，执行openclaw gateway restart重载配置；
• WSL 休眠会终止 Gateway 进程，无法长期后台运行。

1. VMware‑Ubuntu（正式上线、商业交付）

• 执行openclaw gateway install注册 systemd 服务，实现开机自启、7×24 小时常驻，对接飞书机器人长期运行。

八、极简实操流程（固定工作流）

1. Windows 修改 workspace 下 IDENTITY.md、AGENTS.md；
2. WSL 终端执行：openclaw gateway restart重载配置；
3. openclaw tui进入聊天界面，用斜杠命令测试 Agent 运行；
4. 报错执行openclaw doctor --fix一键修复。