openclaw 命令解析大全：按使用频率分类的最佳实践

写在前面

OpenClaw 虽然带着自动化的光环，本质上仍然是一款强命令行工具。很多人刚开始“养虾”时，面对琳琅满目的命令一头雾水——这很正常，官方 CLI 有超过 100 个子命令。但别慌，我们今天就用按使用频率分类的方式，把这些命令理清楚，让你从“命令恐惧”变成“命令肌肉记忆”。

本文基于 OpenClaw v2026.3.13+ 版本整理，所有命令均可通过 openclaw <command> --help 查看详细用法。

全局标志：所有命令的前置选项

在进入具体命令之前，先了解一下“全局标志”——它们可以放在任何命令前面，影响整个 OpenClaw 实例的行为。

全局标志	功能说明
--dev	将状态隔离到 ~/.openclaw-dev 目录下，并变更默认端口
--profile <name>	将状态隔离到 ~/.openclaw-<name> 目录下，便于多环境管理
--no-color	禁用 ANSI 颜色输出
--json / --plain	输出干净 JSON 格式，适合脚本解析
-V, --version, -v	打印版本号并退出
--update	openclaw update 的简写（仅适用于源码安装）

小贴士：--dev 和 --profile 这两个标志非常实用。当你需要同时测试多个配置方案时，不用反复覆盖配置文件，直接切换 Profile 即可，省心省力。

接下来，我们按使用频率从高到低，把命令分成三大板块逐一解析。

第一章：基础入门命令——每天都得用 ⭐⭐⭐⭐⭐

这一章的命令是你跟 OpenClaw 打交道的第一站，也是日常使用频率最高的。新手上路、日常启动、查看状态、出了问题想修一修——全在这块。

1.1 安装与初始化

虽然严格来说 npx 不是 OpenClaw 命令，但这是绝大多数人接触 OpenClaw 的第一步。

# 一键启动（首次体验推荐，自动下载最新版本）
npx openclaw@latest

# 全局安装（频繁使用推荐）
npm install -g openclaw@latest

安装完成后，运行初始化向导：

# 标准引导向导（推荐新手）
openclaw onboard

# 高级引导模式（完整控制每个步骤）
openclaw onboard --advanced

# 后台启动 + 安装守护进程
openclaw onboard --install-daemon

onboard 命令会一步步引导你完成网关设置、模型配置和频道连接。执行后，系统会在 ~/.openclaw/ 目录下生成完整的配置工作区。如果你想让 OpenClaw 开机自启，加上 --install-daemon 就好。

1.2 状态查看

# 查看整体运行状态（包括网关、版本、配置概要）
openclaw status

这是我每天敲得最多的命令——就像看汽车仪表盘一样，启动后先看一眼状态，确认龙虾还“活着”。输出会告诉你网关是否运行、监听哪个端口、当前配置版本等信息。

# 查看 Gateway 健康状态
openclaw health

health 比 status 更聚焦网关本身的健康情况，如果 API 调用超时或频道连接异常，这里会有提示。

1.3 升级与修复

# 升级到最新版本
openclaw update

# 运行诊断并自动修复常见问题
openclaw doctor --fix

OpenClaw 基本保持着日更的节奏。升级不会破坏已有配置，放心跑就行。

doctor --fix 可以说是 OpenClaw 的“自救神器”。配置文件写错了？端口被占了？API Key 格式不对？大部分情况下，一条命令就能自动修复。如果它还搞不定，也会给出明确的错误提示，告诉你该往哪使劲。

第二章：核心运维命令——配置、启动、日常管理 ⭐⭐⭐⭐

当龙虾装好了、跑起来了，接下来就是日常运维——启动服务、切换模型、管理频道。这些命令可能每天都要用，但不像上一章那样“每时每刻”。

2.1 网关生命周期管理

网关（Gateway）是 OpenClaw 的核心服务，负责处理 WebSocket 连接、消息路由和与 AI 代理的交互。OpenClaw 提供了完整的一套生命周期命令：

# 前台启动网关（调试模式，终端关掉服务就停）
openclaw gateway --port 18789

# 后台启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关（应用新配置时常用）
openclaw gateway restart

