后台 exec 和进程工具

OpenClaw 通过 exec 工具运行 shell 命令，并在内存中保留长时间运行的任务。process 工具管理这些后台会话。

exec 工具

关键参数：

command（必填）
yieldMs（默认 10000）：超过此延迟后自动转入后台
background（bool）：立即转入后台
timeout（秒，默认 tools.exec.timeoutSec）：在此超时后终止进程；仅在需要为该调用禁用 exec 进程超时时，设置 timeout: 0
elevated（bool）：如果 elevated 模式已启用/允许，则在沙箱外运行（默认是 gateway，当 exec 目标为 node 时则为 node）
需要真实 TTY？设置 pty: true。
workdir、env

行为：

在 exec/process 工具之外派生长时间运行的子进程时（例如 CLI 重新派生或 Gateway 网关辅助进程），请挂接子进程桥接辅助工具，以便转发终止信号，并在退出/错误时分离监听器。这可以避免 systemd 上出现孤立进程，并保持跨平台关闭行为一致。环境覆盖项：

配置（首选）：

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 按智能体划分作用域；它只能看到由该智能体启动的会话。
使用 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" }