CLI 命令大全

🦞 OpenClaw 命令大全

所有命令都有通俗易懂的中文解释，让你像查字典一样快速找到需要的操作。不用啃英文文档，直接查阅即可。

• 📌 基础格式：openclaw <命令> [选项]
• 🔗 官方文档：docs.openclaw.ai/cli

安装与初始化

openclaw setup

首次安装后的初始化配置，创建配置文件和工作空间。

通俗解释：就像新买了一部手机第一次开机要设置语言、Wi-Fi 一样，setup 是你安装完 OpenClaw 后”第一次开机”的过程。它会帮你创建配置文件、设置工作目录。

常用选项：

• --wizard — 启动交互式引导向导（手把手教你配置）
• --non-interactive — 无人值守模式（不弹出提示，全自动）
• --workspace <路径> — 指定工作空间目录（默认 ~/.openclaw/workspace）
• --remote-url <地址> — 连接远程 Gateway 的地址
• --remote-token <令牌> — 远程 Gateway 的认证令牌
• --mode <模式> — 选择向导模式

# 最简单的方式：启动交互式向导
$ openclaw setup --wizard

# 指定工作目录
$ openclaw setup --workspace ~/my-openclaw

# 连接远程服务器（无需交互）
$ openclaw setup --remote-url wss://my-server.com --remote-token xxx --non-interactive

openclaw onboard

交互式新手引导向导，一步步带你设置 Gateway、工作空间和技能。

通俗解释：比 setup 更强大的”新手大礼包”——不仅创建配置，还会一步步引导你设置 Gateway 网关、聊天渠道、AI 模型密钥、技能等等。第一次用 OpenClaw 推荐跑这个。

常用选项：

• --non-interactive — 全自动无交互模式
• --anthropic-api-key <key> — 直接传入 Anthropic API Key
• --openai-api-key <key> — 直接传入 OpenAI API Key
• --gemini-api-key <key> — 直接传入 Gemini API Key
• --openrouter-api-key <key> — 直接传入 OpenRouter API Key
• --gateway-port <端口> — 指定 Gateway 端口
• --skip-ui — 跳过 UI 设置
• --skip-channels — 跳过聊天渠道设置
• --skip-skills — 跳过技能设置
• --reset — 先重置再开始向导
• --install-daemon — 安装后台守护进程

# 交互式引导（推荐新手）
$ openclaw onboard

# 非交互式，传入 API Key
$ openclaw onboard --non-interactive --anthropic-api-key sk-xxx --install-daemon

# 重置后重新引导
$ openclaw onboard --reset

openclaw doctor

健康检查 + 自动修复（配置、Gateway、旧版迁移）。

通俗解释：相当于给小龙虾做一次”体检”——检查配置文件有没有问题、Gateway 是否正常、有没有需要迁移的旧版设置，发现问题还能自动帮你修。升级后建议跑一次。

常用选项：

• --deep — 深度扫描系统服务
• --non-interactive — 跳过提示，只应用安全迁移
• --yes — 全部同意默认选项（无头模式）
• --no-workspace-suggestions — 不显示工作空间记忆提示

$ openclaw doctor
$ openclaw doctor --deep
$ openclaw doctor --non-interactive --yes

配置管理

openclaw configure

交互式配置向导（模型、渠道、技能、Gateway 一站式设置）。

通俗解释：打开一个”设置菜单”，像手机设置一样一项一项引导你配置模型、聊天渠道、技能、Gateway 等。适合想调整已有配置的用户。

$ openclaw configure

openclaw config get / set / unset

读取、修改、删除配置项（精确控制单个配置值）。

通俗解释：像”微调旋钮”——不用打开整个设置向导，直接读取或修改某一项配置。路径格式支持点分隔（如 gateway.auth.mode）。

子命令：

• config get <路径> — 查看某个配置的当前值
• config set <路径> <值> — 设置配置值（支持 JSON5 或纯字符串）
• config unset <路径> — 删除某个配置
• config file — 显示配置文件路径
• config validate — 验证当前配置是否合法

