03-OpenClaw-CLI命令详解

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

 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg>

GPT plus 代充只需 145

免费专栏全套教程：OpenClaw从入门到精通

OpenClaw 是一个强大的 AI 助手平台，通过命令行界面 (CLI) 提供完整的管理和控制能力。本文档详细介绍所有命令的使用方法。

全局选项
核心命令
- openclaw status
- openclaw gateway
- openclaw configure
- openclaw config
- openclaw doctor
消息与通信
- openclaw message
- openclaw channels
模型管理
- openclaw models
任务与自动化
- openclaw cron
- openclaw hooks
节点管理
- openclaw nodes
- openclaw node
会话与代理
- openclaw sessions
- openclaw agents
- openclaw agent
浏览器控制
- openclaw browser
安全与沙箱
- openclaw security
- openclaw sandbox
其他实用命令
- openclaw update
- openclaw memory
- openclaw logs
命令速查表

所有命令都支持以下全局选项：

选项说明在下隔离状态，并调整默认端口在下隔离状态禁用 ANSI 颜色输出等同于（仅源码安装） , , 显示版本号并退出 JSON 格式输出（支持的命令）

输出样式说明

ANSI 颜色和进度指示器：仅在 TTY 会话中渲染
OSC-8 超链接：在支持的终端中渲染为可点击链接
：禁用样式，输出纯净的 JSON
：禁用 ANSI 样式，环境变量也生效

OpenClaw 配色方案（龙虾调色板）

颜色名色值用途 accent #FF5A2D 标题、标签、主要高亮 accentBright #FF7A3D 命令名、强调 accentDim #D14A22 次要高亮文本 info #FF8A5B 信息值 success #2FBF71 成功状态 warn #FFB020 警告、提醒 error #E23D2D 错误、失败 muted #8B7F77 弱化文本、元数据

openclaw status

显示会话健康状态和最近的收件人信息，快速诊断网关和通道状态。

讯享网

选项

选项说明 JSON 格式输出完整诊断（只读、可复制）探测通道（运行实时检查）显示模型提供商使用量/配额超时时间 , 详细输出

输出内容

Gateway 状态：网关服务运行状态
节点主机服务：节点主机安装/运行状态（如可用）
通道健康：各通道的连接状态
会话存储：每个代理的会话存储状态
更新信息：更新渠道和 git SHA（源码安装）
使用量追踪：提供商使用量/配额（OAuth/API 凭证可用时）

实用示例

openclaw gateway

管理 Gateway 服务（WebSocket 网关，处理通道、节点、会话、钩子）。

子命令概览

子命令说明前台运行 Gateway 查看网关服务状态启动网关服务停止网关服务重启网关服务安装网关服务卸载网关服务检查网关健康状态探测网关（调试用）发现网关（Bonjour）低级 RPC 调用

运行 Gateway

讯享网

运行选项：

选项说明 WebSocket 端口（默认来自配置，通常为 18789）绑定模式：//// 认证模式：/ 令牌认证密码认证 Tailscale 暴露：// 退出时重置 Tailscale 配置允许无配置启动创建开发配置+工作区重置开发配置（需）强制终止占用端口的进程详细日志 WebSocket 日志样式：//

管理网关服务

服务管理选项：

选项说明服务端口 `–runtime <node bun>` 令牌强制覆盖 JSON 输出

查询运行中的 Gateway

讯享网

查询选项：

选项说明网关 WebSocket URL 认证令牌认证密码探测超时（默认 10000）跳过 RPC 探测扫描系统级服务 JSON 输出

发现网关（Bonjour）

实用示例

讯享网

openclaw configure

交互式配置向导，设置凭证、设备和代理默认值。

选项

选项说明只配置特定部分（可重复）

配置部分

Model：模型设置，包括允许列表
Channels：通道账户配置
Skills：技能管理
Gateway：网关设置

实用示例

讯享网

openclaw config

非交互式配置操作：读取/设置/取消配置值。

路径语法

使用点号或括号语法访问配置：

讯享网

值解析

值首先尝试 JSON5 解析
解析失败则作为字符串
使用强制 JSON5 解析

实用示例

注意：修改配置后需要重启网关：

openclaw doctor

健康检查和快速修复，诊断配置和网关问题。

讯享网

选项

选项说明 , 自动修复问题扫描系统服务非交互模式接受默认值（无头模式）禁用工作区提示

检查项目

配置文件完整性
凭证和认证状态
网关连接
通道健康
沙箱设置（Docker 可用性）
内存搜索就绪状态
孤立会话文件

macOS launchctl 环境变量

如果之前运行过，可能导致持久化的认证错误：

实用示例

讯享网

openclaw message

统一的消息发送和通道操作命令。

支持的通道

WhatsApp
Telegram
Discord
Google Chat
Slack
Mattermost（插件）
Signal
iMessage
MS Teams

子命令

子命令说明支持通道发送消息全部发起投票 WhatsApp/Telegram/Discord/Matrix/MS Teams 添加反应 Discord/Google Chat/Slack/Telegram/WhatsApp/Signal 列出反应 Discord/Google Chat/Slack 读取消息 Discord/Slack 编辑消息 Discord/Slack 删除消息 Discord/Slack/Telegram / 置顶/取消置顶 Discord/Slack 列出置顶 Discord/Slack 搜索消息 Discord 创建线程 Discord 列出线程 Discord 线程回复 Discord 广播消息所有配置的通道

通用选项

选项说明通道名称账户 ID 目标（通道或用户）多目标（广播用） JSON 输出试运行详细输出

目标格式

