OpenClaw 的命令体系主要分为两大类：终端中的 CLI 命令和聊天界面中的斜杠命令。以下基于 2026 年 3 月最新版本的资料，对各项命令进行系统化分类和介绍。

一、基础与环境命令

1.1 版本查看与帮助

• openclaw --version 或 -V：显示当前安装的 OpenClaw 版本号。
• openclaw --help 或 -h：列出所有可用的 CLI 命令和参数。
• openclaw tui：启动一个基于终端的交互式用户界面。
• openclaw dashboard：在浏览器中打开 Web 管理页面。

1.2 初始安装与维护

• openclaw setup：进行首次安装后的初始化，包括创建工作区和配置文件。
• openclaw onboard：引导式的配置流程，依次设置 Gateway、工作区和技能。
• openclaw configure：进入交互式配置向导，可修改模型、渠道和技能等核心选项。
• openclaw update：更新 OpenClaw CLI 至最新稳定版（可指定 --channel）。
• openclaw uninstall：卸载 Gateway 服务及相关数据（谨慎使用）。

1.3 全局选项

• --dev：以开发模式运行，使用独立端口 18790 和独立的配置。
• --profile <name>：使用指定配置文件，实现工作/个人环境分离。
• --log-level <level>：设置日志输出级别（如 info, debug, error）。
• --no-color：禁用 ANSI 颜色输出，便于日志重定向。
• --json：以 JSON 格式输出结果，便于脚本解析。

二、配置管理命令

2.1 配置读写操作

• openclaw config get <path>：读取指定配置项的值。
• openclaw config set <path> <value>：设置指定配置项的值。
• openclaw config unset <path>：删除指定配置项。
• openclaw config file：显示当前配置文件的绝对路径。
• openclaw config validate：检查配置文件是否符合语法规范。

2.2 常见配置示例

# 将网关模式设为本地
openclaw config set gateway.mode local

# 绑定模式设为仅本地访问
openclaw config set gateway.bind loopback

# 设置 API 密钥
openclaw config set providers.anthropic.apiKey "sk-ant-xxxxx"

# 禁用默认的记忆搜索功能
openclaw config set agents.defaults.memorySearch.enabled false

三、Gateway 服务命令

3.1 服务生命周期管理

• openclaw gateway 或 openclaw gateway run：在前台运行 Gateway，日志直接输出。
• openclaw gateway start：将 Gateway 作为后台服务启动。
• openclaw gateway stop：停止正在运行的 Gateway 服务。
• openclaw gateway restart：重启 Gateway 服务。修改配置后，此命令是必须执行的。
• openclaw gateway status：通过 RPC 检查 Gateway 是否处于运行状态。

3.2 服务安装与卸载

• openclaw gateway install：将 Gateway 安装为系统服务（如 systemd）。
• openclaw gateway uninstall：从系统中移除已安装的 Gateway 服务。

3.3 调试与发现

• openclaw gateway call <method>：直接调用特定的 RPC 方法（如 health）。
• openclaw gateway probe：探测 Gateway 的连接状况。
• openclaw gateway discover：查找局域网内其他正在运行的 Gateway 实例。

3.4 启动选项

# 在指定端口启动
openclaw gateway --port 18789

# 强制杀死占用端口的进程后启动
openclaw gateway --force

# 使用详细日志输出
openclaw gateway --verbose

# 设定 RPC 调用超时时间（单位毫秒）
openclaw gateway --timeout 30000

# 绑定到不同网络接口
openclaw gateway --bind loopback  # 仅本机
openclaw gateway --bind lan       # 局域网
openclaw gateway --bind tailnet   # Tailscale 网络

四、模型管理命令

4.1 基本模型操作

• openclaw models list：列出当前所有可用的模型。
• openclaw models status：显示各个模型的状态概览。
• openclaw models status --probe：结合深度探测检查模型可用性。
• openclaw models set <name>：将指定模型设为默认聊天模型。
• openclaw models set-image <name>：设定默认的图片生成模型。

4.2 模型别名管理

• openclaw models aliases list：查看已创建的模型别名列表。
• openclaw models aliases add <alias> <model>：为复杂模型名创建简短别名。
• openclaw models aliases remove <alias>：删除某个模型别名。

4.3 回退模型配置

• openclaw models fallbacks list：查看当前配置的回退模型列表。
• openclaw models fallbacks add <model>：添加一个主模型不可用时的备用模型。
• openclaw models fallbacks remove <model>：移除某个回退模型。
• openclaw models fallbacks clear：清空所有回退模型配置。