# 查看 Gateway 端口
$ openclaw config get gateway.port

# 修改 Gateway 认证模式为 token
$ openclaw config set gateway.auth.mode token

# 删除某个配置
$ openclaw config unset gateway.auth.password

# 查看配置文件在哪里
$ openclaw config file

# 验证配置是否合法
$ openclaw config validate --json

openclaw dashboard

打开 Web 管理面板。

通俗解释：在浏览器里打开一个可视化管理面板，不用记命令也能管理 OpenClaw。

$ openclaw dashboard

openclaw completion

生成终端自动补全脚本（Tab 键补全命令）。

通俗解释：让你在终端输入 openclaw 后按 Tab 键就能自动补全命令，省得记那么多命令名。支持 bash、zsh、fish。

$ openclaw completion

聊天渠道管理

openclaw channels list

列出已配置的所有聊天渠道和认证信息。

通俗解释：查看你的小龙虾连接了哪些聊天平台——WhatsApp、Telegram、Discord、Slack 等等，一目了然。

$ openclaw channels list
$ openclaw channels list --json

openclaw channels add

添加新的聊天渠道（支持向导式或命令行传参）。

通俗解释：想让小龙虾接入 Telegram 或 Discord？用这个命令添加新渠道。不带参数会启动向导引导你一步步设置。

常用选项：

• --channel <渠道名> — whatsapp / telegram / discord / slack / signal / imessage / googlechat / msteams
• --account <账号ID> — 账号标识（默认 default）
• --name <名称> — 显示名称
• --token <令牌> — Bot Token

# 交互式添加
$ openclaw channels add

# 直接添加 Telegram Bot
$ openclaw channels add --channel telegram --account alerts --name "通知机器人" --token $TELEGRAM_BOT_TOKEN

# 添加 Discord Bot
$ openclaw channels add --channel discord --account work --name "工作助手" --token $DISCORD_BOT_TOKEN

openclaw channels remove

移除已配置的聊天渠道。

通俗解释：不想用某个渠道了？用这个命令断开连接。默认只禁用，加 --delete 才是彻底删掉配置。

$ openclaw channels remove --channel discord --account work --delete

openclaw channels status

检查各渠道的连接状态和健康情况。

通俗解释：相当于看看各个聊天平台的”信号灯”——连接正常亮绿灯，有问题会提示你怎么修。

$ openclaw channels status
$ openclaw channels status --probe  # 跑额外检查

openclaw channels login / logout

登录或登出渠道（如 WhatsApp Web 扫码登录）。

通俗解释：有些渠道（如 WhatsApp）需要扫码登录才能用。这个命令就是帮你完成登录/登出操作的。

$ openclaw channels login --channel whatsapp
$ openclaw channels logout --channel whatsapp

openclaw channels logs

查看渠道的最近日志（排查问题用）。

通俗解释：渠道连不上？消息发不出去？看看日志找线索。

$ openclaw channels logs
$ openclaw channels logs --channel telegram --lines 100

openclaw pairing list / approve

管理渠道的 DM 配对请求（列出待审批、批准配对）。

通俗解释：当有人通过私聊(DM)想和你的小龙虾配对时，这里可以看到请求并决定是否批准。

$ openclaw pairing list
$ openclaw pairing approve --channel telegram --notify

openclaw qr

显示 WhatsApp 登录二维码。

通俗解释：在终端里显示 WhatsApp Web 的二维码，用手机扫一扫就能登录。

$ openclaw qr

openclaw directory

查看联系人/频道目录缓存。

通俗解释：列出小龙虾缓存的联系人和频道信息，方便你知道它”认识”谁。

$ openclaw directory

Agent 智能体

openclaw agent

运行一次 Agent 对话（通过 Gateway 或本地嵌入式）。

通俗解释：直接给 AI 智能体下达一条指令并获取回复。可以指定发送给谁、用哪个 session、甚至要求 AI “深度思考”。

