209 lines
5.6 KiB
Markdown
209 lines
5.6 KiB
Markdown
# 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*
|