openclaw worker
openclaw worker は、準備済みのワーカー環境内でクラウドワーカーオーケストレーターが起動するための制限付きランタイムエントリポイントです。手動でワーカーを登録するための汎用コマンドではありません。
Gateway は対応する OpenClaw バンドルをインストールし、ホストキーが固定されたリバース SSH トンネルを開きます。ワーカーランチャーは、準備済みの割り当てを使用してこのコマンドを起動します。このコマンドは、トンネルによって転送されたローカルソケットを介して接続し、専用の worker ロールとして受け入れられます。
起動コントラクト
このコマンドは、標準入力からサイズ制限付きの JSON 起動エンベロープを正確に 1 つ読み取ります。エンベロープには、ローカルソケットの場所、発行されたワーカー認証情報、バンドルとプロトコルの識別情報、所有者エポック、割り当てられた単一のセッションとターン、およびそのターンで許可されたワーカー固有の正確なツール名が含まれます。Gateway は引き渡し前に現在のポリシーからこの最終ツールセットを解決します。未加工の設定とスケジュール済み所有者の識別情報がワーカーエンベロープに入ることはありません。 認証情報がコマンドライン引数から受け入れられることはなく、このページでは意図的に認証情報や手書きのエンベロープの例を提供していません。 エンベロープが無効、認証情報が拒否された、バンドルまたはプロトコル機能が一致しない、あるいはセッションと所有者エポックが最新でなくなった場合、受け入れはフェイルクローズします。ツール名の欠落、重複、または不明なツール名もエンベロープを無効にします。オペレーターは、このエントリポイントを直接呼び出すのではなく、クラウドワーカーオーケストレーターを通じてワーカーを起動する必要があります。ランタイム境界
このプロセスは、制限付きバックエンドを使用して通常の組み込みエージェントループを実行します。read、write、edit、apply_patch、exec、およびprocessのコーディングツールは、Gateway が発行したターン権限に含まれている場合、ワーカーワークスペース内でローカルに実行されます。権限が空の場合、モデルはツールなしで実行されます。- モデル呼び出しは Gateway の推論プロキシを使用します。ローカルモデルの認証プロファイルは読み込まれません。
- トランスクリプトの書き込みには、Gateway のトランスクリプトコミット RPC を使用します。
- ストリーミングおよびツールライフサイクルの更新には、Gateway のライブイベント RPC を使用します。
- 割り当てられたセッションとターンのみが受け入れられます。
stale-base-leaf のトランスクリプト拒否が発生すると、現在の実行は直ちに停止します。ワーカーモードでは、拒否されたシーケンスを別のリーフに対して再試行しないため、重複コミットは生成されません。その実行でまだコミットされていないメモリ内の末尾は失われます。再起動はマイルストーン 3 の配置所有者が担当し、Gateway の正式なトランスクリプトとコミット台帳から新しい割り当てを作成する必要があります。同様に、Gateway プロセスが再起動すると、保留中の推論ターンはプロバイダーエラーで終了します。アクティブな同一プロセスの推論ストリームに再接続できるのは、トンネルまたはワーカー WebSocket の再接続のみです。
閉じたワーカー RPC サーフェスについては Gateway プロトコルを、アーキテクチャとセキュリティモデルについてはクラウドワーカー計画を参照してください。