常用选项：

• --message <内容> — 必填，你要说的话
• --to <目标> — 发给谁（手机号、联系人等）
• --agent <名称> — 指定使用哪个 Agent
• --deliver — 发送后把回复投递给目标
• --local — 使用本地嵌入式模式（不走 Gateway）
• --session-id <ID> — 指定会话 ID（保持上下文）
• --thinking <级别> — 思考深度（仅支持部分模型）
• --timeout <秒数> — 超时时间

# 给联系人发消息并投递回复
$ openclaw agent --to +15555550123 --message "帮我查一下今天的天气" --deliver

# 用指定 Agent 跑任务
$ openclaw agent --agent ops --message "总结一下日志"

# 开启深度思考
$ openclaw agent --message "分析这个问题" --thinking medium

openclaw agents list

列出所有已配置的 Agent 智能体。

通俗解释：看看你养了几只”小龙虾”——每个 Agent 都是一个独立的 AI 助手，有自己的工作空间和配置。

$ openclaw agents list
$ openclaw agents list --json --bindings

openclaw agents add

创建新的隔离 Agent（独立工作空间 + 认证 + 路由）。

通俗解释：想要一个专门处理运维的 Agent 和一个专门回消息的 Agent？用这个命令创建新的独立智能体，每个有自己的”房间”（工作空间）。

# 交互式创建
$ openclaw agents add

# 非交互式创建，并绑定到 Telegram 渠道
$ openclaw agents add ops --workspace ~/agents/ops --bind telegram --non-interactive

openclaw agents delete

删除一个 Agent 及其工作空间和状态。

$ openclaw agents delete ops
$ openclaw agents delete ops --force

openclaw agents bind / unbind

为 Agent 添加或移除渠道路由绑定。

通俗解释：决定某个 Agent 负责哪个聊天渠道——比如让”运维 Agent”只处理 Slack 消息，让”客服 Agent”只处理 Telegram 消息。

# 绑定到 Slack 渠道
$ openclaw agents bind --agent ops --bind slack

# 解除所有绑定
$ openclaw agents unbind --agent ops --all

openclaw acp

ACP 桥接 — 将 IDE 编辑器连接到 Gateway。

通俗解释：让你的代码编辑器（如 VS Code、Cursor）和 OpenClaw Gateway 对接，这样 AI 可以直接在 IDE 里帮你写代码。

$ openclaw acp

openclaw sessions

列出已存储的对话会话。

通俗解释：查看小龙虾和谁聊过天、有哪些对话记录在”记忆”里。

$ openclaw sessions
$ openclaw sessions --json --verbose

openclaw tui

打开终端交互界面（TUI），在命令行里和 Agent 聊天。

通俗解释：在终端里打开一个聊天窗口，直接和 AI 对话，不需要通过其他平台。适合开发者在命令行里快速提问。

$ openclaw tui
$ openclaw tui --message "帮我写一个 Python 脚本"

消息与发送

openclaw message send

发送消息到指定渠道的指定目标（支持文字、图片、回复）。

通俗解释：从命令行直接发消息！可以发到 WhatsApp、Telegram、Discord、Slack 等任意已配置的平台。支持发文字、图片、回复消息等。

常用选项：

• --channel <渠道> — 发到哪个平台
• --target <目标> — 发给谁（频道ID / 用户ID / 手机号 等）
• --message <内容> — 消息内容
• --media <文件> — 附加图片/文件
• --reply-to <消息ID> — 回复某条消息
• --thread-id <线程ID> — 在特定线程中发送

# 给 WhatsApp 联系人发消息
$ openclaw message send --target +15555550123 --message "你好！"

# 在 Discord 频道发消息
$ openclaw message send --channel discord --target channel:123 --message "大家好"

# 回复某条消息
$ openclaw message send --channel discord --target channel:123 --message "收到" --reply-to 456

openclaw message poll

创建投票（支持 WhatsApp / Telegram / Discord / Teams）。