4.4 认证管理

• openclaw models auth add：添加新的模型 API 认证信息。
• openclaw models auth setup-token：通过交互式流程设置 API Token。
• openclaw models auth paste-token：直接粘贴 API Token 完成配置。
• openclaw models auth order get：查看认证提供商的尝试顺序。
• openclaw models auth order set：调整认证提供商的尝试优先级。

五、渠道管理命令

5.1 渠道操作

• openclaw channels list：显示所有已配置的通讯渠道。
• openclaw channels status：检查各个渠道的健康状态。
• openclaw channels status --probe：进行深度连接测试。
• openclaw channels add：通过向导添加新渠道。
• openclaw channels login --channel <name>：进行交互式登录，如扫码。
• openclaw channels logout：注销当前渠道。
• openclaw channels remove：禁用并从配置中移除渠道。

5.2 添加渠道示例

# 添加 Telegram 机器人
openclaw channels add --channel telegram --token "BOT_TOKEN"

# 添加 Discord 机器人
openclaw channels add --channel discord --token "BOT_TOKEN"

# 登录 WhatsApp（手机扫码）
openclaw channels login --channel whatsapp

# 添加飞书机器人
openclaw channels add --channel feishu --app-id "APP_ID" --app-secret "APP_SECRET"

六、技能与插件命令

6.1 技能管理

• openclaw skills list：列出所有已加载的技能。
• openclaw skills info <name>：查看指定技能的详细信息。
• openclaw skills check：检查技能的依赖项是否就绪。
• openclaw skills install <name>：安装指定的技能。
• openclaw skills enable <name>：启用已安装的技能。
• openclaw skills disable <name>：禁用指定技能。

6.2 插件管理

• openclaw plugins list：发现并列出所有已安装的插件。
• openclaw plugins info <name>：查看插件的详细信息。
• openclaw plugins install <name>：安装插件，支持本地路径或 npm 包。
• openclaw plugins enable <name>：启用插件。
• openclaw plugins disable <name>：禁用插件。
• openclaw plugins doctor：诊断插件加载错误。

6.3 ClawHub 社区技能

# 搜索名为 weather 的技能
clawhub search "weather"

# 安装找到的技能
clawhub install weather

# 同步所有已注册的社区技能
clawhub sync --all

# 列出通过 ClawHub 安装的技能
clawhub list

七、消息与会话命令

7.1 消息操作

• openclaw message send：向指定目标发送消息。
• openclaw message edit：编辑已发送的历史消息。
• openclaw message delete：删除指定消息。
• openclaw message poll：在群组中创建投票。
• openclaw message react：给消息添加或移除表情反应。
• openclaw message broadcast：将同一条消息广播到多个目标。

7.2 会话管理

• openclaw sessions list：列出所有活跃的会话。
• openclaw sessions history：查看特定会话的消息历史。
• openclaw memory：管理 AI 的记忆，如搜索记忆。
• openclaw memory index：重建向量索引，用于修复记忆检索问题。

7.3 Agent 管理

• openclaw agents list：列出所有配置的 Agent。
• openclaw agents add：通过向导创建新的 Agent。
• openclaw agents delete <name>：删除指定 Agent。
• openclaw agents bindings：查看 Agent 与渠道的路由绑定关系。
• openclaw agents bind：将 Agent 绑定到指定渠道或群组。
• openclaw agents unbind：解除 Agent 的绑定关系。

八、诊断与维护命令

8.1 健康检查

• openclaw doctor：最常用的综合性诊断命令，检查环境并提供修复建议。
• openclaw doctor --fix：自动尝试修复常见的配置和权限问题。
• openclaw doctor --deep：进行更深入的诊断，用于复杂故障排查。
• openclaw health：获取运行中 Gateway 的健康状况。
• openclaw status：显示运行状态的概览。

8.2 日志管理

• openclaw logs：查看 Gateway 的日志。
• openclaw logs --follow：实时跟踪日志输出。
• openclaw logs --filter <level>：仅显示特定级别的日志。
• openclaw logs --start "2026-03-13"：查看指定时间之后的日志。
• openclaw logs --search "error"：根据关键词过滤日志。

8.3 系统管理

• openclaw system event --text <msg>：向系统事件队列入队一条消息。
• openclaw system heartbeat last：查看上次心跳时间。
• openclaw system heartbeat enable/disable：启用或禁用定时心跳。
• openclaw system presence：列出系统的在线状态。

