OpenClaw 常用命令速查手册
OpenClaw 是一款运行在本地电脑上的 AI 助手，通过 WhatsApp、Telegram、Discord 等聊天应用与你交互，帮助处理邮件、日历、文件等日常事务。本文档整理了 OpenClaw 最常用的命令，供日常参考使用。
一、基础命令
基础命令是日常使用中最频繁的操作，涵盖服务状态查看、初始化配置等核心功能。
| 命令 |
功能说明 |
openclaw status |
查看 Gateway 当前运行状态，包含健康度与上下文信息 |
openclaw health |
健康检查，检测 core、依赖与运行环境 |
openclaw doctor |
综合诊断与修复建议，支持 --deep 深度检查 |
openclaw onboard |
交互式初始化向导，首次使用推荐执行 |
openclaw onboard --install-daemon |
安装系统守护进程，后台常驻运行 Gateway |
openclaw onboard --uninstall-daemon |
卸载守护进程，不删除数据 |
openclaw configure |
交互式配置向导，可配置模型、通道、凭据等 |
openclaw dashboard |
获取 Web UI 访问链接 |
openclaw update |
更新到最新版本 |
openclaw security audit --deep |
安全审计，深度检查系统安全 |
二、Gateway 服务管理
Gateway 是 OpenClaw 的核心服务组件，负责维持 AI 助手的持续运行。
| 命令 |
功能说明 |
openclaw gateway start |
启动 Gateway 服务 |
openclaw gateway stop |
停止 Gateway 服务 |
openclaw gateway restart |
重启 Gateway 服务，配置变更后使用 |
openclaw gateway status |
查看 Gateway 系统服务状态 |
openclaw gateway install |
安装 Gateway 系统服务，注册为系统守护进程 |
openclaw gateway |
运行 WebSocket 网关服务（可加 --port 指定端口） |
提示：如果端口 18789 被占用，可以使用其他端口启动服务：openclaw gateway --port 18790
三、通道管理
通道是指 OpenClaw 连接的聊天平台，如 WhatsApp、Telegram、Discord 等。
| 命令 |
功能说明 |
openclaw channels list |
列出已登录的通道（WhatsApp/Telegram/Discord 等） |
openclaw channels login |
登录新的通道账号（WhatsApp 扫码或授权流程） |
openclaw channels add |
添加通道，如 Telegram/Discord/Slack |
openclaw channels add --channel telegram |
添加 Telegram 通道（需 Bot Token） |
openclaw channels add --channel discord |
添加 Discord 通道（需 Bot Token） |
openclaw channels add --channel slack |
添加 Slack 通道（需 Bot Token） |
openclaw channels status --probe |
通道健康检测，检查连接可达性 |
四、配置管理
通过命令行直接读取或修改 OpenClaw 的配置项。
| 命令 |
功能说明 |
openclaw config get <path> |
获取配置值，支持 JSON Path 语法 |
openclaw config set <path> <value> |
设置配置项，支持 JSON5 或 raw 文本 |
openclaw config unset <path> |
清除配置项，移除单个键值 |
五、技能与插件管理
技能（Skills）和插件（Plugins）扩展了 OpenClaw 的功能。
| 命令 |
功能说明 |
openclaw skills list |
列出已安装和可用的技能 |
openclaw skills info <skill> |
查看技能详情，包括参数和版本信息 |
clawhub install <slug> |
从 ClawHub 官方技能市场安装技能 |
openclaw hooks list |
列出 Hook 列表，事件钩子机制 |
openclaw plugins list |
列出已安装的插件 |
openclaw plugins install <id> |
安装插件，例如 @openclaw/voice-call
|
openclaw plugins enable <id> |
启用插件，通常需要重启 Gateway |
六、模型管理
OpenClaw 支持多种 AI 模型，以下是模型相关的管理命令。
| 命令 |
功能说明 |
openclaw models list |
列出可用模型，包含鉴权状态 |
openclaw models status |
查看模型当前可用性状态 |
openclaw models auth setup-token |
配置模型鉴权，推荐使用 Cheatsheet 方式 |
七、日志与诊断
排查问题时，日志和诊断命令非常有用。
| 命令 |
功能说明 |
openclaw logs |
查看日志，默认聚合输出 |
openclaw logs --follow |
实时日志滚动输出 |
openclaw logs --json |
JSON 格式输出日志 |
openclaw logs --plain |
纯文本格式输出日志 |
openclaw logs --limit |
限制日志输出数量 |
openclaw doctor --deep |
深度诊断问题 |
八、内存与定时任务
| 命令 |
功能说明 |
openclaw memory search "X" |
搜索长期记忆，向量搜索功能 |
openclaw memory index |
重建记忆索引，修复 memory 异常 |
openclaw subagents list |
列出子代理 |
openclaw cron list |
列出定时任务 |
openclaw cron run <id> |
执行指定定时任务 |
九、浏览器与自动化
| 命令 |
功能说明 |
openclaw browser start |
启动浏览器代理，开启 Automation 能力 |
openclaw browser screenshot |
网页截图 |
十、卸载命令
| 命令 |
功能说明 |
openclaw uninstall |
卸载 Gateway 服务及数据 |
openclaw uninstall --all --yes --non-interactive |
全自动卸载（状态/workspace/插件） |
openclaw uninstall --dry-run |
模拟卸载，仅展示结果不实际删除 |
openclaw uninstall --state |
删除状态文件，不删除 workspace |
openclaw uninstall --workspace |
删除工作区（agent/workspace 数据） |
openclaw uninstall --service |
仅卸载系统服务，不删除数据 |
十一、聊天内斜杠命令
在聊天界面中可使用的斜杠命令。
| 命令 |
功能说明 |
/status |
查看健康状态和上下文信息 |
/context list |
查看上下文贡献者 |
/model <m> |
切换 AI 模型 |
/compact |
释放窗口空间 |
/new |
全新会话 |
/stop |
中止当前运行 |
/tts on / tts off
|
开启/关闭语音合成 |
/think |
切换推理模式 |
快速入门指南
对于新用户，建议按照以下顺序操作：
- 运行
openclaw onboard 进入交互式配置向导
- 使用
openclaw gateway start 启动服务
- 通过
openclaw channels login 或 openclaw channels add 配置聊天通道
- 使用
openclaw status 确认服务正常运行
附录：常用命令速查表
| 分类 |
命令 |
用途 |
| 启动 |
openclaw gateway start |
启动 OpenClaw 服务 |
| 停止 |
openclaw gateway stop |
停止 OpenClaw 服务 |
| 状态 |
openclaw status |
查看运行状态 |
| 配置 |
openclaw onboard |
重新配置向导 |
| 诊断 |
openclaw doctor |
排查问题 |
| 更新 |
openclaw update |
更新版本 |
| 日志 |
openclaw logs |
查看日志 |