通俗解释：在群里发起一个投票，比如”今天午餐吃什么？“——团队成员可以投票选择。

# Discord 投票
$ openclaw message poll --channel discord --target channel:123 \
  --poll-question "今天吃什么？" --poll-option 火锅 --poll-option 烧烤 --poll-multi

# Telegram 投票（2分钟自动关闭）
$ openclaw message poll --channel telegram --target @mychat \
  --poll-question "周末聚餐？" --poll-option 周六 --poll-option 周日 \
  --poll-duration-seconds 120

openclaw message react

给消息添加/移除表情反应。

通俗解释：给某条消息点个”赞”或者加个表情反应，比如 ✅ 表示已处理。

$ openclaw message react --channel slack --target C123 --message-id 456 --emoji "✅"
$ openclaw message react --channel discord --target channel:123 --message-id 789 --emoji "👍"

openclaw message read / edit / delete / pin / search

读取消息历史、编辑、删除、置顶、搜索消息。

通俗解释：全方位操作消息——翻看历史记录、编辑已发送的消息、删除消息、置顶重要消息、搜索频道内容。

子命令：

• message read --target <目标> — 读取消息历史
• message edit --message-id <ID> --message <内容> — 编辑消息
• message delete --message-id <ID> — 删除消息
• message pin / unpin --message-id <ID> — 置顶/取消置顶
• message search --query <关键词> — 搜索消息（Discord）

$ openclaw message read --channel slack --target C123 --limit 50
$ openclaw message search --channel discord --guild-id 123 --query "部署"

openclaw message thread create / list / reply

管理 Discord 帖子/线程（创建、列出、回复）。

$ openclaw message thread create --channel discord --target channel:123 --thread-name "讨论帖"
$ openclaw message thread reply --channel discord --target 456 --message "同意！"

openclaw message broadcast

群发消息给多个目标。

通俗解释：一次性给多个人或多个频道发消息，适合通知公告。支持 --dry-run 先预览不实际发送。

$ openclaw message broadcast --channel discord --targets channel:1 --targets channel:2 --message "系统维护通知"

openclaw message kick / ban / timeout

Discord 管理操作 — 踢人、封禁、禁言。

$ openclaw message kick --channel discord --guild-id 123 --user-id 456 --reason "违规"
$ openclaw message ban --channel discord --guild-id 123 --user-id 456
$ openclaw message timeout --channel discord --guild-id 123 --user-id 456 --duration-min 30

模型管理

openclaw models status

查看模型配置状态（认证信息、API Key 是否有效）。

通俗解释：检查你配置的 AI 模型（如 Claude、GPT、Gemini）的”健康状况”——API Key 是否过期、OAuth 是否正常、能不能正常调用。

常用选项：

• --probe — 发送实际请求测试模型（会消耗少量额度）
• --check — 只检查认证状态（不发请求）
• --json — JSON 格式输出

$ openclaw models status
$ openclaw models status --probe

openclaw models list

列出所有可用模型。

$ openclaw models list
$ openclaw models list --provider openai
$ openclaw models list --local  # 只看本地模型

openclaw models set / set-image

设置默认文本模型和图像模型。

通俗解释：决定小龙虾默认用哪个 AI 大脑来思考和画图。

# 设置默认文本模型
$ openclaw models set claude-sonnet-4-20250514

# 设置默认图像模型
$ openclaw models set-image dall-e-3

openclaw models scan

自动扫描和发现可用的 AI 模型。

通俗解释：让小龙虾自动”嗅探”你的 API Key 能用哪些模型，省得手动一个个配置。

$ openclaw models scan
$ openclaw models scan --set-default --yes  # 扫描并自动设为默认

openclaw models auth add / setup-token / paste-token

添加或配置模型 API 认证信息。

通俗解释：告诉小龙虾你的 API Key 或 Token，这样它才能调用各家 AI 模型。

子命令：

