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

Agent coordination

目標

Status: active

目標

目標是附加到目前 OpenClaw 工作階段的一個持久目標。 它讓代理程式和操作者在長時間工作中擁有共同目標， 而不會把該目標變成背景任務、提醒、排程工作或 常設指令。

目標是工作階段狀態。它們會隨工作階段金鑰移動、在程序 重新啟動後保留、顯示在 /goal 中，可透過目標 工具提供給模型，並在作用中工作階段有目標時出現在終端介面頁尾。

快速開始

設定目標：

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 收尾：修正、驗證、自動審查、推送，並開啟或更新 PR。
  • 偵錯執行：重現錯誤、識別所屬介面、修補，並證明 修正有效。
  • 文件整理：閱讀相關文件、撰寫新頁面、加入交叉連結，並 驗證文件建置。
  • 維護任務：檢查目前狀態、進行有界變更、執行正確 檢查，並回報變更內容。

目標不是任務佇列。當工作應脫離目前工作階段執行、 按排程重複、展開成受管理的子工作，或作為政策持久存在時，請使用 任務流程、 任務、排程工作，或 常設指令。

命令參考

不帶引數的 /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：已達設定的權杖預算；/goal resume 會從相同目標重新開始追求。
  • usage_limited：保留給用量限制停止狀態；允許時，/goal resume 會重新開始追求。
  • complete：目標已達成。已完成的目標是終端狀態；開始另一個目標前， 請使用 /goal clear。

/new 和 /reset 會清除目前工作階段目標，因為它們會刻意 開始新的工作階段內容。

權杖預算

目標可以有選用的正值權杖預算。預算會與目標一同儲存， 並從建立時工作階段的新鮮權杖計數開始衡量。如果目標啟動時， 目前工作階段只有過期或未知的權杖用量， OpenClaw 會等待下一個新鮮的工作階段權杖快照，並將其作為 基準，因此目標存在前花費的權杖不會計入該目標。

當權杖用量達到預算時，目標會變為 budget_limited。這 不會刪除目標或抹除目標內容。它會告知操作者和 代理程式：在恢復或清除之前，該目標不再被主動追求。

權杖預算是工作階段目標的護欄，不是計費上限。供應商配額、 成本回報和內容視窗行為仍使用一般 OpenClaw 用量和模型控制。

模型工具

OpenClaw 向代理程式執行框架公開三個核心目標工具：

  • get_goal：讀取目前工作階段目標，包括狀態、目標內容、權杖 用量和權杖預算。
  • create_goal：只有在使用者、系統或開發者 指示明確要求時才建立目標。如果工作階段已經有 目標，則會失敗。
  • update_goal：將目標標記為 complete 或 blocked。

模型不能靜默暫停、恢復、清除或取代目標。這些是 透過 /goal 和重設命令執行的操作者／工作階段控制。這能避免 代理程式悄悄移動目標，同時保留一條乾淨路徑，讓 代理程式回報達成或真實阻礙。

update_goal 工具只有在目標內容確實已達成時，才應將目標標記為 complete。只有當相同的阻礙條件重複出現，且代理程式若沒有 新的使用者輸入或外部狀態變更便無法取得有意義進展時，才應將目標標記為 blocked。

終端介面

終端介面會在頁尾中，將作用中工作階段的目標顯示在 代理程式、工作階段、模型、執行控制項和權杖計數旁邊。

頁尾範例：

  • Pursuing goal (12k/50k) 表示有權杖預算的作用中目標。
  • Goal paused (/goal resume) 表示已暫停的目標。
  • Goal blocked (/goal resume) 表示受阻的目標。
  • Goal hit usage limits (/goal resume) 表示用量受限的目標。
  • Goal unmet (50k/50k) 表示預算受限的目標。
  • Goal achieved (42k) 表示已完成的目標。

頁尾刻意保持精簡。使用 /goal 查看完整目標內容、備註、 權杖預算和可用命令。

通道行為

/goal 命令可在支援命令的 OpenClaw 工作階段中運作，包括 終端介面，以及允許文字命令的聊天介面。目標狀態附加到 工作階段金鑰，而不是傳輸方式。如果兩個介面使用相同工作階段，它們會看到 相同目標。

目標狀態不是傳遞指令。它不會強制透過某個 通道回覆、變更佇列行為、核准工具或排程工作。

疑難排解

Goal error: goal already exists 表示工作階段已經有目標。使用 /goal 檢查它；如果已完成，使用 /goal complete；或在 開始不同目標前使用 /goal clear。

Goal error: goal not found 表示工作階段尚未有目標。使用 /goal start <objective> 啟動一個目標。

Goal error: goal is already complete 表示目標是終端狀態。請先清除它， 再開始或恢復另一個目標。

如果權杖用量看起來像 0 或過期，作用中工作階段可能尚未有新鮮的 權杖快照。當 OpenClaw 記錄工作階段用量和 從對話紀錄推導的總量時，用量會重新整理。

相關

Was this useful?
On this page

On this page