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 セッションに関連付けられる永続的な目標です。 長時間にわたる作業について、エージェントとオペレーターが共有するターゲットを提供しますが、 そのターゲットをバックグラウンドタスク、リマインダー、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 の作成または更新。
  • デバッグ実行: バグの再現、所有するサーフェスの特定、パッチ適用、修正の証明。
  • ドキュメント作業: 関連ドキュメントの確認、新しいページの作成、クロスリンク、ドキュメントビルドの検証。
  • メンテナンスタスク: 現在の状態の調査、範囲を限定した変更、適切なチェックの実行、変更内容の報告。

ゴールはタスクキューではありません。作業を切り離して実行する、スケジュールで繰り返す、 管理されたサブ作業に展開する、またはポリシーとして永続化する必要がある場合は、 タスクフロー、タスク、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 はセッションからゴールを削除します。

1 つのセッションに存在できるゴールは一度に 1 つだけです。2 つ目のゴールを開始すると、 現在のゴールがクリアされるまで失敗します。

ステータス

ゴールは小さなステータスセットを使用します。

  • 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 は、エージェントハーネスに 3 つのコアゴールツールを公開します。

  • get_goal: ステータス、目標、トークン使用量、トークン予算を含む現在のセッションゴールを読み取ります。
  • create_goal: ユーザー、システム、または開発者の指示が明示的に要求した場合にのみゴールを作成します。セッションにすでにゴールがある場合は失敗します。
  • update_goal: ゴールを complete または blocked としてマークします。

モデルはゴールを暗黙に一時停止、再開、クリア、または置き換えることはできません。これらは /goal とリセットコマンドを通じたオペレーター/セッション制御です。これにより、 エージェントがターゲットをひそかに動かすことを防ぎつつ、達成または本当のブロッカーを エージェントが報告するための明確な経路を維持します。

update_goal ツールは、目標が実際に達成された場合にのみゴールを complete としてマークするべきです。 同じブロック条件が繰り返され、エージェントが新しいユーザー入力または外部状態の変化なしには 意味のある進捗を出せない場合にのみ、ゴールを blocked としてマークするべきです。

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 つのサーフェスが同じセッションを使用している場合、 同じゴールが表示されます。

ゴール状態は配信ディレクティブではありません。チャンネル経由の返信を強制したり、 キューの動作を変更したり、ツールを承認したり、作業をスケジュールしたりしません。

トラブルシューティング

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