OpenClaw所有命令及使用详解
OpenClaw 是一款开源的个人 AI 助手，支持通过 CLI 终端命令和聊天斜杠命令进行操作，本文将详细介绍所有命令的使用方法。
一、命令分类概览
OpenClaw 的命令分为两大类：
| 类型 | 使用场景 | 示例 |
|---|---|---|
| CLI 终端命令 | 在系统终端中使用，用于管理 Gateway、配置、模型等核心功能 | openclaw status、openclaw gateway start |
| 聊天斜杠命令 | 在聊天窗口（WhatsApp、Telegram、Discord 等）中使用，用于会话管理、模型切换等 | /new、/status、/model |
二、CLI 终端命令
- 基础命令
用于验证安装、查看状态和帮助信息。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 查看版本 | 查看当前 OpenClaw 的安装版本 | openclaw –version | openclaw –version |
| 查看帮助 | 查看所有 CLI 命令的帮助信息 | openclaw –help | openclaw –help |
| 状态概览 | 查看 OpenClaw 的整体状态，包括 Gateway、模型、频道等信息 | openclaw status | openclaw status |
| 完整诊断 | 查看详细的状态信息，适合调试和分享 | openclaw status –all | openclaw status –all |
| 健康检查 | 检查系统的健康状态，检测潜在问题 | openclaw health | openclaw health |
| 深度健康检查 | 进行更全面的健康检测，排查深层问题 | openclaw status –deep | openclaw status –deep |
- Gateway 管理命令
用于管理 OpenClaw 的 Gateway 服务，控制核心运行进程。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 启动 Gateway | 启动 Gateway 服务 | openclaw gateway start | openclaw gateway start |
| 停止 Gateway | 停止 Gateway 服务 | openclaw gateway stop | openclaw gateway stop |
| 重启 Gateway | 重启 Gateway 服务 | openclaw gateway restart | openclaw gateway restart |
| 查看 Gateway 状态 | 查看 Gateway 的运行状态 | openclaw gateway status | openclaw gateway status |
| 前台运行 Gateway | 手动在前台运行 Gateway，用于调试，显示详细日志 | openclaw gateway –port <端口> –verbose |
openclaw gateway –port 18789 –verbose |
| 设置绑定模式 | 指定 Gateway 的网络绑定模式，控制访问范围 | openclaw gateway –bind <模式> |
openclaw gateway –bind loopback（本地回环，默认）openclaw gateway –bind lan（局域网）openclaw gateway –bind tailnet（Tailscale 网络） |
- 配置管理命令
用于管理 OpenClaw 的配置文件，自定义系统参数。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 交互式配置 | 进入交互式配置向导，逐步设置系统参数 | openclaw configure | openclaw configure |
| 查看完整配置 | 查看当前的所有配置信息 | openclaw config get | openclaw config get |
| 查看特定配置 | 查看指定部分的配置信息 | openclaw config get <配置路径> |
openclaw config get agents.defaultsopenclaw config get channels.telegram |
| 设置配置值 | 设置指定配置项的值 | openclaw config set <配置路径> <值> |
openclaw config set gateway.port 18789openclaw config set agents.defaults.workspace ~/.openclaw/workspace |
| 删除配置项 | 删除指定的配置项 | openclaw config unset <配置路径> |
openclaw config unset gateway.port |
| 查看配置文件位置 | 配置文件默认路径：~/.openclaw/openclaw.json | – | – |
- 模型管理命令
用于管理 AI 模型，切换模型、查看模型状态等。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 查看可用模型 | 列出所有支持的 AI 模型 | openclaw models list | openclaw models list |
| 查看模型状态 | 查看已配置模型的状态，包括 API Key 有效性等 | openclaw models status | openclaw models status |
| 扫描可用模型 | 扫描系统中可用的 AI 模型 | openclaw models scan | openclaw models scan |
| 设置默认模型 | 设置默认使用的 AI 模型 | openclaw models set <模型名> |
openclaw models set anthropic/claude-sonnet-4-0 |
| 测试模型连接 | 测试指定模型的连接是否正常 | openclaw models probe <模型名> |
openclaw models probe claude-opus-4-5 |
- 频道管理命令
用于管理即时通讯频道，如 WhatsApp、Telegram 等。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 频道登录 | 登录指定的即时通讯频道，如 WhatsApp（需要扫描二维码） | openclaw channels login | openclaw channels login |
| 频道登出 | 退出登录的频道 | openclaw channels logout | openclaw channels logout |
| 查看频道状态 | 查看所有已配置频道的状态 | openclaw channels status | openclaw channels status |
| 探测频道连通性 | 测试频道的连通性，检查是否可以正常使用 | openclaw channels status –probe | openclaw channels status –probe |
- 配对管理命令
用于管理私聊配对，控制哪些用户可以和 OpenClaw 交互。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 查看待处理配对 | 查看指定频道的待处理配对请求 | openclaw pairing list <频道名> |
openclaw pairing list whatsappopenclaw pairing list telegram |
| 批准配对 | 批准指定的配对请求，允许用户和 OpenClaw 交互 | openclaw pairing approve <频道名> <配对码> |
openclaw pairing approve whatsapp ABC123 |
| 拒绝配对 | 拒绝指定的配对请求 | openclaw pairing deny <频道名> <配对码> |
openclaw pairing deny telegram XYZ789 |
- 消openclaw息发送命令
用于通过 OpenClaw 发送消息和文件。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 发送文本消息 | 向指定目标发送文本消息 | openclaw message send –target <目标> –message <消息内容> |
openclaw message send –target + –message “Hello from OpenClaw” |
| 发送文件 | 向指定目标发送文件 | openclaw message send –target <目标> –file <文件路径> |
openclaw message send –target + –file /path/to/file.txt |
- 代理（Agents）管理命令
用于管理多个代理实例，实现多任务隔离。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 查看代理列表 | 列出所有已创建的代理 | openclaw agents list | openclaw agents list |
| 添加新代理 | 创建新的代理实例，指定工作区 | openclaw agents add <代理名> –workspace <工作区路径> |
openclaw agents add work –workspace ~/.openclaw/work |
| 查看代理状态 | 查看指定代理的状态 | openclaw agents status <代理名> |
openclaw agents status work |
- 会话管理命令
用于管理聊天会话，查看历史、重置会话等。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 查看活跃会话 | 列出当前活跃的聊天会话 | openclaw sessions list | openclaw sessions list |
| 查看会话历史 | 查看指定会话的聊天历史 | openclaw sessions history <会话ID> |
openclaw sessions history session-123 |
| 重置会话 | 重置指定的会话，清空历史记录 | openclaw sessions reset <会话ID> |
openclaw sessions reset session-123 |
- 技能管理命令
用于管理 OpenClaw 的技能，扩展功能。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 列出已安装技能 | 查看所有已安装的技能 | openclaw skills list | openclaw skills list |
| 安装技能 | 安装指定的技能 | openclaw skills install <技能名> |
openclaw skills install weather |
| 查看技能配置 | 查看指定技能的配置信息 | openclaw skills config <技能名> |
openclaw skills config weather |
| 更新技能 | 更新指定的技能到最新版本 | openclaw skills update <技能名> |
openclaw skills update weather |
- 日志和诊断命令
用于查看日志、诊断问题。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 实时查看日志 | 实时跟踪 Gateway 的日志输出 | openclaw logs –follow | openclaw logs –follow |
| 查看最近日志 | 查看最近指定行数的日志 | openclaw logs –limit <行数> |
openclaw logs –limit 100 |
| 诊断和修复 | 自动诊断系统问题并尝试修复 | openclaw doctor | openclaw doctoropenclaw doctor –fix（自动修复） |
- 更新和升级命令
用于更新 OpenClaw 到最新版本。
| 命令 | 说明 | 语法 | 示例 | ||
|---|---|---|---|---|---|
| 检查更新 | 查看当前版本和最新版本信息 | openclaw –version | openclaw –version | ||
| 自动更新 | 通过官方安装脚本更新 OpenClaw | `curl -fsSL https://openclaw.ai/install.sh | bash` | `curl -fsSL https://openclaw.ai/install.sh | bash` |
| 从源码更新 | 如果从源码安装，通过 git 更新 | git pull origin main && pnpm install && pnpm build | git pull origin main && pnpm install && pnpm build |
- 安全相关命令
用于审计系统安全、加固配置。
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 安全审计 | 审计系统的安全配置，检测潜在风险 | openclaw security audit | openclaw security audit |
| 深度安全审计 | 进行更全面的安全审计 | openclaw security audit –deep | openclaw security audit –deep |
三、聊天斜杠命令
在聊天窗口中使用的命令，所有支持的聊天平台（WhatsApp、Telegram、Discord、WebChat 等）通用。
- 基础会话命令
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 新开对话 | 重置当前会话，清空历史记录，节省 Token 消耗 | /new | /new |
| 新开对话并切换模型 | 重置会话并切换到指定模型 | /new <模型名> |
/new haiku/new claude-sonnet-4-5 |
| 查看会话状态 | 查看当前会话的状态，包括模型、Token 使用量、预估成本 | /status | /status |
| 查看帮助 | 查看所有斜杠命令的帮助信息 | /help | /help |
| 查看命令列表 | 查看所有可用的斜杠命令 | /commands | /commands |
- 模型和上下文管理命令
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 切换模型 | 切换当前会话使用的 AI 模型 | /model <模型名> |
/model haiku/model opus/model claude-opus-4-5 |
| 查看可用模型 | 列出所有可用的 AI 模型 | /model list | /model list |
| 查看模型状态 | 查看当前使用的模型的详细状态 | /model status | /model status |
| 压缩上下文 | 将历史对话压缩成摘要，减少 Token 消耗，同时保留关键信息 | /compact | /compact |
| 带指令压缩上下文 | 指定压缩规则，告诉 AI 保留哪些信息 | /compact <压缩指令> |
/compact 保留代码相关的讨论，其他可以简化 |
| 查看用量 | 控制 Token 和成本的显示方式 | /usage <模式> |
/usage off（关闭用量显示）/usage tokens（只显示 Token 数量）/usage full（显示完整用量详情）/usage cost（显示成本统计） |
| 查看上下文详情 | 查看当前上下文的详细信息，包括 Token 分布 | /context | /context/context list（列出上下文组件）/context detail（显示详细 Token 分布）/context json（JSON 格式输出） |
- 执行控制命令
| 命令 | 说明 | 语法 | 示例 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| 执行控制 | 控制 OpenClaw 执行系统命令的权限和方式 | /exec | /exec（查看当前设置）`/exec host=| gateway |
node>（设置执行主机） | /exec security= allowlist |
full>（设置安全模式） | /exec ask= on-miss |
always>`（设置询问模式） |
|
| 批准操作 | 批准 OpenClaw 需要权限的操作 | /approve <操作ID> <权限> | /approve abc123 allow-once（允许本次操作）/approve abc123 allow-always（永久允许此类操作）/approve abc123 deny（拒绝操作） | ||||||
| 提升权限模式 | 控制是否需要频繁确认操作 | /elevated <模式> | /elevated on（启用提升权限，减少询问）/elevated full（完全跳过询问，谨慎使用）/elevated off（关闭提升权限） |
- 语音和子代理命令
| 命令 | 说明 | 语法 | 示例 |
|---|---|---|---|
| 语音合成控制 | 控制 TTS（文本转语音）功能 | /tts <模式> | /tts off（关闭语音合成）/tts always（所有回复都用语音播放）/tts inbound（仅对语音输入的回复用语音播放）/tts tagged（仅播放标记的内容）/tts status（查看当前 TTS 状态）/tts provider（查看或切换 TTS 提供商） |
| 子代理管理 | 管理后台运行的子代理，处理并行任务 | /subagents <操作> | /subagents list（列出所有子代理）/subagents stop <代理ID> （停止指定子代理）/subagents log <代理ID> （查看子代理日志）/subagents info <代理ID> （查看子代理详情）/subagents send <代理ID> <消息> （向子代理发送消息） |
四、常用命令速查表
| 场景 | 推荐命令 |
|---|---|
| 日常状态检查 | openclaw status、/status |
| 启动 / 停止服务 | openclaw gateway start、openclaw gateway stop |
| 切换模型 | /model haiku、/model opus |
| 节省 Token | /new、/compact |
| 成本监控 | /usage full、openclaw status –all |
| 调试问题 | openclaw logs –follow、openclaw doctor |
| 批准用户配对 | openclaw pairing approve <频道> <配对码> |
五、常见问题
- 命令在 Web UI 中不起作用怎么办？
这是已知 Bug，临时解决方案：
- 使用其他渠道（WhatsApp/Telegram）执行命令
- 使用 CLI 命令替代，如openclaw gateway status
- 等待官方修复后更新版本
- 如何节省 API 成本？
- 定期使用/new重置对话，减少 Token 累积
- 日常任务使用/model haiku，复杂任务临时切换到/model opus
- 开启/usage full监控 Token 消耗
- 使用/compact压缩长对话的上下文
- 如何查看所有可用命令？
在聊天窗口输入/help或/commands，可以查看完整的斜杠命令列表；在终端输入openclaw –help可以查看所有 CLI 命令。 - Gateway 无法启动怎么办？
- 查看详细错误：openclaw gateway –verbose
- 检查端口占用：lsof -i :18789
- 检查配置：openclaw doctor
- 查看日志：openclaw logs –follow | tail -50
- 国内用户需要设置代理：export HTTPS_PROXY=”http://127.0.0.1:7890“
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/249102.html原文链接：https://javaforall.net
