Openclaw常用的命令

先直接给你一个核心结论：无论你是想快速诊断平台健康状况，还是想深度管理Gateway服务、配置模型、甚至设定定时任务，掌握下面这些命令就足够了。这是一份从实战中总结出来的指南，覆盖了从入门到中阶的绝大部分场景。

一、什么是OpenClaw？

简单来说，OpenClaw是一个功能强大的AI助手操作台。它通过命令行（CLI）让你能像玩游戏一样，轻松控制AI对话、管理频道连接、设置定时任务，甚至操作内置浏览器。把这些基础命令玩熟，日常运维和工作效率能提升不止一个档次。

二、基础命令

这部分是定海神针，任何时候用来确认平台状态都管用。

1. 查看版本

要确认自己用的是哪个版本，最简单直接的方法：

openclaw --version
# 或者更简洁
openclaw -v

2. 查看状态

这是诊断问题的第一步。从快速查看到深度排查，命令很灵活： * **快速查看**：想知道它现在跑得怎么样？`openclaw status` 就够了。 * **深度诊断**：如果怀疑某个频道连不上，用 `openclaw status --deep`，它会帮你检测各个频道的连通性。 * **查看用量**：模型消耗了多少？用 `openclaw status --usage` 一目了然。 * **完整导出**：当需要向技术支持求助时，`openclaw status --all` 能生成一份完整的诊断信息，省去双方来回沟通的时间。

3. 健康检查

一个更直接的快速健康检查命令：

openclaw health

4. 查看日志

日志是排查问题的“黑匣子”。这里有几个常用场景： * **实时追踪**：`openclaw logs --follow`，可以让你像看直播一样，实时查看日志输出。 * **查看最近**：想看最近200条日志？`openclaw logs --limit 200`。 * **纯文本导出**：如果要复制到其他地方或进行文本分析，`openclaw logs --plain` 可以去掉格式，输出纯文本。

三、Gateway 服务管理

Gateway是OpenClaw的心脏——所有AI对话和消息路由都经过它。这么说吧，它要是罢工了，整个系统就转不动了。

1. 服务状态

确认Gateway是否在线：

openclaw gateway status

2. 启动 / 停止 / 重启

这几个命令是运维的基础操作，用于控制Gateway的启停：

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

3. 安装 / 卸载服务

如果你希望Gateway能开机自启，需要把它安装成系统服务：

# 安装为系统服务
openclaw gateway install
# 卸载系统服务
openclaw gateway uninstall

四、配置管理

配置管理是让OpenClaw真正为你所用的关键。

1. 查看配置

* **查看单项**：想知道默认的主模型是什么？`openclaw config get Agents.defaults.model.primary`。 * **查看文件路径**：如果想去编辑文件，用 `openclaw config file` 看看配置文件的路径。

2. 修改配置

* **设置**：想改个模型？`openclaw config set agents.defaults.model.primary claude-3-5-sonnet`。 * **删除**：某个配置项错了？`openclaw config unset agents.defaults.model.primary` 直接删掉。

3. 验证配置

改完配置怕出错？`openclaw config validate` 帮你校验一下，看格式和字段是否正确。

4. 交互式配置向导

如果命令行操作对你来说有点“硬核”，这里还有一个图形化的选择——`openclaw configure`，它会引导你一步步完成配置。

五、模型管理

模型是AI平台的“大脑”，管理好它们才能获得最佳性能。

1. 查看模型状态

看模型实例当前是正常还是异常：

openclaw models status
# 如果需要做二次开发，可以输出JSON
openclaw models status --json

2. 列出可用模型

* **看可用**：`openclaw models list` 列出当前能用的。 * **看全部**：`openclaw models list --all` 则包含那些配置了但未启用的模型。

3. 设置默认模型

指定默认使用哪个模型干活：

# 设为主模型
openclaw models set claude-3-5-sonnet-20241022
# 设为图像模型
openclaw models set-image dall-e-3

4. 模型认证

连接外部模型服务时需要提供凭证：

# 交互式添加
openclaw models auth add
# 例如为Anthropic添加setup-token
openclaw models auth setup-token --provider anthropic

六、频道管理

OpenClaw支持WhatsApp、Telegram、Discord、Slack等多个聊天频道。把AI放到这些地方，才算真正“活”了过来。

1. 查看频道列表

`openclaw channels list` 让你一眼看到所有已配置的频道。

2. 查看频道状态

* **快速查看**：`openclaw channels status`。 * **深度检测**：如果怀疑某个频道有网络问题，用 `openclaw channels status --probe` 进行深度探测。

3. 添加频道

* **Telegram / Discord**：这些平台通常需要一个Bot Token。

openclaw channels add --channel telegram --token YOUR_BOT_TOKEN
    openclaw channels add --channel discord --token YOUR_BOT_TOKEN

* **WhatsApp**：因为安全原因，通常采用交互式扫码登录。

openclaw channels add --channel whatsapp

4. 删除频道

`openclaw channels remove --channel telegram --delete`，加 `--delete` 参数表示彻底删除相关数据。

5. 登录 / 登出

针对像WhatsApp这类需要重新认证的场景：

# 扫码登录
openclaw channels login --channel whatsapp
# 登出
openclaw channels logout --channel whatsapp

6. 查看频道日志

每个频道都会有独立的日志，用来排查特定频道的消息发送问题：

# 查看所有频道日志概要
openclaw channels logs
# 只看Telegram的最后100条日志
openclaw channels logs --channel telegram --lines 100

