English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

快速开始

目标

Status: active

目标

目标是附加到当前 OpenClaw 会话的一个持久目标。 它为智能体和操作者提供一个用于长时间工作的共同目标， 但不会把该目标变成后台任务、提醒、cron 作业或 长期指令。

目标是会话状态。它们会随会话键移动，在进程重启后保留， 显示在 /goal 中，可通过目标工具提供给模型， 并且当活动会话存在目标时显示在 TUI 页脚中。

快速开始

设置目标：

text
/goal start get CI green for PR 87469 and push the fix

检查目标：

text
/goal

当工作有意等待时暂停目标：

text
/goal pause waiting for CI

恢复目标：

text
/goal resume

标记为完成：

text
/goal complete pushed and verified

清除目标：

text
/goal clear

目标适用场景

当一个会话有需要跨多个轮次保持可见的具体结果时，使用目标：

  • PR 收尾：修复、验证、autoreview、推送，并打开或更新 PR。
  • 调试运行：复现 bug、识别所属表面、打补丁，并证明修复有效。
  • 文档处理：阅读相关文档、编写新页面、添加交叉链接，并验证文档构建。
  • 维护任务：检查当前状态、做有边界的变更、运行合适的检查，并报告变更内容。

目标不是任务队列。当工作需要脱离运行、按计划重复、展开为受管理的子工作， 或作为策略持久存在时，请使用任务流、 任务、cron 作业或 长期指令。

命令参考

不带参数的 /goal 会打印当前目标摘要：

text
GoalStatus: activeObjective: get CI green for PR 87469 and push the fixTokens used: 12kToken budget: 12k/50k Commands: /goal pause, /goal complete, /goal clear

命令：

  • /goal 或 /goal status 显示当前目标。
  • /goal start <objective> 为当前会话创建新目标。
  • /goal set <objective> 和 /goal create <objective> 是 start 的别名。
  • /goal pause [note] 暂停活动目标。
  • /goal resume [note] 恢复已暂停、已阻塞、受用量限制或受预算限制的目标。
  • /goal complete [note] 将目标标记为已达成。
  • /goal done [note] 是 complete 的别名。
  • /goal block [note] 将目标标记为已阻塞。
  • /goal blocked [note] 是 block 的别名。
  • /goal clear 从会话中移除目标。

一个会话同一时间只能存在一个目标。在清除当前目标之前，启动第二个目标会失败。

状态

目标使用一组较小的状态：

  • active：会话正在追求该目标。
  • paused：操作者暂停了目标；/goal resume 会让它重新变为活动状态。
  • blocked：智能体或操作者报告了真实阻塞；当有新信息或新状态可用时，/goal resume 会让它重新变为活动状态。
  • budget_limited：已达到配置的 token 预算；/goal resume 会从同一目标重新开始追求。
  • usage_limited：为用量限制停止状态预留；允许时，/goal resume 会重新开始追求。
  • complete：目标已达成。完成的目标是终止状态；在启动另一个目标前使用 /goal clear。

/new 和 /reset 会清除当前会话目标，因为它们会有意启动全新的会话上下文。

Token 预算

目标可以有一个可选的正数 token 预算。该预算随目标一起存储，并从目标创建时会话的新鲜 token 计数开始计量。如果目标启动时当前会话只有过期或未知的 token 用量，OpenClaw 会等待下一次新鲜的会话 token 快照，并将其用作基线，因此目标存在之前消耗的 token 不会计入该目标。

当 token 用量达到预算时，目标会变为 budget_limited。这不会删除目标或抹除目标内容。它会告诉操作者和智能体，在恢复或清除之前，该目标不再被主动追求。

Token 预算是会话目标护栏，不是计费上限。提供商配额、成本报告和上下文窗口行为仍使用正常的 OpenClaw 用量与模型控制。

模型工具

OpenClaw 向智能体 harness 暴露三个核心目标工具：

  • get_goal：读取当前会话目标，包括状态、目标内容、token 用量和 token 预算。
  • create_goal：仅在用户、系统或开发者指令明确请求时创建目标。如果会话已有目标，它会失败。
  • update_goal：将目标标记为 complete 或 blocked。

模型不能静默暂停、恢复、清除或替换目标。这些是通过 /goal 和重置命令实现的操作者/会话控制。这样既能防止智能体悄悄移动目标，也保留一条干净路径，让智能体报告目标已达成或存在真正阻塞。

update_goal 工具只有在目标实际达成时才应将目标标记为 complete。只有当同一阻塞条件已经重复出现，且没有新的用户输入或外部状态变化时智能体无法取得有意义进展，才应将目标标记为 blocked。

TUI

TUI 会在页脚中让活动会话的目标保持可见，位置靠近智能体、会话、模型、运行控制和 token 计数。

页脚示例：

  • Pursuing goal (12k/50k) 表示带有 token 预算的活动目标。
  • Goal paused (/goal resume) 表示已暂停的目标。
  • Goal blocked (/goal resume) 表示已阻塞的目标。
  • Goal hit usage limits (/goal resume) 表示受用量限制的目标。
  • Goal unmet (50k/50k) 表示受预算限制的目标。
  • Goal achieved (42k) 表示已完成的目标。

页脚有意保持紧凑。使用 /goal 查看完整目标、备注、token 预算和可用命令。

渠道行为

/goal 命令可在支持命令的 OpenClaw 会话中使用，包括 TUI 和允许文本命令的聊天表面。目标状态附加到会话键，而不是传输层。如果两个表面使用同一个会话，它们会看到同一个目标。

目标状态不是投递指令。它不会强制通过某个渠道回复、改变队列行为、批准工具或调度工作。

故障排除

Goal error: goal already exists 表示该会话已经有一个目标。使用 /goal 检查它；如果它已完成，使用 /goal complete；或者在启动另一个目标前使用 /goal clear。

Goal error: goal not found 表示该会话还没有目标。使用 /goal start <objective> 启动一个目标。

Goal error: goal is already complete 表示该目标是终止状态。请先清除它，再启动或恢复另一个目标。

如果 token 用量看起来像 0 或已过期，活动会话可能还没有新鲜的 token 快照。随着 OpenClaw 记录会话用量和从转录推导出的总量，用量会刷新。

相关

Was this useful?
On this page

On this page