一、什么是OpenClaw？

OpenClaw 是一款强大的 AI 助手平台，通过命令行（CLI）可以管理 AI 对话、频道连接、定时任务、浏览器控制等功能。掌握常用命令，能让你更高效地使用 OpenClaw。

二、基础命令

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. 服务状态

openclaw gateway status

2. 启动 / 停止 / 重启

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

3. 安装 / 卸载服务

# 安装为系统服务（开机自启）openclaw gateway install# 卸载系统服务openclaw gateway uninstall

四、配置管理

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

五、模型管理

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# 使用 setup-token 认证（Anthropic）openclaw models auth setup-token --provider anthropic

六、频道管理

OpenClaw支持 WhatsApp、Telegram、Discord、Slack 等多个聊天频道。

1. 查看频道列表

openclaw channels list

2. 查看频道状态

openclaw channels status# 深度检测openclaw channels status --probe

3. 添加频道

# 添加 Telegram 频道openclaw channels add --channel telegram --token YOUR_BOT_TOKEN# 添加 Discord 频道openclaw channels add --channel discord --token YOUR_BOT_TOKEN# 添加WhatsApp（交互式）openclaw channels add --channel whatsapp

4. 删除频道

openclaw channels remove --channel telegram --delete

5. 登录 / 登出

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

6. 查看频道日志

openclaw channels logs# 查看指定频道日志openclaw channels logs --channel telegram --lines 100

七、发送消息

# 发送消息到指定号码openclaw message send --target +8613800138000 --message "你好！"# 发送到 Discord 频道openclaw message send --channel discord --target channel:123456 --message "Hello!"

八、定时任务（Cron）

1. 查看定时任务

openclaw cron list# 包含已禁用的任务openclaw cron list --all

2. 添加定时任务

# 每天早上 9 点发送消息openclaw cron add --name "早安提醒" --cron "0 9 * * *" --system-event "早安！今天也要加油哦"# 30 分钟后执行一次openclaw cron add --name "提醒" --every 1800000 --system-event "该休息了"

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 格式输出openclaw sessions --json

十、技能管理

1. 查看已安装技能

openclaw skills list# 只显示可用的技能openclaw skills list --eligible

2. 查看技能详情

openclaw skills info <技能名称>

3. 检查技能状态

openclaw skills check

十一、插件管理

1. 查看插件列表

openclaw plugins list

2. 安装插件

openclaw plugins install <插件路径或名称>

3. 启用 / 禁用插件

openclaw plugins enable <插件ID>openclaw plugins disable <插件ID>

4. 插件诊断

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. 页面操作

# 导航到指定 URLopenclaw browser navigate https://www.example.com# 点击元素openclaw browser click <元素ref># 输入文字openclaw browser type <元素ref> "要输入的文字"# 按键openclaw browser press Enter

十三、内存管理

# 查看内存索引状态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

十六、常用命令速查表

十七、小技巧

1. 使用 --json 获取结构化输出大多数命令支持--json参数，方便脚本处理：

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

2. 全局参数

# 禁用颜色输出（适合日志记录）openclaw --no-color status# 使用独立配置文件（多实例）openclaw --profile work status

3. 查看帮助

# 查看某个命令的帮助openclaw gateway --helpopenclaw cron --helpopenclaw channels --help