• auth add — 交互式添加认证
• auth setup-token --provider anthropic — 自动设置 Anthropic Token
• auth paste-token --provider <名称> — 手动粘贴 Token

$ openclaw models auth add
$ openclaw models auth setup-token --provider anthropic --yes

openclaw models fallbacks / image-fallbacks

设置模型故障转移（主模型挂了自动切换到备选）。

通俗解释：给 AI 模型设置”候补队员”——如果主力模型挂了或者限速了，自动换一个备用模型继续工作。

$ openclaw models fallbacks list
$ openclaw models fallbacks add gpt-4o
$ openclaw models fallbacks remove gpt-4o
$ openclaw models fallbacks clear

openclaw models aliases

管理模型别名（给长模型名起个简短的昵称）。

$ openclaw models aliases list
$ openclaw models aliases add claude claude-sonnet-4-20250514

openclaw models auth order get / set / clear

管理模型提供商的认证优先级顺序。

通俗解释：当多个提供商都有同样的模型时，决定先用谁的——比如优先用 Anthropic 直连，不行再用 OpenRouter。

$ openclaw models auth order get
$ openclaw models auth order set anthropic openrouter
$ openclaw models auth order clear

Gateway 网关

openclaw gateway / gateway run

前台启动 Gateway WebSocket 服务。

通俗解释：Gateway 是小龙虾的”神经中枢”——所有消息收发、AI 调用、工具执行都通过它。这个命令启动它（前台模式，关掉终端就停）。

常用选项：

• --port <端口> — 指定端口（默认 18789）
• --token <令牌> — 设置认证 Token
• --password <密码> — 设置认证密码
• --force — 强制启动（杀掉占用端口的进程）
• --verbose — 输出详细日志
• --dev — 开发模式
• --tailscale <模式> — 通过 Tailscale 暴露

$ openclaw gateway
$ openclaw gateway --port 8080 --force --verbose

openclaw gateway install / start / stop / restart / uninstall

管理 Gateway 后台服务（安装、启动、停止、重启、卸载）。

通俗解释：把 Gateway 装成后台服务——开机自动启动，关掉终端也不会停。就像把程序设成”开机自启”。

# 安装为系统服务
$ openclaw gateway install

# 启动/停止/重启
$ openclaw gateway start
$ openclaw gateway stop
$ openclaw gateway restart

# 卸载服务
$ openclaw gateway uninstall

openclaw gateway status / health / probe

查看 Gateway 运行状态和健康情况。

通俗解释：

• status — 综合状态（服务 + 探测）
• health — 简单健康检查
• probe — “全面体检”，同时探测本地和远程网关

$ openclaw gateway status
$ openclaw gateway health --json
$ openclaw gateway probe  # 最全面的诊断

openclaw gateway call

底层 RPC 调用（直接调用 Gateway 接口）。

通俗解释：高级玩法——直接调用 Gateway 的底层接口。适合脚本化操作或调试。

$ openclaw gateway call status
$ openclaw gateway call logs.tail --params '{"sinceMs": 60000}'
$ openclaw gateway call config.patch --params '{"data": {"some": "value"}}'

openclaw gateway discover

在局域网中发现其他 Gateway 实例（Bonjour / mDNS）。

通俗解释：在同一个局域网内”搜索”是否有其他 OpenClaw Gateway 在运行，方便多设备互联。

$ openclaw gateway discover
$ openclaw gateway discover --json --timeout 4000

浏览器控制

openclaw browser start / stop / status

启动、停止、查看浏览器控制服务。

通俗解释：让小龙虾能控制一个浏览器——打开网页、点按钮、截图等等。支持 Chrome、Brave、Edge。

$ openclaw browser start
$ openclaw browser status
$ openclaw browser stop

openclaw browser tabs / open / close / focus

管理浏览器标签页（查看、打开、关闭、切换）。

$ openclaw browser tabs  # 查看所有标签页
$ openclaw browser open https://github.com  # 打开网页
$ openclaw browser focus abc123  # 切换到某个标签
$ openclaw browser close abc123  # 关闭标签

