---
doc-schema-version: 1
read_when:
    - OpenClaw に長いセッションを通じて1つの目的を表示し続けたい
    - セッション目標を一時停止、再開、ブロック、完了、またはクリアする必要がある
    - get_goal、create_goal、update_goal ツールを理解したい
    - TUIでゴールがどのように表示されるかを確認したい場合
summary: 'セッション目標: 永続的なセッションごとの目的、/goal コントロール、モデルの目標ツール、トークン予算、TUI ステータス'
title: 目標
x-i18n:
    generated_at: "2026-06-27T13:13:33Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 4313983dff7f37496f6c996303cace75f6863a71c8a9cd5367fdafbcc3f459c4
    source_path: tools/goal.md
    workflow: 16
---

# ゴール

**ゴール**は、現在の 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 の作成または更新。
- デバッグ実行: バグの再現、所有するサーフェスの特定、パッチ適用、修正の証明。
- ドキュメント作業: 関連ドキュメントの確認、新しいページの作成、クロスリンク、ドキュメントビルドの検証。
- メンテナンスタスク: 現在の状態の調査、範囲を限定した変更、適切なチェックの実行、変更内容の報告。

ゴールはタスクキューではありません。作業を切り離して実行する、スケジュールで繰り返す、
管理されたサブ作業に展開する、またはポリシーとして永続化する必要がある場合は、
[タスクフロー](/ja-JP/automation/taskflow)、[タスク](/ja-JP/automation/tasks)、[Cron ジョブ](/ja-JP/automation/cron-jobs)、または
[常設指示](/ja-JP/automation/standing-orders)を使用します。

## コマンドリファレンス

引数なしの `/goal` は現在のゴール概要を出力します。

```text
Goal
Status: active
Objective: get CI green for PR 87469 and push the fix
Tokens used: 12k
Token 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 がセッション使用量と
トランスクリプト由来の合計を記録するにつれて、使用量は更新されます。

## 関連

- [スラッシュコマンド](/ja-JP/tools/slash-commands)
- [TUI](/ja-JP/web/tui)
- [セッションツール](/ja-JP/concepts/session-tool)
- [Compaction](/ja-JP/concepts/compaction)
- [タスクフロー](/ja-JP/automation/taskflow)
- [常設指示](/ja-JP/automation/standing-orders)