[智能体-625]:OpenClaw(小龙虾)完整命令清单

[智能体-625]:OpenClaw(小龙虾)完整命令清单

分为 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 tuiopenclaw 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一键修复。