# 查看网关状态
openclaw gateway status

# 查看网关日志（支持实时追踪）
openclaw gateway logs

如果你想让 OpenClaw 随系统自启动：

# 安装 systemd 服务（Linux/macOS）
openclaw gateway install

一个小坑：openclaw gateway start --background 启动后台服务后，一定要用 openclaw gateway stop 来停止，别直接 kill 进程，否则可能损坏配置文件。

2.2 配置管理

虽然可以直接编辑 ~/.openclaw/openclaw.json，但命令行配置更安全、更不容易手抖打错字：

# 交互式配置向导（推荐）
openclaw configure

# 查看当前配置
openclaw config get

# 设置特定配置项
openclaw config set <key> <value>

# 删除配置项
openclaw config unset <key>

configure 向导会一步步带你完成模型提供商、API Key、频道等核心配置。我个人的经验是：能用向导就别手动改文件——配置文件的 JSON 结构有时会随版本变化，向导会自动处理好兼容性问题。

2.3 模型管理

模型是 AI 的大脑，OpenClaw 支持多种模型提供商（OpenAI、Claude、Qwen、OpenRouter 等）。以下命令帮你管理这些模型：

# 列出所有已配置的模型
openclaw models list

# 扫描可用模型（自动发现新增模型）
openclaw models scan

# 设置默认模型
openclaw models set <模型名称>

# 查看当前默认模型
openclaw models status

示例：切换到 OpenRouter 上的 Claude 模型：

openclaw models set openrouter/anthropic/claude-3.5-sonnet

2.4 频道管理

OpenClaw 的强大之处在于可以接入你日常使用的聊天工具——Telegram、Discord、Slack、飞书、WhatsApp 等。频道管理命令帮你控制这些连接：

# 查看所有频道状态
openclaw channels list

# 查看频道详细状态
openclaw channels status

# 登录特定频道
openclaw channels login <频道名>

# 登出频道
openclaw channels logout <频道名>

# 查看频道健康状态和最近的会话接收方
openclaw status

2.5 诊断与日志

# 查看 Gateway 日志（通过 RPC）
openclaw logs

# 查看会话列表
openclaw sessions list

# 运行安全审计
openclaw security audit

security audit 会检查你的配置中是否存在常见的安全隐患（比如 API Key 硬编码、权限过宽等），强烈建议定期跑一下。加上 --deep 参数还可以进行实时网关探测，加上 --fix 则自动收紧安全配置。

第三章：高级玩家命令——深度定制与自动化 ⭐⭐⭐

这部分命令适合已经熟悉 OpenClaw 基础操作、想要进一步挖掘潜力的进阶用户。它们或许不会天天用到，但关键时候能发挥巨大作用。

3.1 代理与智能体

OpenClaw 支持多代理隔离运行，每个代理可以有独立的工作区、认证和路由策略：

# 创建独立代理
openclaw agents add <代理名>

# 列出所有代理
openclaw agents list

# 删除代理
openclaw agents delete <代理名>

# 运行一次性代理任务
openclaw agent --to +15555550123 --message "汇总今天的消息" --deliver

3.2 Skills 技能管理

Skills 是 OpenClaw 的“能力扩展包”——让 AI 能够读写文件、执行 Shell 命令、抓取网页等：

# 列出已安装的技能
openclaw skills list

# 搜索可用技能
openclaw skills search <关键词>

# 安装技能
openclaw skills install <技能名>

# 检查技能信息
openclaw skills info <技能名>

提醒一句：安装第三方 Skill 时务必看清楚权限范围。有些 Skill 会申请全盘读写或系统命令执行权限，建议优先使用官方渠道的 Skill，并定期用 openclaw security audit 检查。

3.3 设备配对与审批

OpenClaw 支持将手机或其他设备通过配对方式关联，并可以对敏感操作设置审批流程：

# 查看待审批的设备配对请求
openclaw devices list

# 批准配对请求
openclaw devices approve <requestId>

# 拒绝配对请求
openclaw devices reject <requestId>

# 管理执行审批
openclaw approvals get
openclaw approvals set <规则>

3.4 定时任务（Cron）

