バックグラウンド実行とプロセスツール

​

exec ツール

• フォアグラウンド実行は出力を直接返します。
• バックグラウンド化された場合（明示的、または yieldMs タイムアウト経由）、ツールは status: "running" + sessionId と短い出力末尾を返します。
• バックグラウンド化された実行と yieldMs 実行は、呼び出しで明示的な timeout が渡されない限り、tools.exec.timeoutSec を継承します。
• 出力はセッションがポーリングまたはクリアされるまでメモリに残ります。
• process ツールが許可されていない場合、exec は同期的に実行され、yieldMs/background を無視します。
• 生成された exec コマンドは、コンテキスト対応のシェル/プロファイルルール用に OPENCLAW_SHELL=exec を受け取ります。
• 今すぐ開始する長時間実行の作業では、一度だけ開始し、コマンドが出力を発するか失敗した時点で（有効な場合）自動完了ウェイクに任せます。
• 自動完了ウェイクが利用できない場合、または出力なしで正常終了するコマンドの静かな成功確認が必要な場合は、process でポーリングします。
• sleep ループや反復ポーリングでリマインダーや遅延フォローアップを模倣しないでください。将来の作業には Cron を使用します。

​

環境変数オーバーライド

​

設定（環境変数オーバーライドより推奨）

​

子プロセスブリッジ

​

process ツール

• バックグラウンド化されたセッションのみが一覧表示/永続化されます。ディスク上ではなく、メモリ内のみです。プロセス再起動時にセッションは失われます。
• セッションログは、process poll/log を実行してツール結果が記録された場合にのみチャット履歴に保存されます。
• process はエージェントごとにスコープされます。そのエージェントが開始したセッションのみを参照します。
• 自動完了ウェイクが利用できない場合は、ステータス、ログ、または完了確認に poll/log を使用します。
• インタラクティブ CLI を回復する前に log を使用し、現在のトランスクリプト、stdin 状態、入力待ちヒントをまとめて確認できるようにします。
• 入力または介入が必要な場合は write/send-keys/submit/paste/kill を使用します。
• process list には、素早く確認するための派生 name（コマンド動詞 + ターゲット）が含まれます。
• process list、poll、log は、セッションにまだ書き込み可能な stdin があり、入力待ちしきい値（既定 15000 ms、OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS）より長くアイドル状態だった場合にのみ waitingForInput を報告します。
• process log は行ベースの offset/limit を使用します。両方が省略された場合、ページングヒント付きで最後の 200 行を返します。offset が設定され、limit が設定されていない場合、offset から末尾までを返します（200 行には制限されません）。
• poll の timeout は、返る前に最大でそのミリ秒数だけ待機します。30000 を超える値は 30000 に制限されます。
• ポーリングはオンデマンドのステータス確認用であり、待機ループのスケジューリング用ではありません。作業を後で実行する必要がある場合は Cron を使用します。

​

例

{ "tool": "exec", "command": "sleep 5 && echo done", "yieldMs": 1000 }

{ "tool": "process", "action": "poll", "sessionId": "<id>" }

{ "tool": "process", "action": "log", "sessionId": "<id>" }

{ "tool": "exec", "command": "npm run build", "background": true }

{ "tool": "process", "action": "write", "sessionId": "<id>", "data": "y\n" }

{ "tool": "process", "action": "send-keys", "sessionId": "<id>", "keys": ["C-c"] }

{ "tool": "process", "action": "submit", "sessionId": "<id>" }

{ "tool": "process", "action": "paste", "sessionId": "<id>", "text": "line1\nline2\n" }

​

関連

• exec ツール
• exec 承認