下载原图有惊喜

1. 核心 CLI 命令 (Core Commands)

📦 快速安装 (Quick Install)

OpenClaw 推荐全局安装，以方便在终端任何位置调用openclaw守护进程和命令。

npm install -g @openclaw/cli：全局安装 OpenClaw CLI。

启动参数选项：

⚙️ 服务管理 (Service Management)

OpenClaw 的核心是它的 Gateway（网关），所有消息、工具和会话都通过此网关路由。

openclaw gateway start：  启动本地 Gateway 服务。openclaw gateway stop：   优雅停止服务，断开所有 Channel 和大模型的连接。openclaw gateway restart：重启服务（常用于更新配置后）。openclaw gateway status： 查看网关当前运行状态。

💬 通道管理 (Channel Management)

将你的 AI 助手桥接到日常沟通工具中。

WhatsAppopenclaw channels add --whatsapp(需配置相应的 Token 凭证)。Telegramopenclaw channels add --telegram(通过扫描 QR 码或输入 Bot Token 绑定)。状态检查openclaw channels status(查看当前已连接的即时通讯平台状态，排查掉线问题)。

2. 系统配置与路径 (Config & Paths)

📂 工作区结构 (Workspace Structure)

默认根路径：~/.OPENCLAW/WORKSPACE

OpenClaw 使用 Markdown 风格的文件来定义 Agent 的行为，方便人类阅读和版本控制：

AGENTS.md：Agent 实例配置文件，定义人设和系统提示词。

MESSAGES.md：系统预设消息与上下文配置。

PLUGINS.md：启用的第三方插件列表（如 GitHub、Nylas 等）。

WEBHOOKS.md：外部触发器定义，用于接收外部系统的回调。

WORKFLOWS.md：复杂的多步任务工作流定义。

SKILLS.md：赋予 Agent 的具体技能（如联网搜索、执行代码等）。

📁 基本路径映射

CONFIG: ~/.openclaw/config.yaml(核心主配置文件)

CREDENTIALS: ~/.openclaw/credentials/(存放各大模型的 API Keys 或 OAuth 凭证)

LOGS: ~/.openclaw/logs/(系统运行日志及 Agent 交互日志)

PLUGINS: ~/.openclaw/plugins/(本地化安装的插件目录)

⌨️ 斜杠命令 (Slash Commands)

在 WhatsApp 或 Telegram 聊天框中直接向 Agent 发送的内置指令：

/status：快速获取系统状态概览。/agents：切换或管理当前正在对话的 Agent 实例。/help：获取支持的命令帮助列表。

🎙️ 语音与 TTS (Voice & TTS)

配置项:messages.tts.auto: "always"（强制全局开启语音回复）。

注意: 如果在 macOS/移动端使用 Talk Mode（语音唤醒），需要确保终端或宿主应用已获取麦克风权限。

3. 高级功能 (Advanced Features)

🧠 模型管理 (Models)

openclaw models list  列出当前系统支持和已配置的大语言模型（如 OpenAI、Qwen 等）。openclaw models set 设置默认对话模型。openclaw models status 检查所有模型的 API 连通性。openclaw models fallbacks 配置故障转移策略（如果主模型限流或超时，自动切换到备用模型）。openclaw models auth setup-token 交互式配置模型 API Token 或 OAuth 认证。

📊 日志诊断 (Logging)

openclaw logs --follow 类似tail -f，实时跟踪对话流和系统日志。openclaw logs --json 以 JSON 格式输出日志，便于对接 ELK 等外部审计系统。openclaw logs --level debug 开启底层调试级别日志，排查疑难杂症。openclaw logs --limit 50/--filter 限制输出行数或通过关键字过滤特定 Agent/Error 的日志。

🛠️ 故障排除指南 (Troubleshooting)

现象：系统无响应➡️方案：执行openclaw gateway restart强制重启控制流。

现象：通道连接失败（如 TG 机器人没反应）➡️方案：执行openclaw channels status --probe发送主动探针检测网络连通性。

现象：模型调用超时➡️方案：执行openclaw models status --probe检测大语言模型 API 延迟。

现象：配置文件报错➡️方案：执行openclaw config validate校验 YAML/JSON5 语法是否合法。

🛡️ 安全审计 (Security Audit)

openclaw security audit 扫描敏感配置、裸露的 API Key 及越权风险。openclaw security audit --fix 自动修复常规的安全权限问题。openclaw secrets reload 不重启 Gateway 的情况下，热重载内存中的凭证密钥。