---
read_when:
    - Gateway から起動されたクラウドワーカーの運用またはデバッグ
    - ワーカーの受け入れ、セッションの割り当て、またはローカルツールの分離の検証
summary: 制限付きクラウドワーカーランタイムの内部オペレーター向けリファレンス
title: ワーカー
x-i18n:
    generated_at: "2026-07-26T08:59:26Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 0c4749e2abaf4fca00d903114b0661454d67207547fe17711dc5315656e0cd14
    source_path: cli/worker.md
    workflow: 16
---

# `openclaw worker`

`openclaw worker` は、準備済みのワーカー環境内でクラウドワーカーオーケストレーターが起動するための制限付きランタイムエントリポイントです。手動でワーカーを登録するための汎用コマンドではありません。

Gateway は対応する OpenClaw バンドルをインストールし、ホストキーが固定されたリバース SSH トンネルを開きます。ワーカーランチャーは、準備済みの割り当てを使用してこのコマンドを起動します。このコマンドは、トンネルによって転送されたローカルソケットを介して接続し、専用の `worker` ロールとして受け入れられます。

## 起動コントラクト

このコマンドは、標準入力からサイズ制限付きの JSON 起動エンベロープを正確に 1 つ読み取ります。エンベロープには、ローカルソケットの場所、発行されたワーカー認証情報、バンドルとプロトコルの識別情報、所有者エポック、割り当てられた単一のセッションとターン、およびそのターンで許可されたワーカー固有の正確なツール名が含まれます。Gateway は引き渡し前に現在のポリシーからこの最終ツールセットを解決します。未加工の設定とスケジュール済み所有者の識別情報がワーカーエンベロープに入ることはありません。
認証情報がコマンドライン引数から受け入れられることはなく、このページでは意図的に認証情報や手書きのエンベロープの例を提供していません。

エンベロープが無効、認証情報が拒否された、バンドルまたはプロトコル機能が一致しない、あるいはセッションと所有者エポックが最新でなくなった場合、受け入れはフェイルクローズします。ツール名の欠落、重複、または不明なツール名もエンベロープを無効にします。オペレーターは、このエントリポイントを直接呼び出すのではなく、クラウドワーカーオーケストレーターを通じてワーカーを起動する必要があります。

## ランタイム境界

このプロセスは、制限付きバックエンドを使用して通常の組み込みエージェントループを実行します。

- `read`、`write`、`edit`、`apply_patch`、`exec`、および `process` のコーディングツールは、Gateway が発行したターン権限に含まれている場合、ワーカーワークスペース内でローカルに実行されます。権限が空の場合、モデルはツールなしで実行されます。
- モデル呼び出しは Gateway の推論プロキシを使用します。ローカルモデルの認証プロファイルは読み込まれません。
- トランスクリプトの書き込みには、Gateway のトランスクリプトコミット RPC を使用します。
- ストリーミングおよびツールライフサイクルの更新には、Gateway のライブイベント RPC を使用します。
- 割り当てられたセッションとターンのみが受け入れられます。

ワーカーモードでは、割り当てられたセッションのツールセットを超えて、チャンネル、Gateway の HTTP サーフェス、または Plugin の自動起動を開始しません。使い捨ての状態ディレクトリを使用し、常設のプロバイダー認証情報や Forge 認証情報は保持しません。

このモードでは、ワーカー間のセッションディスパッチは公開されません。配置とディスパッチは引き続き Gateway が所有します。オペレーターは Gateway を通じて、既存のローカルな管理対象ワークツリーセッションをディスパッチできますが、ワーカープロセスが自身または別のワーカーをディスパッチすることはできません。

準備済みの割り当てには、トランスクリプトコンテキスト、受け入れ済みのベースリーフ、コミットシーケンス、およびライブイベントカーソルが含まれます。トンネルの再接続時、プロセスは同じ認証情報と所有者エポックで再度受け入れを要求し、受け入れ済みのトランスクリプトベースを保持し、未確認のライブイベント末尾を再生し、同一の識別情報を持つ進行中の推論ターンに再接続します。ストリーミングされた差分を取りこぼした場合は、推論の最終メッセージが正式なものとなります。新しい所有者エポックによってプロセスはフェンスされ、正常終了します。

`stale-base-leaf` のトランスクリプト拒否が発生すると、現在の実行は直ちに停止します。ワーカーモードでは、拒否されたシーケンスを別のリーフに対して再試行しないため、重複コミットは生成されません。その実行でまだコミットされていないメモリ内の末尾は失われます。再起動はマイルストーン 3 の配置所有者が担当し、Gateway の正式なトランスクリプトとコミット台帳から新しい割り当てを作成する必要があります。同様に、Gateway プロセスが再起動すると、保留中の推論ターンはプロバイダーエラーで終了します。アクティブな同一プロセスの推論ストリームに再接続できるのは、トンネルまたはワーカー WebSocket の再接続のみです。

閉じたワーカー RPC サーフェスについては [Gateway プロトコル](/ja-JP/gateway/protocol#worker-role-and-closed-protocol)を、アーキテクチャとセキュリティモデルについては[クラウドワーカー計画](/ja-JP/plan/cloud-workers)を参照してください。