本文档基于 OpenClaw 2026 官方社区参考指南整理，所有命令与配置均经过验证可执行。如需获取交互式版本，可访问：http://moltfounders.com/openclaw-mega-cheatsheet

一、核心 CLI 命令集

命令	功能说明
openclaw gateway	启动 WebSocket 网关服务（支持 --port 指定端口）
`openclaw gateway start	stop
openclaw channels login	启动 WhatsApp QR 码配对流程
openclaw channels add --token <token>	接入 Telegram/Discord/Slack 机器人
openclaw channels status --probe	通道健康状态检查
openclaw onboard --install-daemon	交互式初始化向导
openclaw doctor --deep	深度健康检查与自动修复
`openclaw config get	set
`openclaw models list	set
openclaw models auth setup --token	Anthropic 等模型的认证流程

---

二、快速安装与全局配置

# 全局安装最新版
npm install -g openclaw@latest

# 初始化并安装守护进程
openclaw onboarding --install-daemon

全局标志（Global Flags）

标志	作用
--dev	隔离状态到 ~/.openclaw-dev/<name>
--profile <name>	隔离状态到 ~/.openclaw-<name>
--json	输出机器可读的 JSON 格式
--no-color	禁用 ANSI 颜色输出

---

三、多通道管理配置

平台	接入命令	备注
WhatsApp	openclaw channels login	支持 QR 码扫描
Telegram	openclaw channels add --channel telegram	需要 Bot Token
Discord	openclaw channels add --channel discord	需要 Bot Token
iMessage	原生支持	macOS 桥接
Slack	openclaw channels add --channel slack	需要 Bot Token

---

四、工作区结构与文件说明

默认根目录：~/.openclaw/workspace

文件/目录	用途
AGENTS.md	代理指令说明
SOUL.md	角色与语气定义
USER.md	用户偏好设置
IDENTITY.md	名称与主题配置
MEMORY.md	长期记忆存储
memory/YYYY-MM-DD.md	会话日志
HEARTBEAT.md	健康检查清单
BOOT.md	启动脚本与配置

---

五、聊天内斜杠命令

命令	功能
/status	查看健康与上下文状态
/context list	列出上下文贡献者
/model <m>	切换当前模型
/compact	释放窗口空间
/new	开启全新会话
/stop	中止当前运行
/tts on	切换语音合成
/think	切换推理模式

---

六、关键路径映射

类别	路径
主配置	~/.openclaw/openclaw.json
默认工作区	~/.openclaw/workspace/
代理状态	~/.openclaw/agents/<cid>/
认证凭据	~/.openclaw/credentials/
向量索引	~/.openclaw/memory/<cid>.sqlite
共享技能	~/.openclaw/skills/
网关日志	/tmp/openclaw/*.log

---

七、语音与 TTS 配置

服务	类型	要求
OpenAI / ElevenLabs	高级	需要 API Key
Edge TTS	免费	无需 API Key

自动 TTS 配置示例：

"messages.tts.auto": "always"

---

八、记忆与模型操作

功能	命令
向量搜索	memory search "X"
模型切换	models set <model>
认证设置	models auth setup

---

九、Hooks 与技能管理

操作	命令
ClawHub 安装	clawhub install <slug>
Hook 列表	openclaw hooks list

---

十、常见问题排查

问题	解决方案
无私信回复	执行 pairing list → approve
群组中无响应	检查 mentionPatterns 配置
认证过期	运行 models auth setup --token
网关宕机	执行 doctor --deep 深度修复
记忆异常	重建 memory index

---

十一、自动化与研究工具

功能	命令/配置
浏览器操作	browser start/screenshot
子代理管理	/subagents list/info
定时任务	cron list/run <id>
心跳配置	heartbeat.every: "30m"

---