OpenClaw 超级速查表

为 OpenClaw 运维人员和开发者提供的完整参考，涵盖 150+ CLI 命令、频道配置、工作区文件、记忆系统、多代理路由等。

来源

基于 Molt Founders 的 OpenClaw Mega Cheatsheet。

快速上手

从 CLI 基础、全局标志到频道配对和模型认证，一站搞定首个 OpenClaw 代理的安装、配置和连接。

核心 CLI 命令

网关操作

openclaw gateway                        # 运行 WebSocket 网关服务器
openclaw gateway --port 8080 --bind 0.0.0.0 --token <tok>
openclaw gateway start | stop | restart # 通过 launchd/systemd 管理

频道管理

openclaw channels login                 # WhatsApp 二维码配对
openclaw channels add --channel <ch> --token <tok>  # 添加机器人
openclaw channels status --probe        # 检查频道连接状态

配置与设置

openclaw onboard                        # 交互式设置向导
openclaw onboard --install-daemon       # 设置 + 安装守护进程
openclaw doctor                         # 健康检查和快速修复
openclaw doctor --deep --yes            # 深度扫描并自动修复
openclaw config get <key>               # 读取配置（JSON5）
openclaw config set <key> <value>       # 写入配置
openclaw config unset <key>             # 删除配置项

模型管理

openclaw models list --all              # 查看所有可用模型
openclaw models set <model>             # 设置主模型
openclaw models set-image <model>       # 设置默认图像模型
openclaw models status --probe          # 实时探测认证配置
openclaw models auth setup-token        # 推荐的 Anthropic 认证方式
openclaw models auth add --provider <p> # 添加提供商 API 密钥
openclaw models fallbacks add <model>   # 添加故障转移模型
openclaw models fallbacks remove <model>
openclaw models aliases add <alias> <model>

记忆与搜索

openclaw memory status                  # 检查记忆系统状态
openclaw memory index --all             # 重新索引所有记忆文件
openclaw memory search "查询内容"        # 语义向量搜索

诊断

openclaw logs --follow                  # 实时查看网关日志（彩色）
openclaw logs --json                    # JSON 输出（每行一个事件）
openclaw logs --limit 200               # 限制日志行数
openclaw status --all --deep            # 全面诊断
openclaw sessions --json                # 列出会话

安全与高级

openclaw security audit                 # 审计配置安全漏洞
openclaw security audit --fix           # 自动修复问题
openclaw reset --scope <scope>          # 重置: config | credentials | sessions | full

全局标志

标志	说明
`--dev`	将状态隔离在 `~/.openclaw-dev` 下，端口偏移
`--profile <name>`	将状态隔离在 `~/.openclaw-<name>` 下
`--no-color`	禁用 ANSI 颜色（支持 `NO_COLOR=1`）
`--update`	`openclaw update` 的快捷方式（仅源码安装）
`-V, --version, -v`	打印版本并退出

频道配置

openclaw channels login
# 扫描终端中显示的二维码

# 先从 @BotFather 获取机器人令牌
openclaw channels add --channel telegram --token $TELEGRAM_BOT_TOKEN

# 在 Discord 开发者门户创建机器人
openclaw channels add --channel discord --token $DISCORD_BOT_TOKEN

# 配置 Slack App 并获取机器人令牌
openclaw channels add --channel slack

macOS 原生桥接 — 无需额外令牌。在 macOS 上自动启用。

Google Chat — 服务账号设置
Signal — 关联设备连接
MS Teams — 机器人注册

openclaw channels add --channel <platform> --token <token>
openclaw channels status --probe  # 验证连接

模型与认证

认证设置

设置认证令牌（推荐）

openclaw models auth setup-token   # 推荐的 Anthropic 认证方式

或添加提供商密钥

openclaw models auth add --provider openai
openclaw models auth add --provider anthropic

验证

openclaw models status --probe     # 实时探测配置的认证

模型配置

openclaw models list --all          # 查看可用模型
openclaw models set claude-sonnet   # 设置主模型
openclaw models set-image dall-e-3  # 设置图像模型
openclaw models fallbacks add gpt-4 # 添加故障转移
openclaw models aliases add fast claude-haiku  # 创建别名

故障转移时间表

模型故障转移间隔：1 分钟 → 5 分钟 → 1 小时

工作区与记忆

OpenClaw 通过 Markdown 工作区文件和混合向量/BM25 记忆系统来存储代理人格、用户偏好和长期知识。

工作区文件

所有工作区文件位于 ~/.openclaw/workspace/：

文件	用途
AGENTS.md	代理的操作指令
SOUL.md	人格、语气和边界
USER.md	用户信息和偏好
IDENTITY.md	代理名称、表情、主题
MEMORY.md	精选的长期记忆（仅私聊）
TOOLS.md	本地工具说明
HEARTBEAT.md	心跳检查清单
BOOT.md	启动检查清单
`memory/YYYY-MM-DD.md`	每日追加日志

提示

AGENTS.md 和 SOUL.md 是最重要的文件 — 它们定义了代理的行为和回应方式。

记忆系统

每日日志

