Openclaw 常用操作命令速查表(cheatsheet)

安装配置过五六次 openclaw 之后，我发现小龙虾最大的问题是配置文件变更太快且很多时候不考虑兼容性。

经常是查资料发现资料已经过时了，或者一升级，发现配置文件出错，启动不起来。

在这种背景下，我发现要搞定 openclaw 最好的办法是尽量用命令行操作，不要直接修改配置文件。

所以我做了这份速查表（cheatsheet）。

这份速查表按照真实的使用生命周期编排：从零开始的初始化、全局配置、Agent 管理、渠道接入，一直到后期的日常运维与安全隔离。

🦞 OpenClaw CLI 全流程速查表 (Cheatsheet)

❝
版本参考: OpenClaw 2026.3.28
核心理念: 将你的设备转化为私人的、永远在线的 AI Agent 运行环境。

1. 🚀 初始化与基础设置 (Setup & Init)

第一次接触 OpenClaw 时，需要建立本地环境与初始配置。

命令	说明	示例 / 备注
`openclaw setup`	初始化本地配置目录和 Agent 默认工作区	创建基础结构，通常是你运行的第一条命令
`openclaw configure`	启动交互式向导配置（凭证、渠道、网关等）	适合新手，按提示一步步绑定 API Key 等
`openclaw qr`	生成用于 iOS App 配对的 QR 码	方便手机端接管与监控本地 Agent
`openclaw completion`	生成 Shell 自动补全脚本	`source <(openclaw completion)`
`openclaw doctor`	检查/修复配置的万金油	`openclaw doctor --fix`

2. ⚙️ 配置与凭证管理 (Config & Secrets)

OpenClaw 采用“双层配置模型”（全局 ~/.config/openclaw/ 与项目级 openclaw.json），局部配置优先。

命令	说明	示例 / 备注
`openclaw config get <key>`	读取特定配置项的值	`openclaw config get agents.defaults.model.primary`
`openclaw config set <k> <v>`	非交互式写入配置	`openclaw config set agents.defaults.model.primary gpt-5.4`
`openclaw config validate`	验证当前配置文件的合法性	报错时排查 JSON 语法或层级问题
`openclaw config reset`	恢复指定的配置项到默认状态	`openclaw config reset agents.defaults`
`openclaw secrets *`	运行时安全凭证管理，支持热重载	管理 API Keys 且不在明文日志中暴露

3. 🧠 智能体管理 (Agent Management)

OpenClaw 允许你运行多个隔离的 Agent，每个可以有独立的人设、模型路由和绑定的通讯渠道。

命令	说明	示例 / 备注
`openclaw agents add <name>`	创建并注册新的 Agent	`openclaw agents add ops-bot --workspace ~/.openclaw/ops`
`openclaw agents list`	列出当前所有已注册的 Agent	配合 `--verbose` 或 `--format json` 查看详情
`openclaw agents bind`	将特定渠道流量路由给特定 Agent	`openclaw agents bind --agent ops-bot --bind telegram:ops`
`openclaw agents unbind`	解除渠道绑定	`openclaw agents unbind --agent ops-bot --all`
`openclaw agents set-identity`	设置 Agent 的人设、头像和 Emoji	`openclaw agents set-identity --agent ops-bot --emoji "👷"`
`openclaw agent`	通过 Gateway 触发单次 Agent 交互	`openclaw agent --agent ops-bot --message "汇总今日日志"`

4. 💬 渠道与消息互动 (Channels & Messaging)

这是 OpenClaw 的杀手锏，让 Agent 直接寄宿在你常用的聊天软件中（WhatsApp, Telegram 等）。

命令	说明	示例 / 备注
`openclaw channels login`	登录并连接新的聊天渠道	`openclaw channels login --verbose` (会在终端打印扫码登录的二维码)
`openclaw channels *`	管理所有已连接的聊天渠道	查看连接状态、断开连接等
`openclaw message send`	通过已绑定的渠道主动发送消息	`openclaw message send --channel telegram --target @username --message "Hi"`

5. 🔌 技能与扩展 (Skills & Plugins)

让 Agent 拥有与外界交互的能力（如读写文件、发邮件、调用 MCP 服务器）。

命令	说明	示例 / 备注
`openclaw skills *`	列出和检查本地可用的 Skills	也可以通过社区工具如 `clawhub install <skill>` 安装
`openclaw plugins *`	管理底层系统插件和扩展	扩展 OpenClaw 核心能力的底层模块

6. 🛠️ 服务启动与日常运维 (Gateway & Operations)

Gateway（网关）是 OpenClaw 的心脏，负责维持长连接、计划任务和分发消息。

命令	说明	示例 / 备注
`openclaw gateway`	在本地启动 WebSocket 网关	`openclaw gateway --port 18789`
`openclaw gateway --force`	强制杀死占用端口的旧网关并启动	解决僵尸进程导致端口占用的问题
`openclaw tui`	启动终端图形界面 (TUI)	在命令行中直观监控 Gateway、Agent 日志和对话流
`openclaw status`	查看系统健康度	展示各个 Channel 的健康状态及最近消息接收方
`openclaw sessions *`	管理对话上下文会话	查看或清理长期占用的历史记忆片段
`openclaw cron *`	管理网关中的定时任务	让 Agent 每天早上 8 点自动执行汇报总结
`openclaw system *`	系统事件、心跳包与在线状态检测	监控底层连通性

