ゴール
ゴールとは、現在の OpenClaw セッションに紐付けられた、永続的な目標のことです。 長期間にわたる作業について、エージェントとオペレーターが共通の目標を持てるようにしますが、 その目標をバックグラウンドタスク、リマインダー、Cron ジョブ、または 常設指示に変えるものではありません。 ゴールはセッション状態です。セッションキーとともに移動し、プロセスの 再起動後も維持され、/goal、モデル向けゴールツール、および TUI
フッターに表示されます。
切り離されたコマンドの完了結果は、元のユーザー向けスレッドに返されるため、
コマンド実行で別のサンドボックスポリシーセッションを使用した場合でも、
次のターンでは同じゴールが引き続き表示されます。
クイックスタート
start は省略可能です。/goal get CI green for PR 87469 でもゴールが作成されます。
これは、/goal の後にある既知のアクションワードではないテキストが、
新しい目標として扱われるためです。
ゴールの用途
多数のターンにわたって表示し続けるべき具体的な成果がセッションにある場合は、 ゴールを使用します。- PR の完了作業：修正、検証、autoreview、プッシュ、および PR の作成または更新。
- デバッグ作業：バグを再現し、所有するサーフェスを特定して、パッチを適用し、 修正を実証する。
- ドキュメント作業：関連ドキュメントを読み、新しいページを作成し、相互リンクを追加して、 ドキュメントのビルドを検証する。
- メンテナンスタスク：現在の状態を調査し、範囲を限定した変更を行い、適切な チェックを実行して、変更内容を報告する。
コマンドリファレンス
引数なしの/goal は、現在のゴールの概要を表示します。
1 つのセッションに同時に存在できるゴールは 1 つだけです。現在のゴールがクリアされるまで、
2 つ目のゴールを開始しようとすると
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 は、エージェントハーネスに 3 つのゴールツールを公開します。
モデルは、ゴールを暗黙に一時停止、再開、クリア、または置換できません。これらは
/goal およびリセットコマンドを通じたオペレーターまたはセッションの制御として
維持されます。これにより、エージェントは目標を勝手に変更することなく、
達成または実際の阻害要因を報告できます。
update_goal がゴールを complete にするのは、目標が
実際に達成された場合のみです。ゴールを blocked にするのは、同じ
阻害条件が少なくとも 3 回連続したゴールターンで再発した後に限られます。通常の
難しさや仕上げ不足を理由にしてはなりません。
各ターンのゴールコンテキスト
アクティブなゴールがあるすべてのユーザーまたはチャットターンには、次のユーザーロールのコンテキスト行が含まれます。Control UI
Web の Control UI では、チャット入力欄の上にゴールがコンパクトなピルとして表示されます。 ピルには、ステータスアイコン、ステータスラベル（たとえばPursuing goal）、切り詰められた
目標、およびリアルタイムの経過時間タイマーが含まれます。
ピルにはインラインコントロールがあります。
- 鉛筆は、目標を言い換えて送信できるように、
入力欄へ
/goal edit <objective>を事前入力します。 - 一時停止 / 再開は、現在のステータスに応じて
/goal pauseと/goal resumeを切り替えます。 - ゴミ箱は
/goal clearを送信します。 - シェブロンはピルを展開し、目標の全文、最新のステータス メモ、トークン使用量、および経過時間を表示します。
TUI
TUI フッターでは、アクティブなセッションのゴールが、トークンおよびモードのインジケーターより前に、 エージェント、セッション、モデルの各フィールドと並んで表示されます。 フッターの例：- トークン予算があるアクティブなゴールでは
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 は、TUI やテキストコマンドを許可するチャットサーフェスを含む、
コマンド対応の OpenClaw セッションで機能します。ゴールの状態はトランスポートではなく
セッションキーに紐付けられるため、同じセッションキーを共有する 2 つのサーフェスには
同じゴールが表示されます。
ゴールの状態は配信指示ではありません。チャネル経由の返信を強制したり、
キューの動作を変更したり、ツールを承認したり、作業をスケジュールしたりすることはありません。
トラブルシューティング
トークン使用量に
0 が表示される場合や、古いように見える場合は、アクティブなセッションに
まだ最新のトークンスナップショットがない可能性があります。OpenClaw がセッション使用量と
トランスクリプトから算出した合計を記録すると、使用量が更新されます。