memory/YYYY-MM-DD.md — 追加写入。会话开始时读取今天和昨天的日志。

长期记忆

MEMORY.md — 精选事实，仅在主私聊会话中加载。

向量搜索

memory_search 工具提供语义搜索（每次结果约 400 tokens）。

提供商 — 自动选择顺序：本地 GGUF → OpenAI → Gemini → Voyage

搜索配置

功能	详情
混合搜索	默认权重：0.7 向量 / 0.3 BM25
QMD 后端	可选实验模式，BM25 + 向量 + 重排序

openclaw memory index --all       # 重新索引全部
openclaw memory search "查询"     # 语义搜索

会话与命令

通过内置斜杠命令和语音输出来控制对话的作用域、重置方式和管理。

会话

私聊范围选项

范围	说明
`main`	单一共享会话（默认）
`per-peer`	每个联系人一个会话
`per-channel-peer`	每个频道的每个联系人一个会话
`per-account-channel-peer`	完全隔离的会话

重置模式

模式	说明
`daily`	每天凌晨 4 点重置（默认）
`idle`	空闲超时后重置

配置

{
  "session": {
    "dmScope": "main",
    "reset": {
      "idleMinutes": 30            // 滑动空闲窗口
    },
    "resetByType": { ... },        // 按类型覆盖：dm、group、thread
    "resetByChannel": { ... },     // 按频道覆盖（最高优先级）
    "identityLinks": { ... },      // 映射 provider:id 到标准身份
    "sendPolicy": { ... },         // 阻止特定类型的消息发送
    "store": "~/.openclaw/agents/{agentId}/sessions/sessions.json"
  }
}

安全提示

多用户收件箱请使用 per-channel-peer，以防止用户之间的上下文泄露。

斜杠命令

会话管理

命令	说明
`/status`	会话健康、上下文使用、凭证状态
`/context list`	上下文窗口内容（最大占用者）
`/context detail`	完整系统提示和注入的工作区文件
`/model <model>`	切换会话模型
`/model list`	列出可用模型
`/compact [instructions]`	压缩旧上下文，释放窗口空间
`/new [model]`	开始新会话（可选模型切换）
`/reset`	`/new` 的别名
`/stop`	中止当前运行，清除队列

传递与输出

命令	说明
`/send on\|off\|inherit`	覆盖此会话的消息传递
`/tts on\|off`	切换文本转语音
`/think`	切换推理模式
`/verbose`	切换详细模式

配置

命令	说明
`/config`	持久化的配置更改
`/debug`	仅运行时覆盖（需要 `commands.debug: true`）

文本转语音

提供商	特点
ElevenLabs	超级逼真，延迟较高
OpenAI	标准快速，高质量
Edge TTS	免费，无需 API 密钥，多语言支持

启用自动 TTS：

{
  "messages": {
    "tts": {
      "auto": "always"
    }
  }
}

代理架构

突破单代理限制 — 将消息路由到专业代理、通过技能扩展能力、将任务委派给子代理，并通过心跳保持一切运行。

多代理路由

路由优先级

优先级	绑定	说明
1（最高）	`peer`	精确的私聊/群组 ID
2	`guildId`	Discord 服务器
3	`teamId`	Slack 工作区
4	`accountId`	账户级别
5	`channel`	频道类型
6（最低）	`default`	最终回退代理

管理

openclaw agents add <name>                # 添加新代理
openclaw agents list --bindings           # 列出路由绑定
openclaw agents delete <name>             # 删除代理

每个代理拥有：

隔离的工作区
独立的认证配置
会话存储在 ~/.openclaw/agents/<id>/sessions/

技能系统

技能优先级

代理技能（最高优先级）

<workspace>/skills/ — 每个代理独立，优先于其他所有来源。

托管/本地技能

~/.openclaw/skills/ — 跨工作区共享。

内置技能（最低优先级）

随 OpenClaw 发布 — 默认能力。

ClawHub 注册表

clawhub install <slug>                    # 从 ClawHub 安装技能
clawhub update --all                      # 更新所有已安装技能
clawhub sync --all                        # 扫描并发布更新

SKILL.md 格式

---
name: my-skill
description: "这个技能的功能"
metadata: { "openclaw": { "requires": { ... } } }
---

子代理

子代理支持并行处理研究/长时间任务，不阻塞主对话。

拥有独立的会话密钥和可选的沙盒隔离
自动将结果发布到请求者的聊天频道
60 分钟后自动归档（可配置）

命令

命令	说明
`/subagents list`	列出活跃的子代理
`/subagents stop <id\|#\|all>`	停止子代理运行
`/subagents log <id\|#>`	查看子代理日志
`/subagents info <id\|#>`	显示运行元数据
`/subagents send <id\|#> <msg>`	向子代理发送消息

生成工具 — sessions_spawn 工具接受：

{
  "task": "研究主题 X",
  "label": "research-x",
  "model": "claude-sonnet",
  "thinking": true,
  "runTimeoutSeconds": 300,
  "cleanup": true
}
// 返回: { status, runId, childSessionKey }

心跳系统