openclaw browser screenshot / snapshot

截图或获取页面结构快照。

通俗解释：

• screenshot — 截取网页图片
• snapshot — 获取页面的 DOM/ARIA 结构（供 AI 理解页面内容）

$ openclaw browser screenshot --full-page
$ openclaw browser snapshot --format ai

openclaw browser navigate / click / type / hover / drag

浏览器自动化操作（导航、点击、输入、悬停、拖拽）。

通俗解释：让小龙虾像人一样操作网页——打开链接、点按钮、填表单、拖拽元素。

$ openclaw browser navigate https://example.com
$ openclaw browser click ref123  # 点击元素
$ openclaw browser type ref456 "Hello World"  # 输入文字
$ openclaw browser fill --fields '{"name":"张三","email":"test@test.com"}'

openclaw browser profiles / create-profile / delete-profile

管理浏览器配置文件（隔离不同的浏览器环境）。

通俗解释：每个 profile 是一个独立的浏览器环境——不同的 Cookie、登录状态等。可以一个用来办公，一个用来测试。

$ openclaw browser profiles
$ openclaw browser create-profile --name work --color "#FF5A36"
$ openclaw browser --browser-profile work tabs

openclaw browser pdf / evaluate / console

导出 PDF、执行 JS 脚本、查看控制台输出。

$ openclaw browser pdf  # 将当前页面导出为 PDF
$ openclaw browser evaluate --fn "document.title"  # 执行 JS
$ openclaw browser console  # 查看控制台日志

Node 节点

openclaw node run / install / start / stop / status

运行或管理 Node Host 服务（远程设备上的代理）。

通俗解释：Node Host 就像你在另一台电脑上安排的”分身”——让 Gateway 可以远程控制那台机器上的浏览器、执行命令等。

$ openclaw node run --host my-server.com --port 18789
$ openclaw node install --host my-server.com --port 18789
$ openclaw node status

openclaw nodes list / status / approve / reject

管理已连接的远程节点（查看、审批、拒绝）。

$ openclaw nodes list
$ openclaw nodes status --connected
$ openclaw nodes approve <requestId>
$ openclaw nodes pending  # 查看待审批节点

openclaw nodes run / invoke / notify

在远程节点上执行命令、发送通知。

通俗解释：远程遥控其他机器——在节点上跑命令、发通知，就像 SSH 但通过 OpenClaw Gateway。

# 在远程节点执行命令
$ openclaw nodes run --node my-mac "ls -la"

# 发送通知到节点
$ openclaw nodes notify --node my-mac --title "提醒" --body "部署完成！"

openclaw nodes camera snap / clip / list

远程控制节点摄像头（拍照、录像）。

$ openclaw nodes camera list --node my-mac
$ openclaw nodes camera snap --node my-mac --facing front
$ openclaw nodes camera clip --node my-mac --duration 10

openclaw nodes screen / canvas / location

远程录屏、Canvas 画布控制、获取位置信息。

$ openclaw nodes screen record --node my-mac --duration 30
$ openclaw nodes canvas snapshot --node my-mac
$ openclaw nodes location get --node my-iphone

openclaw devices list / approve / remove / rotate

管理设备配对和令牌。

$ openclaw devices list
$ openclaw devices approve <requestId>
$ openclaw devices remove <deviceId>
$ openclaw devices rotate --device abc --role admin

定时任务

openclaw cron add

创建定时任务（按时间间隔或 cron 表达式）。

通俗解释：像设闹钟一样——让小龙虾在固定时间自动做某件事，比如每天早上 9 点发一条状态报告。

常用选项：

• --name <名称> — 任务名称（必填）
• --at <时间> — 指定时间执行一次
• --every <间隔> — 每隔多久执行一次（如 1h、30m）
• --cron <表达式> — 标准 cron 表达式
• --system-event <文本> — 触发系统事件
• --message <内容> — 发送消息

