初始化与配置命令

这类命令用于首次安装和配置 OpenClaw。

  • openclaw setup：初始化配置和工作区，首次安装后必须运行
  • openclaw onboard：交互式引导向导，帮助配置 Gateway、工作区、技能等
  • openclaw configure：交互式配置向导，用于配置模型、渠道、技能、Gateway
  • openclaw config get/set/unset：非交互式读取、设置或删除配置项
  • openclaw config validate：验证配置文件格式是否正确
  • openclaw config file：显示当前配置文件路径

健康检查与修复命令

这类命令用于检查和修复配置问题。

  • openclaw doctor：交互式健康检查，遇到修复步骤会询问确认
  • openclaw doctor --fix：自动应用推荐修复，备份配置并清除废弃字段
  • openclaw doctor --repair --force：激进修复，会覆盖自定义的系统服务配置
  • openclaw doctor --non-interactive：只应用安全迁移，跳过需要人工确认的操作
  • openclaw doctor --deep：额外扫描系统服务，检查多余的 Gateway 实例

状态与诊断命令

这类命令用于查看系统状态和诊断问题。

  • openclaw status：综合诊断，显示 Gateway 可达性、渠道状态、会话概览
  • openclaw status --all：完整诊断报告，可粘贴分享，适合调试
  • openclaw status --deep：深度探测各渠道的实时连接状态
  • openclaw status --usage：显示各模型提供商的 API 配额用量
  • openclaw health：从运行中的 Gateway 获取健康状态
  • openclaw logs [--follow]：实时查看 Gateway 日志

渠道管理命令

这类命令用于管理聊天平台的连接和认证。

  • openclaw channels list：显示已配置的渠道和认证概况
  • openclaw channels status [--probe]：检查渠道连接健康状况
  • openclaw channels add：添加新渠道，支持引导向导或非交互模式
  • openclaw channels remove：禁用或删除渠道配置
  • openclaw channels login：登录渠道，如 WhatsApp Web 扫码
  • openclaw channels logout：登出渠道会话
  • openclaw channels logs：查看渠道相关日志

会话管理命令

这类命令用于管理对话会话。

  • openclaw sessions：列出所有已存储的对话会话
  • openclaw sessions --active 120：列出最近 120 分钟内活跃的会话
  • openclaw sessions --json：以 JSON 格式导出会话
  • openclaw sessions cleanup：清理旧会话文件，根据维护策略执行

智能体管理命令

这类命令用于管理独立智能体。

  • openclaw agent --message <文本>：通过 Gateway 运行一次智能体对话
  • openclaw agents list：列出已配置的智能体
  • openclaw agents add [名称]：添加新的独立智能体，包含工作区、认证、路由
  • openclaw agents delete <id>：删除智能体及其工作区和状态
  • openclaw agents bind/unbind：管理智能体的渠道路由绑定

模型管理命令

这类命令用于管理 AI 模型配置和认证。

  • openclaw models：查看当前模型状态和认证概况，等同于 models status
  • openclaw models list：列出可用模型
  • openclaw models status [--probe]：显示模型状态和认证详情，--probe 进行实时探测
  • openclaw models set <模型>：设置默认使用的 AI 模型
  • openclaw models set-image <模型>：设置默认图像模型
  • openclaw models aliases list/add/remove：管理模型别名
  • openclaw models fallbacks list/add/remove/clear：管理模型回退列表
  • openclaw models scan：扫描并探测可用模型
  • openclaw models auth add/setup-token/paste-token：添加或配置模型认证

Gateway 服务管理命令

这类命令用于管理 WebSocket Gateway 服务。

  • openclaw gateway：启动 WebSocket Gateway，前台运行
  • openclaw gateway install：安装为系统服务，支持 launchd、systemd、schtasks
  • openclaw gateway start/stop/restart：启动、停止或重启 Gateway 服务
  • openclaw gateway status：查看 Gateway 服务状态
  • openclaw gateway probe：探测 Gateway 可达性
  • openclaw gateway call <方法>：直接调用 Gateway RPC 接口
  • openclaw gateway discover：发现局域网内的 Gateway 实例

记忆管理命令

这类命令用于管理向量索引和记忆文件。

  • openclaw memory status：查看向量索引统计信息
  • openclaw memory index：重新索引 MEMORY.md 等记忆文件
  • openclaw memory search "<查询>"：对记忆文件进行语义搜索

技能管理命令

这类命令用于管理已安装的技能。

  • openclaw skills list：列出所有可用技能及就绪状态
  • openclaw skills info <名称>：查看某个技能的详细信息
  • openclaw skills check：显示就绪和缺失依赖的技能汇总

插件管理命令

这类命令用于管理 OpenClaw 插件。

  • openclaw plugins list：列出已安装插件
  • openclaw plugins install <路径>：安装插件
  • openclaw plugins enable/disable <id>：启用或禁用插件
  • openclaw plugins doctor：检查插件加载错误

安全与密钥命令

这类命令用于管理安全配置和密钥。

  • openclaw security audit：审查配置中的安全隐患
  • openclaw security audit --fix：自动修复安全默认设置
  • openclaw secrets reload：重新加载密钥引用（SecretRef）
  • openclaw secrets audit：扫描明文密钥残留和未解析引用
  • openclaw secrets configure：交互式密钥配置向导

定时任务命令

这类命令用于管理定时任务（Cron）。

  • openclaw cron list：列出定时任务
  • openclaw cron add：添加定时任务，支持 --at、--every、--cron 参数
  • openclaw cron edit/rm/enable/disable：编辑、删除、启用或禁用定时任务
  • openclaw cron run <id>：立即触发指定定时任务

浏览器控制命令

这类命令用于控制内置 Chromium 浏览器。

  • openclaw browser status/start/stop：管理内置 Chromium 浏览器实例
  • openclaw browser screenshot：截图当前页面
  • openclaw browser navigate <URL>：导航到指定网址
  • openclaw browser click/type/press/hover：模拟浏览器交互操作
  • openclaw browser snapshot：获取页面无障碍树快照，供 AI 感知使用
  • openclaw browser pdf：将当前页面保存为 PDF

系统与调度命令

这类命令用于系统级操作和事件管理。

  • openclaw system event --text <文本>：向 Gateway 发送系统事件
  • openclaw system heartbeat last/enable/disable：管理心跳检测
  • openclaw system presence：列出系统 Presence 条目

其他实用命令

这类命令提供各种实用功能。

  • openclaw tui：打开终端 UI，连接 Gateway，支持聊天交互
  • openclaw update：更新 OpenClaw 到最新版本
  • openclaw reset：重置本地配置和状态，保留 CLI
  • openclaw uninstall：卸载 Gateway 服务和本地数据
  • openclaw message send/poll/edit/delete/...：统一的出站消息发送和渠道操作
  • openclaw pairing list/approve：审批 DM 配对请求
  • openclaw docs <查询>：搜索在线文档索引
  • openclaw qr：显示 QR 码，用于设备配对
  • openclaw nodes status/list/approve/...：管理配对的远程 Node 节点
  • openclaw acp：启动 ACP 桥接，连接 IDE 到 Gateway

使用技巧

  • JSON 输出：所有 CLI 命令支持 --json 参数输出机器可读格式
  • 开发模式：全局 --dev 参数可将状态隔离到 ~/.openclaw-dev，适合开发测试
  • 多配置管理：使用 --profile <名称> 可管理多套独立配置
  • 命令补全：大多数 Shell 支持 Tab 键补全命令和参数
  • 帮助信息：任何命令后加 --help 或 -h 可查看详细帮助

参考资料