{
  "heartbeat": {
    "every": "30m",                 // 间隔（Anthropic OAuth 为 1h）
    "target": "last",               // last | none | <channel id>
    "to": null,                     // 可选的接收者覆盖
    "model": null,                  // 心跳运行的模型覆盖
    "prompt": null,                 // 自定义提示内容
    "activeHours": {
      "start": "09:00",
      "end": "22:00",
      "timezone": "Asia/Shanghai"
    }
  }
}

约定

代理在无需处理时回复 HEARTBEAT_OK。仅包含 OK 的回复会被自动剥离和丢弃。

自动化与工具

自动化浏览器任务、调度定时任务，以及配置生命周期钩子来定制代理对事件的响应。

浏览器自动化

openclaw browser start | stop             # 无头浏览器实例
openclaw browser tabs                     # 列出打开的页面
openclaw browser open <url>               # 在新标签页打开
openclaw browser navigate <url>           # 导航当前标签页
openclaw browser screenshot               # 截取当前视图
openclaw browser click | type | press     # DOM 交互
openclaw browser evaluate <js>            # 执行 JavaScript
openclaw browser pdf                      # 导出页面为 PDF

定时任务

openclaw cron list                        # 查看定时任务
openclaw cron add                         # 创建新任务
openclaw cron edit <id>                   # 编辑现有任务
openclaw cron enable | disable <id>       # 启用/禁用任务
openclaw cron run <id>                    # 手动触发
openclaw cron runs                        # 查看运行历史

钩子与自动化

内置钩子

钩子	说明
`session-memory`	在 `/new` 时保存会话上下文到记忆
`command-logger`	将所有命令记录到审计文件
`boot-md`	在网关启动时运行 `BOOT.md`
`soul-evil`	在清除窗口期间替换 `SOUL.md`

钩子命令

openclaw hooks list                       # 列出已发现的钩子
openclaw hooks enable <name>              # 启用钩子
openclaw hooks disable <name>             # 禁用钩子
openclaw hooks info <name>                # 显示钩子详情
openclaw hooks check                      # 检查资格

事件类型

事件	触发条件
`command:new`	执行 `/new` 时
`command:reset`	执行 `/reset` 时
`command:stop`	执行 `/stop` 时
`gateway:startup`	频道启动后
`agent:bootstrap`	注入工作区文件之前

运维与安全

插件管理、日志记录、沙盒隔离和系统诊断的高级命令。

高级命令

插件与系统管理

openclaw plugins list | enable | disable          # 管理插件
openclaw approvals get | set | allowlist           # 执行审批策略
openclaw sandbox list | recreate | explain         # 检查/重建沙盒
openclaw system event --text "X"                   # 排队系统事件
openclaw system heartbeat enable | disable | last  # 控制心跳
openclaw update status | wizard                    # 管理更新渠道

节点与设备管理

openclaw nodes list | pending | approve            # 远程节点管理
openclaw devices list | approve | rotate | revoke  # 设备令牌生命周期
openclaw directory peers | groups list             # 解析 ID

监控与仪表盘

openclaw health --json --verbose        # 直接网关健康探测
openclaw dashboard                      # 打开控制面板 UI
openclaw tui --url <url> --token <tok>  # 远程终端 UI

日志与诊断

openclaw logs --follow                    # 实时查看日志（TTY 彩色显示）
openclaw logs --json                      # 行分隔 JSON
openclaw logs --limit 200                 # 限制输出
openclaw channels logs --channel whatsapp # 特定频道日志

OpenTelemetry 导出

{
  "diagnostics": {
    "otel": {
      "enabled": true
    }
  }
}

沙盒

模式选项

模式	说明
`"off"`	不使用沙盒，工具在宿主机运行
`"non-main"`	仅对非主会话使用沙盒（默认）
`"all"`	所有会话都在沙盒中运行

范围选项

范围	说明
`"session"`	每个会话一个容器（默认）
`"agent"`	每个代理一个容器
`"shared"`	所有沙盒会话共享一个容器

工作区访问

访问级别	说明
`"none"`	工具仅可见沙盒工作区（默认）
`"ro"`	只读挂载在 `/agent`
`"rw"`	读写挂载在 `/workspace`

设置：

scripts/sandbox-setup.sh  # 创建 openclaw-sandbox:bookworm-slim 镜像

参考

常用路径速查和常见问题排除。

关键路径

路径	说明
`~/.openclaw/openclaw.json`	主配置文件
`~/.openclaw/workspace/`	默认代理工作区
`~/.openclaw/agents/<id>/`	每个代理的状态目录
`~/.openclaw/agents/<id>/sessions/`	会话存储和记录
`~/.openclaw/credentials/`	OAuth/API 密钥
`~/.openclaw/memory/<agentId>.sqlite`	向量索引存储
`/tmp/openclaw/openclaw-YYYY-MM-DD.log`	网关日志文件

提示

使用 --dev 或 --profile <name> 将所有状态隔离到单独的目录中进行测试。

故障排除

万能修复

遇到问题时，运行 openclaw doctor --deep --yes — 它会执行健康检查、快速修复和系统服务扫描。