通道格式 WhatsApp E.164 号码或群组 JID Telegram 聊天 ID 或 Discord 或 Google Chat 或 Slack 或 Signal 、、 iMessage handle、、 MS Teams 会话 ID（）

实用示例

讯享网

openclaw channels

管理聊天通道账户和状态。

子命令

子命令说明列出配置的通道和认证配置检查网关可达性和通道健康添加通道账户移除通道账户交互式登录（仅 WhatsApp Web）登出通道会话显示最近的通道日志获取通道能力解析名称到 ID

选项

选项说明通道名称账户 ID（默认）显示名称删除配置条目（时）运行额外检查日志行数（默认 200） JSON 输出

实用示例

讯享网

openclaw models

模型发现、扫描和配置。

子命令

子命令说明显示默认/回退模型和认证概览列出可用模型设置默认模型设置默认图像模型扫描可用模型/提供商列出模型别名添加别名移除别名列出回退模型添加回退模型移除回退模型交互式添加认证设置令牌粘贴令牌

status 选项

选项说明 JSON 输出纯文本输出检查过期/缺失（退出码 ¹⁄ ₂）实时探测认证配置探测单个提供商指定代理

scan 选项

选项说明最小参数最大天数提供商名称设置为默认设置为图像默认 JSON 输出

实用示例

讯享网

openclaw cron

管理定时任务。

添加任务

讯享网

选项

选项说明任务名称一次性任务时间间隔时间 cron 表达式系统事件 JSON 消息内容通道名称目标公告模式 JSON 输出

实用示例

openclaw hooks

管理代理钩子（事件驱动自动化）。

讯享网

子命令

子命令说明列出所有钩子显示钩子详情检查钩子就绪状态启用钩子禁用钩子安装钩子包更新钩子包

选项

选项说明只显示就绪的钩子 JSON 输出 , 详细输出 , 链接本地目录（安装时）固定版本（npm 安装时）更新所有（更新时）

内置钩子

钩子事件说明会话开始时保存上下文到记忆注入额外的引导文件所有命令事件记录所有命令到审计日志网关启动时运行 BOOT.md

实用示例

openclaw nodes

管理配对节点和调用节点能力。

讯享网

子命令

子命令说明列出配对节点节点状态概览列出待批准请求批准配对请求拒绝配对请求节点详情重命名节点在节点上运行命令调用节点命令发送通知（仅 macOS）

相机命令

画布/屏幕命令

讯享网

位置命令

实用示例

讯享网

openclaw node

运行和管理无头节点主机。

运行（前台）

服务管理（后台）

讯享网

选项

选项说明网关主机（默认 127.0.0.1）网关端口（默认 18789）使用 TLS TLS 证书指纹节点 ID 显示名称 `–runtime <node bun>` 强制覆盖

openclaw sessions

列出存储的会话。

选项

选项说明指定代理所有代理指定存储路径活跃时间过滤 JSON 输出

清理维护

讯享网

openclaw agents

管理隔离代理（工作区+认证+路由）。

选项

选项说明工作区路径模型 ID 代理目录绑定通道非交互模式 JSON 输出强制删除

实用示例

讯享网

openclaw agent

运行单个代理回合。

选项

选项说明消息内容（必需）目标会话 ID 思考级别：off/minimal/low/medium/high/xhigh 通道本地运行投递消息 JSON 输出超时

openclaw browser

管理浏览器控制服务器和运行浏览器操作。

讯享网

子命令

子命令说明浏览器状态启动浏览器停止浏览器重置配置文件列出标签页打开 URL 聚焦标签页关闭标签页列出配置文件创建配置文件删除配置文件截图页面快照导航调整大小点击输入按键悬停拖拽选择上传文件填充表单处理对话框等待执行 JS 控制台日志导出 PDF

通用选项

选项说明网关 URL 认证令牌超时浏览器配置文件 JSON 输出

实用示例

openclaw security

安全审计和修复。

讯享网

检查项目

多 DM 发送者共享主会话警告
小模型（≤300B）无沙箱+Web/浏览器工具警告
Webhook 入侵配置
沙箱 Docker 配置问题
危险的网络模式
插件/钩子安装记录
可变名称的通道白名单
无认证的网关暴露

修复内容

将改为
设置从到
收紧敏感文件权限

实用示例

openclaw sandbox

管理沙箱容器。

讯享网

子命令

子命令说明列出沙箱容器解释有效沙箱策略重建沙箱容器

recreate 选项

选项说明重建所有容器指定会话指定代理只重建浏览器容器跳过确认

实用示例

openclaw update

更新 OpenClaw。

讯享网

选项

选项说明 `–channel <stable beta `–tag <dist-tag version>` 预览操作跳过重启网关 JSON 输出超时

更新渠道

渠道说明最新稳定版（npm）最新测试版（npm 标签）开发版（git 检出）

实用示例

openclaw memory

管理语义记忆索引和搜索。

讯享网

选项

选项说明指定代理详细输出深度探测查询文本

实用示例

openclaw logs

查看网关日志。

讯享网

选项

选项说明 , 跟踪日志行数限制纯文本输出 JSON 输出禁用颜色

常用命令

命令说明状态概览交互式配置健康检查更新 OpenClaw

网关管理

命令说明前台运行网关启动服务停止服务重启服务服务状态健康检查

通道管理

命令说明列出通道添加通道通道状态发送消息

模型管理

命令说明模型状态列出模型设置默认模型扫描模型

任务调度

命令说明列出任务添加任务启用任务运行任务

节点管理

命令说明列出节点运行命令发送通知

代理管理

命令说明列出代理添加代理列出会话

安全

命令说明安全审计列出沙箱重建沙箱

官方文档
GitHub 仓库
问题反馈