OpenClaw 内置了 Cron 调度器，可以让你的 AI 助理定时执行任务：

# 查看当前定时任务
openclaw cron list

# 添加定时任务
openclaw cron add "<cron表达式>" "<任务描述>"

# 编辑定时任务
openclaw cron edit <任务ID>

# 启用/禁用定时任务
openclaw cron enable <任务ID>
openclaw cron disable <任务ID>

# 删除定时任务
openclaw cron rm <任务ID>

3.5 数据备份与记忆管理

# 创建本地备份
openclaw backup create

# 验证备份文件
openclaw backup verify

# 搜索长期记忆
openclaw memory search <关键词>

# 重建记忆索引
openclaw memory index

3.6 TUI 终端对话模式

当你不想打开聊天软件，或者 Bot 恰好出问题时，可以直接在终端里对话：

# 启动 TUI 终端对话界面
openclaw tui

这个命令会直接在终端里打开一个对话界面，体验类似命令行版的 ChatGPT。调试时非常方便，不用切来切去。

3.7 浏览器自动化

OpenClaw 内置浏览器自动化能力，可以让 AI 帮你操作网页：

# 查看浏览器状态
openclaw browser status

# 启动浏览器
openclaw browser start

# 截图
openclaw browser screenshot

# 导航到指定 URL
openclaw browser navigate <url>

# 点击元素
openclaw browser click <selector>

# 填写表单
openclaw browser fill <selector> <value>

3.8 密钥与插件管理

# 密钥热重载（无需重启服务）
openclaw secrets reload

# 列出插件
openclaw plugins list

# 安装插件
openclaw plugins install <插件名>

# 启用/禁用插件
openclaw plugins enable <插件名>
openclaw plugins disable <插件名>

第四章：高级玩家命令——多 Agent 协同编排

当我们配置好了多个独立的 Agent 后，如何高效地管理和启动它们就成了新的挑战。此时，multi-agent 命令就派上了用场，它允许你像管理一个微服务集群一样管理你的 Agent 团队。

#启动所有已配置的 Agent。
openclaw multi-agent --start

#按需启动指定的 Agent，例如 `openclaw multi-agent --start customer`
openclaw multi-agent --start <agent-name>

#验证启动状态，应输出类似 `customer_service: running` 的结果
openclaw multi-agent --status

附录：按频率分类的命令速查表

频率等级	命令分类	常用命令示例	使用场景
⭐⭐⭐⭐⭐	启动与安装	npx openclaw@latest、openclaw onboard	首次安装、每日启动
⭐⭐⭐⭐⭐	状态查看	openclaw status、openclaw health	确认服务运行状态
⭐⭐⭐⭐⭐	修复诊断	openclaw doctor --fix	出问题时第一反应
⭐⭐⭐⭐	网关管理	openclaw gateway start/stop/restart	服务启停、配置重载
⭐⭐⭐⭐	模型切换	openclaw models list/set	切换 AI 模型
⭐⭐⭐⭐	频道管理	openclaw channels list/login	管理聊天平台连接
⭐⭐⭐⭐	升级	openclaw update	保持版本最新
⭐⭐⭐	配置管理	openclaw configure、openclaw config get/set	修改配置
⭐⭐⭐	Skills	openclaw skills list/install	扩展 AI 能力
⭐⭐⭐	设备配对	openclaw devices list/approve	连接手机等设备
⭐⭐⭐	安全审计	openclaw security audit	定期安全检查
⭐⭐	定时任务	openclaw cron add/list	设置自动化任务
⭐⭐	备份	openclaw backup create	数据备份
⭐⭐	TUI	openclaw tui	终端直接对话
⭐	浏览器	openclaw browser navigate/click	网页自动化

写在最后

OpenClaw 的命令虽然多，但没必要一次性全记住。我的建议是：先把前两章的命令用熟，足够应付 80% 的日常场景了。剩下的高级命令，等你真正需要扩展能力、定制行为时，自然会去找，那时候再看一遍，印象更深。

如果你在“养虾”过程中遇到什么疑难杂症，或者发现了特别实用的命令组合，欢迎在评论区交流。技术这条路，大家一起摸索才更有趣。

Happy Clawing！🦞

---