# OpenClaw CLI 命令参考

## 常用命令速查

| 命令 | 说明 |
|------|------|
| `openclaw status` | 基本状态检查 |
| `openclaw status --all` | 完整诊断（可分享） |
| `openclaw status --deep` | 深度检测（探测通道） |
| `openclaw doctor` | 健康检查 + 自动修复 |
| `openclaw doctor --fix` | 自动修复配置问题 |
| `openclaw logs --follow` | 实时日志 |
| `openclaw gateway status` | Gateway 服务状态 |
| `openclaw gateway restart` | 重启 Gateway |

## config - 配置管理

```bash
# 获取配置
openclaw config get agents.defaults.workspace
openclaw config get agents.list[0].id

# 设置配置
openclaw config set browser.executablePath "/usr/bin/google-chrome"
openclaw config set agents.defaults.heartbeat.every "2h"
openclaw config set gateway.port 19001 --json

# 删除配置
openclaw config unset tools.web.search.apiKey
```

## gateway - Gateway 管理

### 运行 Gateway
```bash
openclaw gateway              # 前台运行
openclaw gateway run          # 前台运行（显式）
openclaw gateway --verbose    # 详细日志
```

### 服务管理
```bash
openclaw gateway install       # 安装服务
openclaw gateway start       # 启动服务
openclaw gateway stop        # 停止服务
openclaw gateway restart     # 重启服务
openclaw gateway uninstall   # 卸载服务
```

### 查询状态
```bash
openclaw gateway status              # 服务状态 + RPC 探测
openclaw gateway health             # 健康检查
openclaw gateway probe              # 发现所有 Gateway
openclaw gateway discover           # Bonjour 发现
```

### 常用选项
```bash
--port <port>         # WebSocket 端口（默认 18789）
--bind <mode>        # 绑定模式: loopback|lan|tailnet|auto|custom
--token <token>      # 认证 Token
--verbose            # 详细日志
--allow-unconfigured # 允许无配置启动
```

## status - 状态诊断

```bash
openclaw status              # 基本状态
openclaw status --all       # 完整诊断（可粘贴分享）
openclaw status --deep      # 深度检测（探测通道）
openclaw status --usage     # 显示模型用量
```

## doctor - 健康检查

```bash
openclaw doctor              # 检查问题
openclaw doctor --repair    # 自动修复
openclaw doctor --fix       # 自动修复（别名）
openclaw doctor --deep      # 深度扫描
```

## logs - 日志查看

```bash
openclaw logs --follow       # 实时日志
openclaw logs --limit 200   # 最近 200 行
openclaw logs --json        # JSON 格式输出
openclaw logs --plain       # 纯文本格式
openclaw logs --no-color    # 禁用颜色
```

## channels - 通道管理

```bash
openclaw channels list       # 列出已配置通道
openclaw channels status     # 通道状态
openclaw channels status --probe  # 深度探测
openclaw channels logs      # 通道日志
openclaw channels login     # 登录通道（WhatsApp）
openclaw channels logout    # 登出通道
```

## models - 模型管理

```bash
openclaw models list         # 列出可用模型
openclaw models status       # 模型状态 + 认证信息
openclaw models scan         # 扫描新模型
openclaw models set <model>  # 设置默认模型
```

## memory - 记忆管理

```bash
openclaw memory status       # 记忆索引状态
openclaw memory index        # 重新索引记忆文件
openclaw memory search "<query>"  # 语义搜索记忆
```

## cron - 定时任务

```bash
openclaw cron list           # 列出定时任务
openclaw cron add            # 添加定时任务
openclaw cron rm <id>        # 删除定时任务
openclaw cron enable <id>   # 启用任务
openclaw cron disable <id>   # 禁用任务
openclaw cron runs --id <id> # 查看任务运行记录
```

## plugins - 插件管理

```bash
openclaw plugins list        # 列出插件
openclaw plugins install <id>   # 安装插件
openclaw plugins enable <id>    # 启用插件
openclaw plugins disable <id>    # 禁用插件
openclaw plugins doctor      # 插件诊断
```

## skills - 技能管理

```bash
openclaw skills list        # 列出技能
openclaw skills info <name> # 技能详情
openclaw skills check       # 检查技能就绪状态
```

## pairing - 配对管理

```bash
openclaw pairing list <channel>   # 列出待配对请求
openclaw pairing approve <channel> <code>  # 批准配对
```

## 完整命令树

```
openclaw <command>
  setup           # 初始化配置
  onboard         # 向导式配置
  configure       # 交互式配置
  config          # 配置管理
    get/set/unset
  doctor          # 健康检查
  reset           # 重置本地状态
  uninstall       # 卸载
  update          # 更新
  channels        # 通道管理
  skills          # 技能管理
  plugins         # 插件管理
  memory          # 记忆管理
  message         # 发送消息
  agent           # 运行单次 agent
  agents          # 多 agent 管理
  status          # 状态诊断
  health          # 健康检查
  sessions        # 会话管理
  gateway         # Gateway 管理
  logs            # 日志查看
  system          # 系统事件
  models          # 模型管理
  cron            # 定时任务
  nodes           # 节点管理
  browser         # 浏览器控制
  hooks           # 钩子管理
  webhooks        # Webhook 管理
  pairing         # 配对管理
  sandbox         # 沙箱管理
  tui              # 终端 UI
```

## 全局选项

| 选项 | 说明 |
|------|------|
| `--dev` | 开发模式（隔离状态） |
| `--profile <name>` | 指定配置 profile |
| `--json` | JSON 格式输出 |
| `--no-color` | 禁用颜色 |
| `-v`, `--version` | 显示版本 |

---

*最后更新: 2026-02-04*