# 每小时触发一次系统事件
$ openclaw cron add --name "hourly-check" --every 1h --system-event "执行例行检查"

# 每天早上9点发消息
$ openclaw cron add --name "morning-report" --cron "0 9 * * *" --message "早安！请查看今日待办"

openclaw cron list / status

查看所有定时任务及其运行状态。

$ openclaw cron list
$ openclaw cron list --all --json
$ openclaw cron status

openclaw cron edit / rm / enable / disable / runs / run

编辑、删除、启用/禁用、查看运行记录、手动执行定时任务。

$ openclaw cron edit myJob --every 2h  # 改为每2小时
$ openclaw cron disable myJob  # 暂时关闭
$ openclaw cron enable myJob   # 重新开启
$ openclaw cron runs --id myJob  # 查看运行历史
$ openclaw cron run myJob --force  # 手动触发一次
$ openclaw cron rm myJob  # 删除任务

openclaw hooks list / info / enable / disable / install

管理事件钩子（Hooks）——事件触发自动执行。

通俗解释：Hooks 就像”触发器”——当某个事件发生时（比如收到消息、文件变化），自动执行预设的操作。

$ openclaw hooks list
$ openclaw hooks info myHook
$ openclaw hooks enable myHook
$ openclaw hooks disable myHook

openclaw webhooks gmail setup / run

设置和运行 Gmail 邮件 Webhook（有新邮件自动通知）。

$ openclaw webhooks gmail setup --account myGmail
$ openclaw webhooks gmail run

openclaw approvals / sandbox

管理操作审批策略和沙箱环境。

通俗解释：

• approvals — 控制哪些操作需要人工审批、设置白名单
• sandbox — 管理沙箱环境（AI 在安全隔离的环境中执行操作）

$ openclaw approvals get
$ openclaw approvals set --auto  # 自动审批
$ openclaw approvals allowlist add "safe-command"
$ openclaw sandbox list
$ openclaw sandbox explain

记忆与搜索

openclaw memory search / index / status

管理 AI 记忆库（语义搜索、索引、状态查看）。

