版本：2026.3.13 (61d171a)
核心理念：Less clicking, more shipping, fewer "where did that file go" moments.

OpenClaw 是一款强大的智能代理网关工具，帮助你管理聊天频道、运行 AI 代理、调度任务、维护浏览器自动化环境等。它采用命令行界面（CLI），支持丰富的子命令和灵活的配置选项，既适合本地开发，也适合生产部署。

本文基于 OpenClaw CLI 帮助信息，系统梳理其用法、全局选项以及所有可用命令，帮助你快速上手并高效使用。

一、基本用法

bash

openclaw [options] [command]

任何命令都可以带上全局选项（如 --dev、--profile 等），以改变运行环境。若不带命令，默认显示帮助信息。

二、全局选项（Options）

这些选项必须放在命令之前，影响整个 OpenClaw 实例的行为。

三、命令分类详解

所有命令均可通过 openclaw <command> --help 查看其子命令和详细用法。带 * 标记的命令表示拥有子命令。

1. 核心服务与网关

命令	功能
gateway *	运行、检查和查询 WebSocket 网关。网关是 OpenClaw 的核心服务，处理外部连接（HTTP/WebSocket）并与代理交互。例如：openclaw gateway --port 18789。
daemon *	gateway 的旧别名，功能相同。
node *	运行和管理无头节点主机服务。节点是远程设备上的轻量代理，接受网关指令。
nodes *	管理网关拥有的节点配对和命令。
health	从运行中的网关获取健康状态。
logs	通过 RPC 追踪网关文件日志。
system *	管理系统事件、心跳和在线状态。

2. 聊天频道与消息

命令	功能
channels *	管理已连接的聊天频道，如 Telegram、Discord、WhatsApp 等。支持登录、登出、状态查看。
message *	发送、读取和管理消息。例如：openclaw message send --target +15555550123 --message "Hi"。
directory *	查找联系人和群组 ID，用于频道寻址。
status	显示频道健康状态和最近的会话接收方。

3. 代理与智能体

命令	功能
agent	通过网关运行一次代理任务。例如：openclaw agent --to +15555550123 --message "Run summary" --deliver。
agents *	管理隔离的代理（工作区、认证、路由等）。可创建多个独立代理实例。
skills *	列出和检查可用技能。技能是代理可调用的功能模块（代码执行、文件操作等）。
hooks *	管理内部代理钩子，用于自定义代理行为。

4. 模型管理

命令	功能
models *	发现、扫描和配置 AI 模型。可列出模型提供商、测试连接、设置默认模型。

5. 安全与认证

命令	功能
pairing *	安全私聊配对，批准入站配对请求。
devices *	设备配对和令牌管理，用于将手机或其他设备与 OpenClaw 关联。
approvals *	管理执行审批，敏感操作需手动确认。
security *	安全工具和本地配置审计。
secrets *	运行时重载密钥，无需重启服务。

6. 数据与状态管理

命令	功能
backup *	创建和验证本地备份存档。
memory *	搜索和重建记忆文件（代理长期记忆）。
sessions *	列出存储的对话会话。
reset	重置本地配置/状态，但保留 CLI 本身。
uninstall	卸载网关服务并删除本地数据，CLI 保留。

7. 浏览器与沙箱

命令	功能
browser *	管理 OpenClaw 专用的 Chrome/Chromium 浏览器实例，用于浏览器自动化。
sandbox *	管理沙箱容器（如 Docker），实现代理隔离，提高安全性。

8. 定时任务与插件

命令	功能
cron *	通过网关调度器管理定时任务。
plugins *	管理 OpenClaw 插件和扩展。
webhooks *	Webhook 辅助工具和集成。

9. 配置与初始化

命令	功能
config *	非交互式配置助手（get/set/unset/validate）。不带参数时启动设置向导。
configure	交互式设置向导，配置认证、频道、网关和代理默认值。
onboard	交互式新手引导，完成网关、工作区和技能的初始化。
setup	初始化本地配置和代理工作区。
doctor	健康检查和快速修复网关及频道问题。

10. 其他实用工具

命令	功能
acp *	Agent Control Protocol 工具，底层控制协议。
dns *	DNS 辅助工具，用于广域发现（Tailscale + CoreDNS）。
docs	搜索在线文档（docs.openclaw.ai）。
dashboard	用当前令牌打开控制 UI（Web 界面）。
qr	生成 iOS 配对二维码/设置码。
tui	打开连接到网关的终端用户界面。
completion	生成 shell 补全脚本（bash/zsh/fish 等）。
help	显示帮助信息（同 -h）。
clawbot *	旧版 clawbot 命令的别名，保持向后兼容。

四、典型使用示例

以下示例展示了常见场景中的命令组合：

五、配置文件与状态隔离

OpenClaw 默认将状态文件存放在 ~/.openclaw/ 目录下。通过 --profile 选项，你可以创建多个独立的环境：

bash

openclaw --profile work gateway   # 使用 ~/.openclaw-work/
openclaw --profile personal gateway  # 使用 ~/.openclaw-personal/

开发模式（--dev）则自动使用 ~/.openclaw-dev/，互不干扰。

六、获取帮助

• 全局帮助：openclaw --help 或 openclaw help

• 命令帮助：openclaw <command> --help，例如 openclaw models --help

• 在线文档：openclaw docs（打开浏览器搜索）或访问 docs.openclaw.ai

选项	说明
--dev	开发模式：状态文件隔离到 ~/.openclaw-dev，默认网关端口改为 19001，同时调整衍生端口（浏览器、画板等）。适合测试，不影响生产配置。
-h, --help	显示帮助信息。可接具体命令，如 openclaw agent --help。
--log-level <level>	全局日志级别，覆盖文件和控制台。可选值：silent、fatal、error、warn、info、debug、trace。
--no-color	禁用 ANSI 颜色输出。适用于不支持颜色的终端或日志重定向。
--profile <name>	使用指定的配置档案。状态和配置被隔离到 ~/.openclaw-<name> 目录，支持多实例并行（如工作和个人环境）。
-V, --version	输出版本号。

本文档基于 OpenClaw 2026.3.13 (61d171a) 编写，后续版本若有变动，请以官方文档为准。