
命令主要分为三类：
1. **终端 CLI 命令**（shell 中运行 `openclaw` + 子命令）
2. **常用全局 Flags**（适用于大多数命令）
3. **交互/聊天模式内 Slash 命令**（在 Telegram/WhatsApp 等通道中输入 `/` 触发的指令，或 TUI/CLI agent 模式）

### 1. 终端 CLI 命令（openclaw [subcommand] [flags]）

| 子命令 / 用法示例                  | 主要作用                                      | 典型示例                                           | 备注 / 常用度      |
|------------------------------------|-----------------------------------------------|----------------------------------------------------|--------------------|
| `openclaw`                         | 显示帮助 / 顶级命令列表                       | `openclaw` 或 `openclaw --help`                    | 入口查看帮助       |
| `openclaw onboard`                 | 首次引导设置（wizard，最推荐）                | `openclaw onboard --install-daemon`                | 新用户必跑         |
| `openclaw configure` / `openclaw config` | 交互式配置向导（模型、通道、默认 agent 等） | `openclaw configure --section model`               | 配置首选           |
| `openclaw gateway start`           | 启动 Gateway（核心服务，24/7 运行）           | `openclaw gateway start`                           | 后台运行常用       |
| `openclaw gateway restart`         | 重启 Gateway                                  | `openclaw gateway restart`                         | 更新/卡住时用      |
| `openclaw gateway stop`            | 停止 Gateway                                  | `openclaw gateway stop`                            | 维护时             |
| `openclaw gateway status`          | 查看 Gateway 状态                             | `openclaw gateway status --all`                    | 监控首选 ★★★★★     |
| `openclaw doctor`                  | 诊断配置、健康检查、常见问题                  | `openclaw doctor`                                  | 排查问题 ★★★★★     |
| `openclaw status`                  | 简易状态概览（Gateway + channels）            | `openclaw status`                                  | 快速检查           |
| `openclaw channels list`           | 列出已连接通道（Telegram/Slack 等）           | `openclaw channels list --json`                    | 查看连接           |
| `openclaw channels add` / `login`  | 添加/登录新通道                               | `openclaw channels login telegram`                 | 扩展聊天入口       |
| `openclaw models list`             | 列出可用模型                                  | `openclaw models list --all`                       | 查看/切换模型      |
| `openclaw models set <provider/model>` | 设置默认模型                              | `openclaw models set claude/sonnet-4`              | 常用切换           |
| `openclaw agents list`             | 列出 agents / workspaces                      | `openclaw agents list`                             | 多 agent 管理      |
| `openclaw agents add <name>`       | 添加新 agent / workspace                      | `openclaw agents add work --workspace ~/workspace-work` | 多角色并行     |
| `openclaw cron list`               | 列出 cron 任务（heartbeat / 定时）            | `openclaw cron list`                               | 自动化监控 ★★★★    |
| `openclaw logs --follow`           | 实时查看日志                                  | `openclaw logs -f`                                 | 调试首选 ★★★★★     |
| `openclaw update` / `npm update -g openclaw` | 更新到最新版                        | `npm install -g openclaw@latest`                   | 保持最新           |
| `openclaw reset --scope full`      | 核重置（配置 + workspace）                    | `openclaw reset --scope full`                      | 问题严重时用       |

**常用全局 Flags**（加在 openclaw 后）

| Flag                           | 作用                                          | 示例                                           |
|--------------------------------|-----------------------------------------------|------------------------------------------------|
| `--dev`                        | 开发模式（更多日志、热重载）                  | `--dev`                                        |
| `--profile <name>`             | 使用指定配置文件（多环境）                    | `--profile work`                               |
| `--json`                       | JSON 输出（脚本友好）                         | `openclaw status --json`                       |
| `--help` / `-h`                | 显示子命令帮助                                | `openclaw gateway --help`                      |

### 2. 交互/聊天模式内 Slash 命令（在 Telegram/WhatsApp/Slack 等通道中输入 `/`）

| Slash 命令              | 主要作用                                      | 常用场景 / 备注                              |
|-------------------------|-----------------------------------------------|----------------------------------------------|
| `/help`                 | 显示所有可用 slash 命令 + 快捷键              | 随时查看，必备                               |
| `/model`                | 切换当前会话模型（支持 fallback）             | 切换 Claude / Gemini / Qwen 等               |
| `/new`                  | 开始新对话 / 清空上下文                       | 换新任务                                     |
| `/clear`                | 清空记忆 / 上下文                             | 重置会话                                     |
| `/memory` / `/edit-memory` | 查看/编辑长期记忆（SOUL.md / AGENTS.md 等） | 持久化人格/规则                              |
| `/skills` / `/skills list` | 查看/管理技能（install / add）             | 扩展功能（如 coding、email、browser）        |
| `/status`               | 显示当前 agent 状态、模型、token 使用         | 快速自查                                     |
| `/cost` / `/stats`      | token 消耗估算                                | 监控大模型费用                               |
| `/undo`                 | 撤销上一步动作（文件/命令）                   | 安全回滚                                     |
| `/agent` / `@agent-name`| 切换/调用特定 agent                           | 多 agent 协作                                |
| `/channels`             | 查看/管理通道连接                             | 检查 WhatsApp 等在线状态                     |

**补充说明**（2026 年 3 月最新情况）：
- 官方最权威文档：https://docs.openclaw.ai/cli （CLI 参考树） + https://docs.openclaw.ai/concepts （模型/技能/内存）
- 安装方式（一键推荐）：
  ```bash
  npm install -g openclaw@latest
  openclaw onboard --install-daemon   # 首次运行引导 + 安装 daemon
  ```
- OpenClaw 核心是 Gateway（WebSocket 服务），CLI 主要用于管理它；实际交互多在聊天 app 中进行。
- 安全提示：默认允许工具（如 shell、文件编辑），生产环境建议用 sandbox / 审批，或自定义技能白名单。
- 社区资源：ClawHub（技能市场）、GitHub issues、YouTube 教程（搜索 "OpenClaw tutorial"）。
- 与其他工具对比：不像 Codex/Claude Code/OpenCode 专注编码，OpenClaw 更偏向“个人/团队数字员工”（邮件、日历、自动化、跨通道）。

快速查看本地帮助：
```bash
openclaw --help          # 顶级命令
openclaw gateway --help  # 子命令示例
# 在聊天中
/help
```