七、发送消息

这个命令可以直接通过API发送消息，非常实用。

# 直接给某个手机号发消息
openclaw message send --target +8613800138000 --message "你好！"
# 发送到Discord的某个频道
openclaw message send --channel discord --target channel:123456 --message "Hello!"

八、定时任务（Cron）

定时任务是自动化运营的好帮手，比如每天早上发个早安提醒。

1. 查看定时任务

`openclaw cron list` 显示所有任务。想看看被禁用的任务？加个 `--all`。

2. 添加定时任务

* **固定时间**：每天早9点发消息 `openclaw cron add --name "早安提醒" --cron "0 9 * * *" --system-event "早安！今天也要加油哦"`。 * **相对时间**：30分钟后执行一次 `openclaw cron add --name "提醒" --every 1800000 --system-event "该休息了"` (1800000毫秒=30分钟)。

3. 启用 / 禁用任务

openclaw cron enable <任务ID>
openclaw cron disable <任务ID>

4. 立即执行任务

测试任务是否正常，可以用 `openclaw cron run <任务ID>`。

5. 删除任务

`openclaw cron rm <任务ID>`。

6. 查看任务执行历史

`openclaw cron runs --id <任务ID>`。

九、会话管理

# 查看所有会话
openclaw sessions
# 只看过去30分钟内的活跃会话
openclaw sessions --active 30
# 如果需要程序化处理，加 --json

十、技能管理

技能是可以赋予AI的特殊能力。

1. 查看已安装技能

openclaw skills list
# 只看当前条件满足、可以调用的技能
openclaw skills list --eligible

2. 查看技能详情

`openclaw skills info <技能名称>`，用于查看技能的详细信息。

3. 检查技能状态

`openclaw skills check`，快速检测技能依赖是否正常。

十一、插件管理

# 查看插件列表
openclaw plugins list
# 安装插件
openclaw plugins install <插件路径或名称>
# 启用/禁用
openclaw plugins enable <插件ID>
openclaw plugins disable <插件ID>
# 插件诊断，解决依赖冲突或配置问题
openclaw plugins doctor

十二、浏览器控制

OpenClaw内置了一个无头浏览器，可以用于自动化网页操作。

1. 基础操作

# 查看浏览器状态
openclaw browser status
# 启动/停止
openclaw browser start
openclaw browser stop
# 打开一个网页
openclaw browser open https://www.example.com
# 查看当前标签页
openclaw browser tabs

2. 截图

# 截取当前窗口
openclaw browser screenshot
# 截取完整页面，包括滚动区域内容
openclaw browser screenshot --full-page

3. 页面操作

# 导航到某个URL
openclaw browser na vigate https://www.example.com
# 点击某个元素（通过引用）
openclaw browser click <元素ref>
# 在输入框输入文字
openclaw browser type <元素ref> "要输入的文字"
# 按下按键
openclaw browser press Enter

十三、内存管理

内存功能让OpenClaw能记住过往的对话或信息。

# 查看索引状态
openclaw memory status
# 手动重建索引
openclaw memory index
# 搜索记忆中的关键词
openclaw memory search "关键词"

十四、安全审计

安全永远是第一位。定期审计能帮你发现潜在风险。

# 基础安全检查
openclaw security audit
# 深度审计，含实时探测
openclaw security audit --deep
# 自动修复被发现的问题
openclaw security audit --fix

十五、初始化与重置

1. 初始化设置

* **首次安装**：`openclaw setup` 带你走完基础配置。 * **完整引导**：`openclaw onboard` 则是一个更全面的向导。

2. 诊断修复

`openclaw doctor` 是个万能修复工具，遇到奇怪问题先跑一遍。

3. 重置配置

重置是运维中的“终极大招”，有几种不同的力度：

# 只重置配置，保留数据
openclaw reset --scope config
# 重置配置+凭证+会话
openclaw reset --scope config+creds+sessions
# 完全重置，不留后患
openclaw reset --scope full --yes

十六、常用命令速查表

为了方便快速查阅，这里整理了一个表格。 | 命令 | 说明 | | :--- | :--- | | openclaw status | 查看运行状态 | | openclaw status --deep | 深度诊断 | | openclaw gateway restart | 重启服务 | | openclaw logs --follow | 实时查看日志 | | openclaw channels list | 查看频道列表 | | openclaw models list | 查看可用模型 | | openclaw cron list | 查看定时任务 | | openclaw sessions | 查看会话列表 | | openclaw skills list | 查看技能列表 | | openclaw plugins list | 查看插件列表 | | openclaw memory search "关键词" | 搜索记忆 | | openclaw security audit | 安全审计 | | openclaw doctor | 诊断修复 | | openclaw config get <路径> | 查看配置 | | openclaw config set <路径> <值> | 修改配置 |

十七、小技巧

最后，分享几个能让你用起来更顺手的小技巧。 **1. 使用 `--json` 获取结构化输出** 很多命令都支持 `--json` 参数，这对于脚本处理来说非常友好：

openclaw channels list --json
openclaw models list --json
openclaw cron list --json

**2. 全局参数** * **禁用颜色**：做日志记录时，关掉颜色输出会更干净。`openclaw --no-color status`。 * **多实例配置**：如果你需要同时管理多个环境或场景，用 `--profile` 指定不同的配置文件。`openclaw --profile work status`。 **3. 查看帮助** 任何一个命令，如果忘了参数，直接加 `--help` 就能看详细说明：

openclaw gateway --help
openclaw cron --help
openclaw channels --help