🦞 OpenClaw CLI 命令全解析：AI 网关与智能体自动化配置核心指南

OpenClaw 的命令行工具（CLI）是你与网关、智能体以及底层配置交互的核心控制台。为了方便理解与查阅，我将原本按字母排序的几十个命令，按照实际使用场景进行了分类整理。

💡 提示：列表中带有 * 星号的命令为“父命令”，其下包含多个子命令。在下方的列表中，我已经为你展开了部分核心子命令的使用方法。你也可以通过运行 openclaw <命令> --help（例如 openclaw channels --help）来查看完整列表。

⚙️ 1. 配置与初始化 (Setup & Config)

这些命令用于管理 OpenClaw 的核心配置文件 openclaw.json 和运行环境。

configure: 🧑‍💻 (新手推荐) 启动交互式向导。通过一问一答的图形化菜单，配置认证信息、通讯渠道、网关和默认智能体。
config *: 🤖 (熟手/脚本推荐) 非交互式配置工具。直接通过命令行读取或修改配置。
- config set <key> <value>: 修改指定配置项（如 config set tools.profile full）。
- config get <key>: 读取指定配置项的值。
- config unset <key>: 删除指定的配置项。
- config file: 打印当前正在使用的配置文件绝对路径。
onboard: 交互式的“入职向导”，专门用来引导你配置网关、工作区（workspace）和安装基础技能（skills）。
setup: 初始化本地配置和智能体的工作区目录。
doctor: 🏥 运行环境“体检”。检查网关、渠道连通性、技能依赖缺失等问题，并提供修复建议。
reset: 重置本地配置和状态数据（但不会卸载 CLI 工具本身）。
update *: 更新 OpenClaw 版本并检查更新通道状态。
- update check: 检查是否有新版本可用。
uninstall: 彻底卸载网关服务和本地数据。

管理 AI 的“大脑”和“手脚”。

agent: 触发一次单轮的智能体对话交互（直接通过网关运行）。
agents *: 管理隔离的智能体实例。
- agents list: 列出当前系统中存在的所有智能体。
- agents add <name>: 创建一个新的智能体实例。
- agents remove <name>: 删除指定的智能体。
skills *: 🛠️ 列出和管理可用技能。
- skills list: 列出所有技能及其当前状态（ready / missing / blocked）。
- skills info <skill_name>: 查看某个具体技能的详细说明和依赖。
models *: 发现、扫描和配置大模型及其提供商（PI）。
- models list: 列出当前配置中可用的所有大模型。
- models scan: 自动扫描并识别当前环境中支持的本地/远程模型。
memory *: 管理 AI 的长期记忆库。
- memory search <query>: 搜索记忆库中包含关键词的对话上下文。
- memory reindex: 强制重建记忆向量索引（当你修改了大量历史文件时使用）。
sessions *: 列出并管理历史上保存的对话会话（Session）。
- sessions list: 查看最近的对话会话 ID 和时间。
- sessions clear: 清理过期的会话记录释放空间。
hooks *: 管理系统内部的生命周期钩子（例如启动时自动同步文件）。

网关是 OpenClaw 的心脏，这些命令用来控制网关的启停和监控。

gateway *: 核心命令！用于启动、检查和查询 WebSocket 网关。
- gateway start: 以后台进程启动网关。
- gateway stop: 停止正在运行的网关。
- gateway status: 检查网关当前的运行状态和绑定端口。
status: 查看各个通讯渠道的健康状态，以及最近的会话接收者。
health: 从正在运行的网关获取系统健康报告。
logs: 📜 实时查看网关的日志输出（Tail logs），排错必备。
system *: 查看系统事件、心跳包和在线状态。
cron *: 管理网关调度器中的定时任务。
- cron list: 列出所有已注册的自动化定时任务。

控制 AI 如何与外界（微信、Telegram 等）沟通。

channels *: 管理已连接的聊天渠道。
- channels list: 查看当前配置了哪些渠道及其在线状态。
- channels login: 启动登录流程（如显示 WhatsApp 登录二维码）。
- channels logout: 退出并断开指定的聊天渠道。
message *: ✉️ 发送、读取和管理消息。
- message send --target <ID> --message <文字>: 主动发送消息。
- message read: 从特定渠道读取未读消息。
directory *: 通讯录查询。查找支持渠道中的联系人 ID 或群组 ID。

security *: 运行安全审计。
- security audit: 检查本地配置是否有风险（如端口暴露或弱密码）。
pairing *: 安全的私聊配对管理。
- pairing requests: 查看收到的私聊访问申请。
- pairing approve <ID>: 批准某个用户的聊天请求。
devices *: 管理已配对的设备和 Token。
approvals *: 审批 AI 执行某些高危操作的权限请求。
qr: 生成用于 iOS 设备配对或快捷设置的二维码。

dashboard: 🌐 在浏览器中打开 OpenClaw 的可视化 Web 大屏状态控制台。
tui: 打开一个连接到网关的终端字符界面（Terminal UI）。
docs: 在命令行中直接搜索 OpenClaw 的官方实时文档。
browser *: 管理 OpenClaw 专用的自动化浏览器。
- browser install: 安装或更新自带的 Chromium 浏览器引擎。
plugins *: 管理 OpenClaw 的第三方插件和扩展。
sandbox *: 管理智能体执行代码时的沙盒（Docker 容器）隔离环境。

这些参数可以附加在任何命令后面使用：

1. 启动网关服务

openclaw gateway --port 18789

2. 发送测试消息到 Telegram

openclaw message send --channel telegram --target @mychat --message "Hi, 这是一个测试！"

3. 扫码登录个人 WhatsApp

openclaw channels login --verbose

4. 强制重启/覆盖占用端口的网关

openclaw gateway --force

5. 快捷修改配置文件中的模型设置

openclaw config set agents.defaults.model.primary "anthropic/claude-opus-4.6"