OpenClaw 常用命令合集，帮助新手快速上手小龙虾

最近发现很多新手在安装和使用openclaw时无从下手，其实OpenClaw 的部署非常简单，官方 提供了一键部署命令，主要是大家在配置一些参数时不知道该如果使用命令。我根据最新的官方文档和自己常用的一些命令整理了一个常用命令合集，还附带使用场景和真实示例。

OpenClaw 最全命令指南

包括OpenClaw 日常常用 CLI 命令、聊天斜杠命令、通道管理、模型配置、服务维护等全景功能说明。

一、基础 CLI 命令 — 进入 OpenClaw 世界第一步

这些命令适合刚开始使用 OpenClaw 的用户，用于查看版本、帮助、初始化：

openclaw --version                     # 显示当前版本信息
openclaw --help                        # 显示所有可用命令
openclaw setup                         # 初始化基本配置
openclaw onboard --install-daemon      # 引导配置向导并安装后台服务
openclaw configure                     # 交互式修改现有配置
openclaw config get <path>             # 读取配置项值
openclaw config set <path> <value>     # 设置某个配置项
openclaw config unset <path>           # 删除某项设置

Tip：openclaw onboard 是最友好的引导方式，适合第一次使用的用户。

二、服务与网关（Gateway）管理

Gateway 是 OpenClaw 的核心服务，管理 toda AI 运行和通道连接。

openclaw gateway                       # 在前台运行 Gateway（实时日志输出）
openclaw gateway run                   # 同上
openclaw gateway status                # 探测当前 Gateway 状态
openclaw gateway health                # 获取健康信息（可加 --json 简洁输出）
openclaw gateway install               # 安装为系统服务（systemd/launchd）
openclaw gateway start                 # 启动后台服务
openclaw gateway stop                  # 停止服务
openclaw gateway restart               # 重启服务
openclaw gateway probe                 # 试探性探测 Gateway RPC 是否可达

📌 实例：如果端口被占用，想强制启动 gateway：

openclaw gateway --force --port 19000

📌 也支持绑定不同访问模式（如 --bind lan 让局域网可访问等）。

三、聊天斜杠命令（Slash Commands）

这些命令直接在聊天窗口使用，不需要 CLI：

/new [model]              # 开启新对话并清空上下文，可指定模型
/reset                   # 重置当前对话状态
/status                  # 查看当前聊天状态（模型、Token 等）
/model <name>            # 切换使用模型
/reasoning <on|off|stream>  # 控制深度推理模式
/help                    # 显示帮助信息

📌 这些命令在 Telegram、Discord 等聊天中使用体验最直观。

四、通道（Channel）管理命令

OpenClaw 支持 WhatsApp、Telegram、Discord、Slack 等多个消息平台：

openclaw channels list                     # 列出已配置通道
openclaw channels status                   # 查看连接状态
openclaw channels add                      # 添加新通道（交互式）
openclaw channels login --channel whatsapp # 登录 WhatsApp 需扫码
openclaw channels remove --channel <name>  # 移除频道
openclaw channels logout --channel discord # 登出指定通道

📌 小技巧：用 openclaw channels status --probe 检查连接稳定性。

五、模型管理命令（Model）

现在很多用户会同时接入多个模型：

openclaw models list               # 列出所有可用的模型
openclaw models status             # 查看当前模型状态
openclaw models set <model-id>     # 切换默认模型
openclaw models auth login         # 绑定模型提供商 API Key
openclaw models aliases list       # 查看模型别名
openclaw models fallbacks list     # 查看备用模型链

📌 实例：切换到 GPT‑4o：

openclaw models set gpt‑4o

📌 有时候把多个模型设为 fallback 能提升服务连续性。

六、健康检查与日志查看

排错时最常用：

openclaw doctor                # 全面检查环境健康并尝试修复
openclaw status                # 快速查看总体状态
openclaw logs --follow         # 实时跟踪日志输出
openclaw logs --json           # 输出 JSON 格式日志（脚本友好）
openclaw dashboard             # 打开可视化控制台

📌 “doctor” 命令是很多高级用户排错的第一步。

七、定时任务（Cron）与自动化

OpenClaw 支持类似 cron 的自动任务：

openclaw cron status           # 查看调度器状态
openclaw cron list             # 列出所有定时任务
openclaw cron add              # 添加新任务
openclaw cron run <id>         # 手动触发
openclaw cron enable <id>      # 启用任务
openclaw cron disable <id>     # 禁用任务

📌 你可以每天定时发送 Telegram 广播、每周生成邮件等，这个功能特别实用。

八、高级功能与插件（Plugins）

OpenClaw 允许安装插件扩展功能：

openclaw plugins list            # 查看所有插件
openclaw plugins install <path>  # 安装插件
openclaw plugins enable <id>     # 启用某插件
openclaw plugins disable <id>    # 禁用某插件
openclaw plugins doctor          # 检查插件加载问题

📌 比如你可以装一些技能插件让机器人支持语音通话、命令自动化等。

九、实用技巧总结（真人视角）

✅ 初次使用执行：

openclaw onboard --install-daemon
openclaw channels login --channel telegram
openclaw dashboard

这是一个星期项目最快上手路。

📌 如果改配置后不确定状态，可先：

openclaw status
openclaw logs --follow

📌 开发调试时：

openclaw gateway --dev --allow-unconfigured

能以隔离模式启动测试。