OpenClawセッション管理ツール：履歴取得とメッセージ送信を自動化

複数のエージェントを並行して動かす際、それぞれのセッションが独立しすぎていると、情報の共有や連携が難しくなります。「別のセッションの内容を確認したい」「特定のタスクをバックグラウンドで別の子エージェントに任せたい」といった場面は、高度な自動化を目指すほど増えていくものです。

OpenClawのSession Toolsを使用すると、エージェントはセッションをまたいで作業できるようになります。会話のリスト表示、履歴の読み取り、他のセッションへのメッセージ送信、そしてサブエージェントの生成など、柔軟な連携が可能です。

利用可能なツール

Tool	What it does
sessions_list	List sessions with optional filters (kind, recency)
sessions_history	Read the transcript of a specific session
sessions_send	Send a message to another session and optionally wait
sessions_spawn	Spawn an isolated sub-agent session for background work

セッションのリスト表示と読み取り

sessions_list は、セッションのキー、種類（kind）、チャネル、モデル、トークン数、タイムスタンプを返します。種類（main, group, cron, hook, node）や直近の活動時間（activeMinutes）でフィルタリングすることも可能です。

sessions_history は、特定のセッションの会話ログを取得します。デフォルトではツールの実行結果は除外されますが、includeTools: true を渡すことでそれらを含めることができます。

どちらのツールも、セッションキー（"main" など）または以前のリスト呼び出しで取得した セッションID のいずれかを受け入れます。

セッション間でのメッセージ送信

sessions_send は、別のセッションにメッセージを送り、必要に応じてその応答を待ちます。

• 投げっぱなし（Fire-and-forget）: timeoutSeconds: 0 に設定すると、キューに追加してすぐに戻ります。
• 返信を待つ: タイムアウトを設定すると、レスポンスをインラインで取得できます。

ターゲットが応答した後、OpenClawはエージェントが交互にメッセージをやり取りする リプライバックループ（最大5ターン）を実行できます。ターゲットとなるエージェントは、REPLY_SKIP を返して早期に終了させることも可能です。

サブエージェントの生成

sessions_spawn は、バックグラウンドタスク用に分離されたセッションを作成します。これは常に非ブロッキングで動作し、実行後すぐに runId と childSessionKey を返します。

主なオプションは以下の通りです。

• runtime: デフォルトは "subagent" です。外部のハーネスエージェントを使用する場合は "acp" を指定します。
• model と thinking: 子セッションでモデルや思考プロセスを上書きする場合に使用します。
• thread: true: 生成されたセッションを特定のチャットスレッド（DiscordやSlackなど）に紐付けます。
• sandbox: "require": 子セッションにサンドボックス環境を強制します。

サブエージェントは、セッションツール以外のすべてのツールセットを利用できます（再帰的な生成はできません）。タスク完了後、アナウンスステップによって依頼元のチャネルに結果が投稿されます。

ACP固有の動作については、ACP Agents を参照してください。

可視性

Session Toolsには、エージェントが参照できる範囲を制限するスコープがあります。

Level	Scope
self	Only the current session
tree	Current session + spawned sub-agents
agent	All sessions for this agent
all	All sessions (cross-agent if configured)

デフォルトは tree です。サンドボックス化されたセッションは、設定に関わらず tree に制限されます。

さらに詳しく

• Session Management — ルーティング、ライフサイクル、メンテナンス
• ACP Agents — 外部ハーネスの生成
• Multi-agent — マルチエージェントアーキテクチャ
• Gateway Configuration — セッションツールの設定項目

次のステップ

• Session Management を読んで、セッションのライフサイクルを理解する
• Gateway Configuration で、ツールの権限設定を確認する

AI Setup Assistant