2026年OpenClaw CLI 完全指南：少点点击，多点交付

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

版本：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 等），以改变运行环境。若不带命令，默认显示帮助信息。

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

所有命令均可通过 openclaw --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 + --message "Hi"。 directory * 查找联系人和群组 ID，用于频道寻址。 status 显示频道健康状态和最近的会话接收方。

3. 代理与智能体

命令功能 agent 通过网关运行一次代理任务。例如： openclaw agent --to + --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 –help，例如 openclaw models –help
在线文档：openclaw docs（打开浏览器搜索）或访问 docs.openclaw.ai

选项说明 –dev 开发模式：状态文件隔离到 /.openclaw-dev，默认网关端口改为 19001，同时调整衍生端口（浏览器、画板等）。适合测试，不影响生产配置。 -h, –help 显示帮助信息。可接具体命令，如 openclaw agent –help。

–log-level

全局日志级别，覆盖文件和控制台。可选值： silent、 fatal、 error、 warn、 info、 debug、 trace。 –no-color 禁用 ANSI 颜色输出。适用于不支持颜色的终端或日志重定向。

–profile

使用指定的配置档案。状态和配置被隔离到

/.openclaw-

目录，支持多实例并行（如工作和个人环境）。 -V, –version 输出版本号。

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