OpenClaw CLI (openclaw) 全命令速查手册，按功能分组。
安装与初始化
| 命令 | 说明 |
|---|
openclaw onboard | 运行交互式配置向导 |
openclaw onboard --install-daemon | 配置向导 + 安装开机自启 Daemon |
openclaw onboard --skip-channel | 跳过渠道配置步骤 |
openclaw --version | 查看当前版本 |
openclaw --help | 查看帮助信息 |
openclaw update | 更新到最新版本 |
网关管理
网关（Gateway）是 OpenClaw 的核心进程，负责连接所有渠道和 Agent。
| 命令 | 说明 |
|---|
openclaw gateway start | 启动网关 |
openclaw gateway stop | 停止网关 |
openclaw gateway restart | 重启网关（修改配置后必做） |
openclaw gateway status | 查看网关运行状态 |
openclaw gateway --port 19000 | 指定端口启动（默认 18789） |
openclaw dashboard | 在浏览器打开管理面板 |
模型管理
| 命令 | 说明 |
|---|
openclaw models list | 列出当前可用模型 |
openclaw models list --all | 列出所有模型（含所有 provider） |
openclaw models list --provider aigocode | 列出指定 provider 的模型 |
openclaw models set aigocode/claude-opus-4-6 | 切换默认模型 |
openclaw models show | 显示当前使用的模型信息 |
渠道管理
| 命令 | 说明 |
|---|
openclaw channels list | 列出所有已配置的渠道 |
openclaw channels status | 查看各渠道连接状态 |
openclaw pairing list telegram | 查看 Telegram 待配对列表 |
openclaw pairing approve telegram <配对码> | 批准 Telegram 配对请求 |
openclaw pairing revoke telegram <用户ID> | 撤销配对 |
openclaw pairing list discord | 查看 Discord 待配对列表 |
Agent 管理
| 命令 | 说明 |
|---|
openclaw agents list | 列出所有 Agent |
openclaw agents show <名称> | 查看指定 Agent 配置详情 |
openclaw agents reload | 重新加载 Agent 配置（无需完整重启） |
openclaw context clear <Agent名> | 清空指定 Agent 的上下文 |
诊断工具
| 命令 | 说明 |
|---|
openclaw doctor | 全面诊断（Node 版本、配置、网络等） |
openclaw doctor --fix | 诊断并尝试自动修复 |
openclaw status | 查看系统状态（Token 用量、运行时间等） |
openclaw logs | 查看最近日志 |
openclaw logs --follow | 实时追踪日志（tail -f 模式） |
openclaw logs --lines 100 | 查看最近 100 行日志 |
openclaw logs --level error | 只显示错误日志 |
配置管理
| 命令 | 说明 |
|---|
openclaw config show | 显示当前生效的配置（含默认值） |
openclaw config edit | 用默认编辑器打开配置文件 |
openclaw config validate | 验证配置文件语法 |
openclaw config reset | 重置配置为出厂默认值 |
常用组合
安装后快速验证
openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard
修改配置后重载
openclaw config validate
openclaw gateway restart
openclaw status
排查渠道连接问题
openclaw channels status
openclaw logs --follow
openclaw doctor
完全重置（慎用）
openclaw gateway stop
openclaw config reset
openclaw onboard
配置文件位置
~/.openclaw/openclaw.json # 主配置文件
~/.openclaw/agents/ # Agent 配置目录
~/.openclaw/logs/ # 日志目录
提示：所有命令都支持 --help 参数，例如 openclaw gateway --help。