常用命令速查
OpenClaw 通过命令行管理。这里列出了日常使用最常用的命令,建议收藏本页。
Gateway 管理
Gateway 是 OpenClaw 的核心进程,必须运行才能接收和发送消息。
| 命令 | 说明 |
|---|---|
openclaw gateway start | 启动 Gateway |
openclaw gateway stop | 停止 Gateway |
openclaw gateway restart | 重启 Gateway(更新配置后需要) |
openclaw gateway status | 查看 Gateway 运行状态 |
什么时候需要重启?
修改了 config.yaml 配置文件后、更新了 OpenClaw 版本后,都需要重启 Gateway 才能生效。
安装与配置
| 命令 | 说明 |
|---|---|
openclaw onboard | 首次配置向导(选模型、连平台) |
openclaw configure | 修改现有配置 |
openclaw setup | 初始化/重新设置工作区 |
openclaw update | 更新到最新版本 |
openclaw uninstall | 完全卸载 OpenClaw |
诊断与日志
| 命令 | 说明 |
|---|---|
openclaw status | 查看整体状态(Gateway、平台连接、模型) |
openclaw doctor | 自动诊断问题并给出修复建议 |
openclaw logs | 查看实时日志 |
openclaw logs --tail 100 | 查看最近 100 行日志 |
openclaw health | 健康检查 |
遇到问题第一步
任何时候 AI 不正常工作,先跑 openclaw doctor,它会自动检查常见问题并告诉你怎么修。
会话管理
| 命令 | 说明 |
|---|---|
openclaw sessions list | 列出所有活跃会话 |
openclaw sessions info <key> | 查看某个会话详情 |
openclaw sessions compact <key> | 手动压缩会话历史 |
定时任务
| 命令 | 说明 |
|---|---|
openclaw cron list | 查看所有定时任务 |
openclaw cron add | 添加新定时任务(交互式) |
openclaw cron remove <id> | 删除定时任务 |
openclaw cron run <id> | 手动执行一次定时任务 |
技能管理
| 命令 | 说明 |
|---|---|
openclaw skills list | 查看已安装的技能 |
openclaw skills install <name> | 安装技能 |
openclaw skills remove <name> | 卸载技能 |
openclaw skills search <keyword> | 搜索可用技能 |
模型管理
| 命令 | 说明 |
|---|---|
openclaw models list | 查看可用模型 |
openclaw models set <model> | 切换默认模型 |
其他常用
| 命令 | 说明 |
|---|---|
openclaw message send -t <target> -m "消息" | 主动发消息到指定平台/频道 |
openclaw browser start | 启动内置浏览器 |
openclaw dashboard | 打开 Web 控制面板 |
openclaw channels list | 查看已连接的聊天渠道 |
openclaw nodes status | 查看已配对的设备 |
openclaw --version | 查看版本号 |
openclaw help | 查看所有可用命令 |
聊天内命令
除了在终端使用 CLI 命令,你还可以在聊天中直接对 AI 发送斜杠命令:
| 命令 | 说明 |
|---|---|
/reset | 清空当前会话,重新开始 |
/status | 查看当前会话状态(模型、token 用量) |
/model <name> | 切换当前会话的 AI 模型 |
/reasoning on|off | 开启/关闭推理模式 |
/compact | 手动压缩当前会话历史 |
聊天命令 vs CLI 命令
聊天命令(以 / 开头)在聊天平台里发送,影响当前对话。CLI 命令在电脑终端里运行,管理整个 OpenClaw 系统。