分为 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.mdbash运行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、子 AgentSub‑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、备份 workspacebash运行openclaw backup --dir ~/openclaw-backup #备份配置、workspace、记忆文件 openclaw reset #重置配置不会删除workspace业务文件七、WSL 与 VMware 环境使用区别结合你之前部署场景WSL开发调试日常命令openclaw tui、openclaw gateway run --verbose前台调试Windows 通过\\wsl$修改六份 MD 文件执行openclaw gateway restart重载配置WSL 休眠会终止 Gateway 进程无法长期后台运行。VMware‑Ubuntu正式上线、商业交付执行openclaw gateway install注册 systemd 服务实现开机自启、7×24 小时常驻对接飞书机器人长期运行。八、极简实操流程固定工作流Windows 修改 workspace 下 IDENTITY.md、AGENTS.mdWSL 终端执行openclaw gateway restart重载配置openclaw tui进入聊天界面用斜杠命令测试 Agent 运行报错执行openclaw doctor --fix一键修复。