7. 🛡️ 安全隔离与备份 (Security, Isolation & Backup)

为了防止 AI 执行危险操作，OpenClaw 提供了强大的沙盒与安全管控。

命令	说明	示例 / 备注
`openclaw sandbox *`	管理 Agent 的容器沙盒隔离	限制 Agent 只能在指定 Docker/Podman 沙盒中执行代码
`openclaw approvals *`	管理敏感操作审批	配置当 Agent 尝试高危动作（如 `rm -rf`）时，需推送到手机端人工确认
`openclaw security *`	本地配置安全审计与合规检查	扫描是否存在敏感 Key 明文泄露等风险
`openclaw backup *`	本地状态及记忆备份	`openclaw backup create` / `verify`

8. 🧰 环境标签与全局选项 (Global Options)

这些参数可以附加在任何命令上，用于控制运行环境。

参数	说明	示例 / 备注
`--dev`	开发者模式	将状态隔离在 `~/.openclaw-dev`，默认网关端口偏移到 `19001`，非常适合测试环境。
`--profile <name>`	多租户/环境隔离	`openclaw --profile work gateway` ，环境完全隔离（相当于独立的一套系统）。
`--container <name>`	容器内执行	在指定的 Docker/Podman 容器内运行该 CLI 指令。
`--log-level <lv>`	日志级别控制	`trace` , `debug`, `info`, `warn`, `error`, `fatal`, `silent`

9. 🗑️ 卸载与重置 (Reset & Uninstall)

当你需要从头再来时的急救命令。

命令	说明	备注
`openclaw reset`	软重置：清空本地配置和状态	保留 CLI 本体，仅仅将配置恢复出厂设置
`openclaw uninstall`	硬重置：彻底卸载	停止网关服务，删除本地数据（CLI 执行文件依然保留）

10. 🧠 模型管理 (Models)

定位：Agent 的“大脑”。管理本地运行的开源模型（如 Llama、Qwen）以及云端商业 API（如 Gemini、GPT-4）。

命令	说明	示例 / 备注
`openclaw models add`	安装新模型	交互式安装。命令不带参数，直接执行。
`openclaw models list`	列出当前可用的所有模型	包含本地已下载的和已配置 API 密钥的云端模型
`openclaw models pull <name>`	下载/拉取本地模型权重	`openclaw models pull llama3:8b` (依赖本地推理引擎)
`openclaw models add-provider`	交互式添加新的模型供应商	配置 OpenAI, Anthropic, Google 等提供商的接入点
`openclaw models set-default`	设置全局默认使用的模型	`openclaw models set-default gpt-4o`
`openclaw models inspect <name>`	查看特定模型的上下文窗口和参数	`openclaw models inspect gemini-1.5-pro`

11. 🛠️ 技能与工具 (Skills)

定位：Agent 的“手脚”。Skills 相当于 Function Calling（函数调用）的封装集合，让 Agent 能够执行具体的任务（如联网搜索、读写文件、操作日历）。

命令	说明	示例 / 备注
`openclaw skills list`	查看已安装的技能列表	`openclaw skills list --agent ops-bot` 查看特定 Agent 的可用技能
`openclaw skills install`	从官方/社区源安装新技能	`openclaw skills install mcp-github` (例如安装 Github 操作技能)
`openclaw skills remove`	卸载指定的技能	`openclaw skills remove web-scraper`
`openclaw skills inspect`	检查技能的具体权限与工具集	查看该技能是否包含高危操作（如删除文件、发送邮件）
`openclaw skills grant`	为指定 Agent 授权特定技能	`openclaw skills grant --agent ops-bot --skill mcp-github`

12. 🧩 插件与底层扩展 (Plugins)

定位：OpenClaw 系统的“神经系统”。Plugins 用于扩展 CLI 框架自身的能力，例如新增一种 Vector DB（向量数据库）支持、新增一种聊天渠道（Channel）协议等。

命令	说明	示例 / 备注
`openclaw plugins list`	列出当前安装的所有系统插件	显示插件版本、运行状态和加载耗时
`openclaw plugins add`	安装新的底层插件	`openclaw plugins add @openclaw/plugin-wechat-weipad` (通过 npm 包或 Git 链接安装)
`openclaw plugins enable <name>`	启用指定插件	`openclaw plugins enable custom-logger`
`openclaw plugins disable <name>`	禁用指定插件	遇到框架崩溃或冲突时，可用于排查问题
`openclaw plugins update`	更新所有已安装的插件到最新版	`openclaw plugins update --all`

💡 核心概念辨析 (TL;DR):

Model (模型): 决定你的 Agent 有多聪明（智商）。
Skill (技能): 决定你的 Agent 能干什么活（行动力），是面向 Agent 的功能。
Plugin (插件): 决定 OpenClaw 系统能支持什么基础设施，是面向系统的架构扩展。

💡 高阶玩法提示： 如果想要调试特定的新模型，你可以直接使用 --dev 启动隔离环境（openclaw --dev gateway），然后在这个沙盒环境中进行破坏性测试，完全不会影响你主线日常使用的 Agent 记忆和配置。