背景執行與行程工具

OpenClaw 透過 exec 工具執行 shell 指令，並將長時間執行的任務保留在記憶體中。process 工具會管理這些背景工作階段。

exec 工具

主要參數：

command（必填）
yieldMs（預設 10000）：經過此延遲後自動轉入背景
background（布林值）：立即轉入背景
timeout（秒，預設為 tools.exec.timeoutSec）：在此逾時後終止程序；只有在要停用該次呼叫的 exec 程序逾時時，才設定 timeout: 0
elevated（布林值）：如果 elevated 模式已啟用/允許，則在 sandbox 外執行（預設為 gateway；當 exec 目標是 node 時則為 node）
需要真正的 TTY？設定 pty: true。
workdir、env

行為：

在 exec/process 工具之外衍生長時間執行的子程序時（例如 CLI 重新衍生或 Gateway 輔助程式），請附加子程序橋接輔助程式，讓終止訊號能被轉送，並在結束/錯誤時卸離監聽器。這可避免 systemd 上出現孤立程序，並讓各平台的關閉行為保持一致。環境覆寫：

PI_BASH_YIELD_MS：預設讓出時間（毫秒）
PI_BASH_MAX_OUTPUT_CHARS：記憶體內輸出上限（字元）
OPENCLAW_BASH_PENDING_MAX_OUTPUT_CHARS：每個串流的待處理 stdout/stderr 上限（字元）
PI_BASH_JOB_TTL_MS：已完成工作階段的 TTL（毫秒，限制在 1 分鐘至 3 小時）
OPENCLAW_PROCESS_INPUT_WAIT_IDLE_MS：可寫入背景工作階段被標記為可能正在等待輸入前的閒置輸出閾值（預設 15000 毫秒）

設定（建議）：

tools.exec.backgroundMs（預設 10000）
tools.exec.timeoutSec（預設 1800）
tools.exec.cleanupMs（預設 1800000）
tools.exec.notifyOnExit（預設 true）：背景化的 exec 結束時，將系統事件加入佇列並請求 Heartbeat。
tools.exec.notifyOnExitEmptySuccess（預設 false）：為 true 時，也會為沒有產生輸出的成功背景執行加入完成事件。

動作：

注意事項：

只有背景化的工作階段會列出/保存在記憶體中。
程序重新啟動時會遺失工作階段（沒有磁碟持久化）。
只有在你執行 process poll/log 且工具結果被記錄時，工作階段日誌才會儲存到聊天歷史。
process 的範圍限於每個 agent；它只會看到該 agent 啟動的工作階段。
使用 poll / log 取得狀態、日誌、安靜成功確認，或在無法使用自動完成喚醒時確認完成。
在復原互動式 CLI 前使用 log，讓目前逐字稿、 stdin 狀態與輸入等待提示能一起顯示。
需要輸入或介入時，使用 write / send-keys / submit / paste / kill。
process list 會包含衍生的 name（指令動詞 + 目標），方便快速掃描。
process list、poll 和 log 只有在工作階段仍有可寫入的 stdin，且閒置時間超過輸入等待閾值時，才會報告 waitingForInput。
process log 使用以行為單位的 offset/limit。
同時省略 offset 和 limit 時，它會回傳最後 200 行，並包含分頁提示。
提供 offset 且省略 limit 時，它會從 offset 回傳到結尾（不限制為 200 行）。
輪詢是用於隨選狀態，不是等待迴圈排程。如果工作應該稍後發生，請改用 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 }

傳送 stdin：

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

傳送 PTY 按鍵：

{ "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" }