OpenClaw 入门及折腾记录

1.1 两大类指令#

OpenClaw 的指令分为两大类：

本文主要介绍聊天中的斜杠命令，这些命令在 WhatsApp、Telegram、Slack、Discord、WebChat 等所有平台都通用。

💡 小技巧：在任何聊天窗口输入 /help 或 /commands 可以查看完整的命令列表。

指令 1: /new — 新开对话#

重要程度：⭐⭐⭐⭐⭐

核心价值：OpenClaw 会把历史对话全部传给 API，导致 Token 累积。使用 /new 开始新会话，可以大幅节省 Token 成本。

基本语法：

1
/new                    # 开始新对话
2
/new haiku             # 新对话 + 切换到 Haiku 模型
3
/new claude-sonnet-4-5 # 新对话 + 指定完整模型名

使用场景：

技术细节：

• 创建新的 sessionId
• 重置 compactionCount 计数器
• 保留 sessions.json 配置
• 不影响已保存的记忆（AGENTS.md）

💰 省钱技巧：通过 APIYI 平台调用 API，配合 /new 命令定期重置，可以将 Token 消耗降低 50% 以上。

指令 2: /status — 查看状态#

重要程度：⭐⭐⭐⭐⭐

核心价值：快速了解当前会话状态、Token 使用量和预估成本。

基本语法：

1
/status

输出内容：

使用建议：

• 感觉对话变慢时检查 /status
• 上下文超过 50% 时考虑 /new
• 定期检查成本，避免”烧钱”

指令 3: /model — 切换模型#

重要程度：⭐⭐⭐⭐⭐

核心价值：动态切换 AI 模型，实现成本和性能的最优平衡。

基本语法：

1
/model list              # 查看可用模型列表
2
/model haiku            # 切换到 Haiku（省钱）
3
/model sonnet           # 切换到 Sonnet（平衡）
4
/model opus             # 切换到 Opus（强力）
5
/model 3                # 使用模型编号切换
6
/model status           # 查看当前模型详情
7
/model sonnet@work      # 使用特定认证配置

模型选择建议：

模型别名：

1
/model haiku  → claude-haiku-4-5
2
/model sonnet → claude-sonnet-4-5
3
/model opus   → claude-opus-4-5

💡 省钱技巧：日常任务使用 /model haiku，只在复杂任务时临时 /model opus。通过 APIYI 平台，可以在同一 API Key 下无缝切换多种模型。

指令 4: /compact — 压缩上下文#

重要程度：⭐⭐⭐⭐

核心价值：当对话变长但不想丢失上下文时，使用 /compact 将聊天历史压缩为摘要。

基本语法：

1
/compact                              # 默认压缩
2
/compact 保留代码相关讨论，其他简化    # 带指令压缩

工作原理：

1. 总结旧的聊天内容
2. 保留最近的消息
3. 摘要存储在记录中
4. 显著减少 Token 消耗

使用场景：

/compact vs /new 对比：

指令 5: /usage — 查看用量#

重要程度：⭐⭐⭐⭐

核心价值：详细监控 Token 消耗和成本，是成本控制的核心工具。

基本语法：

1
/usage off      # 禁用用量显示
2
/usage tokens   # 仅显示 Token 数量
3
/usage full     # 显示完整用量详情
4
/usage cost     # 显示本地成本统计

参数说明：

输出示例：

1
📊 Tokens: Input 1,234 | Output 567 | Total 1,801
2
💰 Cost: $0.0234

💡 专业提示：访问 APIYI 平台控制台，可以查看更详细的用量统计和历史趋势。

指令 6: /context — 查看上下文详情#

重要程度：⭐⭐⭐

核心价值：深入了解 Token 消耗的具体来源，帮助针对性优化。

基本语法：

1
/context           # 查看上下文概览
2
/context list      # 列出上下文组件
3
/context detail    # 显示每个文件/工具的 Token 占用
4
/context json      # JSON 格式输出

输出内容：

• Bootstrap 文件（SOUL.md, AGENTS.md 等）的 Token 数
• 每个 Skill 的 Token 占用
• 工具定义的 Token 消耗
• 系统提示词总大小

这对于优化系统提示词、精简 Bootstrap 文件非常有帮助。

指令 7: /exec — 执行控制#

重要程度：⭐⭐⭐

核心价值：控制 OpenClaw 执行系统命令的权限和方式。

基本语法：

1
/exec                                    # 查看当前执行设置
2
/exec host=sandbox security=allowlist    # 沙箱 + 白名单模式
3
/exec ask=always                         # 每次都询问

参数详解：

安全建议：

• ✅ 初次使用建议 security=allowlist ask=always
• ✅ 熟悉后可改为 ask=on-miss
• ✅ 敏感环境保持 host=sandbox

指令 8: /approve — 批准操作#

重要程度：⭐⭐⭐

核心价值：当 OpenClaw 请求执行操作权限时，使用此命令响应。

基本语法：

1
/approve abc123 allow-once    # 允许本次操作
2
/approve abc123 allow-always  # 永久允许此类操作
3
/approve abc123 deny          # 拒绝操作

参数说明：

配合 /elevated 使用：

1
/elevated on     # 启用提升权限模式（减少提示）
2
/elevated full   # 完全跳过提示（谨慎使用）
3
/elevated off    # 禁用提升权限

指令 9: /tts — 语音控制#

重要程度：⭐⭐

核心价值：控制 OpenClaw 的文本转语音（TTS）功能。

基本语法：

1
/tts off        # 禁用语音
2
/tts always     # 所有回复都播放语音
3
/tts inbound    # 仅对语音输入回复语音
4
/tts tagged     # 仅播放标记内容的语音
5
/tts status     # 查看当前 TTS 状态
6
/tts provider   # 查看或切换 TTS 提供商

TTS 提供商：

• Edge TTS：免费，默认回退选项
• OpenAI TTS：高质量，需要 API Key
• ElevenLabs：适合自定义语音，需要配置

指令 10: /subagents — 子代理管理#

重要程度：⭐⭐

核心价值：管理后台运行的子代理，适合长时间或并行任务。

基本语法：

1
/subagents list           # 列出所有子代理
2
/subagents stop agent-123 # 停止指定子代理
3
/subagents log agent-123  # 查看子代理日志
4
/subagents info agent-123 # 查看子代理详情
5
/subagents send agent-123 <message> # 向子代理发送消息

使用场景：

• 让子代理处理长时间的代码分析
• 并行执行多个独立任务
• 保持主对话简洁，复杂任务交给子代理

Q1: 命令在 Web UI 中不起作用怎么办？#

这是一个已知 Bug（Issue #4446）。临时解决方案：

• 使用其他渠道（WhatsApp/Telegram）执行命令
• 使用 CLI 命令：openclaw gateway status
• 等待官方修复后更新版本

Q2: 如何查看所有可用命令？#

在聊天中输入：

1
/help
2
# 或
3
/commands

会显示完整的命令列表和简要说明。

Q3: 如何节省 API 成本？#

三大省钱策略：

1. 定期 /new：每完成一个任务就重置会话
2. 灵活 /model：日常用 haiku，复杂任务用 opus
3. 善用 /compact：长对话压缩上下文

配合 APIYI 平台的优惠价格，可以实现成本最优化。