8.4 安全与备份

• openclaw security audit：执行安全审计。
• openclaw security audit --deep：进行全面的深度安全审计。
• openclaw secrets reload：重新加载敏感密钥。
• openclaw backup create：创建系统配置和数据的备份。
• openclaw reset：重置系统状态，但保留 CLI 本身。
• openclaw uninstall --all --yes：彻底卸载，清除所有数据。

九、聊天斜杠命令

9.1 会话管理

• /new：开启一个新的会话线程，清空上下文。
• /new <描述>：带目标地启动新会话。
• /reset：重置当前会话，同 /new。
• /status：查看当前会话的详细信息（模型、上下文等）。
• /compact：压缩上下文以释放 Token 空间。
• /history：查看当前会话的历史记录。
• /pause：暂停 AI 当前正在执行的任务。

9.2 模型控制

• /model <名称>：切换当前会话使用的模型。
• /reasoning on/off：开启或关闭深度推理模式。
• /reasoning <级别>：调整推理的详细级别。
• /think <级别>：设置思考的深度级别。
• /verbose on/off：开启或关闭更详细的输出。

9.3 技能与工具

• /skills：列出所有可用的技能。
• /skill <name> [input]：直接调用并运行一个技能。
• /agents：查看可用的 Agent。
• /memory：查看或管理 AI 的记忆内容。
• /forget：让 AI 忘记特定的信息。

9.4 操作控制

• /stop：立即中止当前正在运行的任务。
• /approve：批准一个新的配对请求。
• /deny：拒绝一个配对请求。
• /cancel：取消当前正在执行的操作。
• /undo：撤销上一步操作。

9.5 信息查询

• /help：显示帮助信息。
• /commands：显示所有可用的斜杠命令。
• /cost：查看当前会话或总体的使用费用。
• /version：显示 OpenClaw 版本信息。
• /ping：测试与服务的连接状态。
• /deliver：交付当前任务的最终结果。

十、高级与扩展命令

10.1 定时任务

• openclaw cron list：列出所有已配置的定时任务。
• openclaw cron add "<cron表达式>" "<命令>"：添加一个定时任务。
• openclaw cron edit <id>：编辑已有的定时任务。
• openclaw cron rm <id>：删除指定 ID 的定时任务。
• openclaw cron run <id>：手动触发执行一个定时任务。

10.2 浏览器控制

• openclaw browser start：启动一个无头浏览器实例。
• openclaw browser open <url>：打开指定网页。
• openclaw browser click <selector>：点击指定 CSS 选择器的元素。
• openclaw browser type <selector> <text>：在指定输入框中输入文本。
• openclaw browser screenshot：对当前页面进行截图保存。

10.3 节点管理

• openclaw node run：在前台运行一个 headless 节点主机。
• openclaw node start/stop/restart：管理节点主机服务的生命周期。
• openclaw node status：查看节点主机的运行状态。
• openclaw nodes：管理移动端节点。

10.4 配对管理

• openclaw pairing list：查看待处理的配对请求列表。
• openclaw pairing approve/deny：批准或拒绝待处理的配对请求。

十一、实用技巧与最佳实践

11.1 多环境隔离

# 启动工作环境的 Gateway
openclaw --profile work gateway start

# 启动个人环境的 Gateway
openclaw --profile personal gateway start

# 使用开发模式
openclaw --dev gateway start

11.2 脚本化操作

# 从文件批量执行命令
openclaw run --batch commands.txt

# 通过管道传递输入
echo "分析这段代码" | openclaw run

# 配合 jq 处理 JSON 输出
openclaw models list --json | jq '.models[] | select(.provider=="openai")'

11.3 常用 Shell 别名

# 添加到 ~/.bashrc 或 ~/.zshrc
alias claw='openclaw'
alias claw-status='openclaw gateway status'
alias claw-restart='openclaw gateway restart'
alias claw-logs='openclaw logs --follow'
alias claw-doctor='openclaw doctor --fix'

11.4 核心配置路径

• 主配置文件：~/.openclaw/openclaw.json
• 工作区目录：~/.openclaw/workspace/
• 技能安装目录：~/.openclaw/skills/
• Agent 数据目录：~/.openclaw/agents/
• 日志文件目录：~/.openclaw/logs/

掌握这些命令，能帮助用户更好地对 OpenClaw 进行配置、管理和故障排查，从而充分发挥其作为个人 AI 助手的能力。