目標

​

目標

目標是附加至目前 OpenClaw 工作階段的一個持久目標。 它為代理程式與操作者提供一個共同的長期工作標的， 而不會將該標的轉變為背景任務、提醒、排程工作或 常設指令。

目標屬於工作階段狀態：它會隨工作階段金鑰移動、在程序 重新啟動後仍然存在，並顯示於 /goal、提供給模型的目標工具，以及終端介面 頁尾中。

分離命令完成後會返回原始的使用者介面討論串，因此 即使命令執行使用了獨立的沙箱原則工作階段，下一回合仍會看到 相同的目標。

​

快速開始

/goal start 讓 PR 87469 的 CI 通過並推送修正
/goal
/goal edit 讓 PR 87469 的 CI 通過、推送修正，並更新文件
/goal pause 等待 CI
/goal resume
/goal complete 已推送並驗證
/goal clear

start 是選用的：/goal get CI green for PR 87469 也會建立目標， 因為 /goal 後方任何不是已知動作詞的文字，都會被視為 新的目標。

​

目標的用途

當工作階段具有應在多個回合中持續可見的具體成果時， 請使用目標：

• PR 收尾：修正、驗證、自動審查、推送，以及開啟或更新 PR。
• 偵錯作業：重現錯誤、識別負責的介面、修補，並 證明修正有效。
• 文件作業：閱讀相關文件、撰寫新頁面、建立交叉連結，並 驗證文件建置。
• 維護任務：檢查目前狀態、進行範圍明確的變更、執行 適當的檢查，並回報變更內容。

目標不是任務佇列。當工作應分離執行、 依排程重複、展開為受管理的子工作，或作為原則持續存在時，請使用 Task Flow、 任務、排程工作 或 常設指令。

​

命令參考

不帶引數的 /goal 會顯示目前的目標摘要：

目標
狀態：進行中
目標內容：讓 PR 87469 的 CI 通過並推送修正
已使用權杖：12k
權杖預算：12k/50k

命令：/goal edit <objective>、/goal pause、/goal complete、/goal clear

命令	效果
/goal 或 /goal status	顯示目前的目標。
/goal start <objective>	為目前的工作階段建立新目標。
/goal set <objective>、/goal create <objective>	start 的別名。
/goal <objective>	也會建立新目標（任何不是已識別動作詞的文字）。
/goal edit <objective>	改寫目前的目標內容；狀態與權杖計算維持不變。
/goal pause [note]	暫停進行中的目標。
/goal resume [note]	恢復已暫停、受阻、達到用量限制或達到預算限制的目標。
/goal complete [note]	將目標標記為已達成。
/goal done [note]	complete 的別名。
/goal block [note]	將目標標記為受阻。
/goal blocked [note]	block 的別名。
/goal clear	從工作階段移除目標。

一個工作階段一次只能存在一個目標。在目前目標清除之前， 啟動第二個目標會失敗，並顯示 Goal error: goal already exists。

/goal start 不接受權杖預算旗標；預算只能透過 提供給模型的 create_goal 工具設定。

​

狀態

• active：工作階段正在追求目標。
• paused：操作者已暫停目標；/goal resume 會使其再次進入 進行中狀態。
• blocked：代理程式或操作者回報了實際的阻礙；當有新的資訊或狀態可用時，/goal resume 會使其再次進入進行中狀態。
• budget_limited：已達到設定的權杖預算；/goal resume 會使用新的預算期間，從相同目標內容重新開始執行。
• usage_limited：保留供未來的用量限制停止狀態使用；/goal resume 會以相同方式重新開始執行。
• complete：目標已達成。已完成的目標是終止狀態；請先使用 /goal clear，再開始另一個目標。

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

​

權杖預算

目標可以有選用的正數權杖預算，透過 create_goal 工具的 token_budget 參數設定。預算從 建立目標時工作階段的最新權杖計數開始計量。如果目標開始時，工作階段只有 過時或未知的權杖快照，OpenClaw 會等待 下一個最新快照，並將其作為基準，因此目標存在前使用的權杖 不會計入其中。

當用量達到預算時，目標會移至 budget_limited。這不會 刪除目標或清除目標內容；它會告知操作者與 代理程式，在恢復或清除目標前，系統不再主動追求該目標。 恢復後會從目前最新的權杖 計數開始新的預算期間。

權杖預算是工作階段目標的防護機制，而非計費上限。供應商 配額、成本報告與情境視窗行為仍會使用一般的 OpenClaw 用量與模型控制。

​

模型工具

OpenClaw 向代理程式執行框架提供三個目標工具：

工具	用途
get_goal	讀取目前工作階段的目標：狀態、目標內容、權杖用量與權杖預算。
create_goal	僅在使用者或系統指示明確要求時建立目標。如果工作階段已有目標，則會失敗。
update_goal	將目標標記為 complete 或 blocked。

模型無法在未告知的情況下暫停、恢復、清除或取代目標。這些操作仍是 操作者／工作階段透過 /goal 與重設命令進行的控制，因此代理程式 可以回報目標已達成或確實受阻，而不會悄悄變更 標的。

只有在目標內容確實達成時，update_goal 才應將目標標記為 complete。 只有在相同的阻礙情況連續至少三個目標回合重複出現後，才應將目標標記為 blocked， 而不是因為一般困難或尚未完善。

​

每個回合中的目標情境

每個具有進行中目標的使用者／聊天回合都會包含這一行使用者角色情境：

進行中的目標：<objective> — 推進目標或更新其狀態（get_goal/update_goal）。

OpenClaw 會截短過長的目標內容，以維持該行簡潔。已暫停、 受阻、達到預算限制、達到用量限制及已完成的目標不會被注入， 因此操作者的停止操作會持續生效，直到目標恢復為止。

​

控制介面

網頁控制介面會在聊天輸入框上方，將目標顯示為精簡的膠囊： 包含狀態圖示、狀態標籤（例如 Pursuing goal）、截短的 目標內容，以及即時經過時間計時器。

膠囊提供行內控制項：

• 鉛筆會以 /goal edit <objective> 預先填入輸入框，以便 改寫並提交目標內容。
• 暫停／恢復會根據 目前狀態在 /goal pause 與 /goal resume 之間切換。
• 垃圾桶會傳送 /goal clear。
• 箭頭符號會展開膠囊，以顯示完整目標內容、最新狀態 備註、權杖用量與經過時間。

當輸入框無法傳送時（例如 閘道連線中斷），動作按鈕會隱藏；展開箭頭仍可使用。

​

終端介面

終端介面頁尾會在權杖／模式指示器之前，將進行中工作階段的目標顯示在代理程式、 工作階段與模型欄位旁。

頁尾範例：

• 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 記錄工作階段用量 及從逐字稿衍生的總計時，用量便會更新。

​

相關內容

• 斜線命令
• 終端介面
• 工作階段工具
• 壓縮
• Task Flow
• 常設指令