通俗解释：小龙虾的”记忆”存储在 MEMORY.md 和 memory/*.md 文件中。你可以用语义搜索快速找到以前记住的信息。

$ openclaw memory search "上次部署出了什么问题？"
$ openclaw memory index  # 重建索引
$ openclaw memory status  # 查看索引状态

插件管理

openclaw plugins list / info / install / enable / disable / doctor

管理插件（列出、安装、启用、禁用、排查问题）。

通俗解释：插件就像给小龙虾装”外挂”——扩展新功能。比如语音通话插件 voicecall。

$ openclaw plugins list
$ openclaw plugins info voicecall
$ openclaw plugins install voicecall
$ openclaw plugins enable voicecall
$ openclaw plugins disable voicecall
$ openclaw plugins doctor  # 排查插件加载错误

大部分插件操作完后需要重启 Gateway 才能生效。

技能管理

openclaw skills list / info / check

管理 AI 技能（列出、查看详情、检查就绪状态）。

通俗解释：技能是 AI 的”特长”——比如搜索网页、操作文件、发邮件等。这里可以看看小龙虾会哪些技能、哪些还没准备好。

$ openclaw skills list
$ openclaw skills list --eligible  # 只看可用的
$ openclaw skills info web-search
$ openclaw skills check  # 检查哪些技能缺依赖

使用 npx clawhub 可以搜索、安装和同步更多技能。

安全与密钥

openclaw security audit

安全审计（检查配置漏洞、文件权限、Gateway 安全性）。

通俗解释：给小龙虾做一次”安全体检”——查找配置里的安全隐患，检查文件权限是否过于宽松。

$ openclaw security audit
$ openclaw security audit --fix   # 自动修复安全问题
$ openclaw security audit --deep  # 深度探测 Gateway

openclaw secrets reload / configure / audit

管理密钥和敏感信息（重新加载、配置、审计）。

通俗解释：管理 API Key、Token 等敏感信息。支持用环境变量引用（SecretRef）来避免明文存储。

$ openclaw secrets reload  # 重新加载密钥
$ openclaw secrets configure  # 交互式配置密钥管理
$ openclaw secrets audit  # 扫描明文残留

系统监控

openclaw status

查看整体状态（Gateway + 渠道 + 用量 综合诊断）。

通俗解释：一条命令看全局——Gateway 是否在线、渠道连接状态、最近联系人、API 用量等。

$ openclaw status
$ openclaw status --deep    # 探测所有渠道
$ openclaw status --usage   # 查看 API 用量
$ openclaw status --all     # 完整诊断（可粘贴分享）

openclaw health

快速检查 Gateway 是否存活。

$ openclaw health
$ openclaw health --json

openclaw logs

查看 Gateway 日志（实时跟踪或历史查看）。

通俗解释：出了问题先看日志！支持实时跟踪（--follow），就像看直播一样盯着运行状态。

$ openclaw logs
$ openclaw logs --follow  # 实时跟踪
$ openclaw logs --limit 200  # 最近200条
$ openclaw logs --json  # JSON 格式

openclaw system event / heartbeat / presence

系统事件、心跳管理、在线状态查询。

通俗解释：

• system event --text "..." — 发送一个系统事件（触发 AI 处理）
• system heartbeat last — 查看最后一次心跳
• system heartbeat enable/disable — 开启/关闭心跳
• system presence — 查看系统在线状态

$ openclaw system event --text "检查服务器状态"
$ openclaw system heartbeat last
$ openclaw system presence

维护与卸载

openclaw update

更新 OpenClaw 到最新版本。

通俗解释：一键升级小龙虾到最新版本。也可以用 openclaw --update 快捷方式。

$ openclaw update

openclaw backup create / verify

创建和验证配置/数据备份。

通俗解释：重要操作前先备份——万一搞砸了还能恢复。

$ openclaw backup create
$ openclaw backup verify

openclaw reset

重置本地配置和状态（CLI 保留，数据清空）。

通俗解释：“恢复出厂设置”——清除配置和数据，但不卸载程序。适合从头开始重新配置。

常用选项：

• --scope <范围> — 指定重置范围
• --yes — 确认执行
• --dry-run — 只预览不实际执行

$ openclaw reset --dry-run  # 先看看会清除什么
$ openclaw reset --yes

openclaw uninstall

卸载 Gateway 服务和本地数据（CLI 保留）。

通俗解释：卸载 Gateway 服务并清理数据。注意：CLI 程序本身不会被删除，只是清理了服务和数据。

常用选项：

• --all — 全部清除
• --service — 只卸载服务
• --state — 只清除状态数据
• --workspace — 只清除工作空间
• --dry-run — 预览模式

$ openclaw uninstall --dry-run
$ openclaw uninstall --all --yes

其他工具

openclaw docs [关键词]

搜索官方文档。

通俗解释：不用打开浏览器，直接在命令行搜索官方文档。

$ openclaw docs gateway
$ openclaw docs "how to setup telegram"

openclaw dns setup

设置 DNS 发现（CoreDNS + Tailscale 广域发现）。

$ openclaw dns setup
$ openclaw dns setup --apply  # 安装配置（需 sudo，仅 macOS）

openclaw --version / -V

查看当前安装的 OpenClaw 版本。

$ openclaw --version
$ openclaw -V

全局选项 --no-color / --profile / --dev / --json

所有命令都支持的全局选项。

通俗解释：这些选项可以加在任何命令后面：

• --no-color — 关闭彩色输出（方便复制日志）
• --profile <名称> — 使用独立配置文件（多环境隔离）
• --dev — 开发模式（隔离状态到 ~/.openclaw-dev）
• --json — 输出 JSON 格式（方便脚本处理）

$ openclaw status --json
$ openclaw --profile staging gateway status
$ openclaw --dev gateway run