2026 OpenClaw stdio 緩衝、MCP JSON-RPC 停頓與租用 ProxyMac Mac mini 上的管道背壓
位於香港、日本、韓國、新加坡或美國的 ProxyMac Mac mini 上，OpenClaw 常以 stdio 承載 MCP 伺服器：閘道器注生子程序，在 stdin/stdout 上講 JSON-RPC，並期望每條訊息及時到達。故障特徵令人惱火地安靜：第一次工具呼叫成功，隨後子程序不再輸出，而 top 裡 CPU 卻在空轉。十有八九不是「模型壞了」，而是 stdio 緩衝加管道背壓：子程序看不到 TTY 就切到全塊緩衝，部分響應堆在 libc 裡直到緩衝區滿；父程序可能在 read() 上等待一個永遠不會到的分隔符，或子程序在 write() 上阻塞，因為父程序還沒排空管道。本文說明架構，用症狀矩陣對比行緩衝與塊緩衝，在 launchd 下比較 PTY 包裝與裸管道，列出 Python（PYTHONUNBUFFERED=1、python -u）、POSIX 過濾器（stdbuf -oL）與 Node 流（保持 stdout 流動模式）的緩解，再給可對接 MCP 部署、閘道器重啟、部署排障 與 ulimits 的五步分診——當問題其實是描述符耗盡卻偽裝成「卡住」時。
macOS 上的 stdio MCP 架構（必須恆為真的事）
設想三個協作程序：(A) OpenClaw 閘道器，(B) MCP 伺服器二進位制或指令碼，(C) 可選輔助過濾器（jq、語言執行時）。任一方在寫時阻塞而另一方在同一迴圈依賴上讀等待，就會形成死鎖。stdio 傳輸還繼承 stderr 紀律：囉嗦庫把進度條噴到 stderr 時，若無人消費，核心管道緩衝區會被填滿。
- 「每次 flush 對應一條 JSON」不現實——libc 不知道 JSON 邊界。
- 大響應需要流式讀取器；若閘道器在記憶體裡緩衝整個負載，會感到與 MCP 語義無關的「停頓」。
- launchd 不會 source 你的互動式 shell rc——環境對齊要手工維護；環境變更後有序重啟見 升級/回滾 模式。
行緩衝 vs 塊緩衝（為何終端裡「正常」）
許多 CLI 在 isatty(stdout) 為真時用行緩衝，stdout 為管道時用塊緩衝（常見 4–8 KiB 的倍數）。在無頭 LaunchAgent 下，MCP 伺服器突然變成管道寫端——終端裡「實時」的日誌會攢到緩衝區滿才批次刷出。延遲表現為「模型卡住了」，儘管 LLM 數秒前就已結束。
stdbuf -oL -eL 包裹可疑命令——在寫入生產 plist 前先測延遲。
MCP 卡住症狀矩陣
| 訊號 | 比 MCP 缺陷更可能 | 證實 / 證偽 | 延伸閱讀 |
|---|---|---|---|
| 第一次 RPC 正常，第二次永遠卡住 | stdout 塊緩衝 | 同一二進位制在 script -q /dev/null 下做 PTY 煙測 | 本文 |
| CPU 打滿、記憶體平穩 | 緊迴圈讀空 fd | sample pid 5 -file /tmp/st.txt 取樣 | 部署排障 |
Too many open files | Ulimit、MCP 扇出 | launchctl limit maxfiles 對比程序軟限制 | Ulimits |
| 日誌輪轉後間歇出現 | SIGHUP / 重開 fd | 與 newsyslog 時間戳對齊 | 日誌 |
LaunchAgent 下的 PTY 包裝與裸管道
有些團隊用 script、unbuffer 或自定義 PTY 父程序包裝 MCP 伺服器，讓子程序以為自己在互動。取捨：PTY 增加CPU 與複製開銷，但能消除一整類緩衝意外。裸管道更便宜，但要求子程序有紀律地 flush 或加 stdbuf 墊片。要有意識選擇——混用風格會讓值班工程師困惑。
工具鏈緩解（複製到 LaunchAgent 的 EnvironmentVariables）
Python： 匯出 PYTHONUNBUFFERED=1 或使用 python3 -u；打包 CLI 優先在入口呼叫受支援版本上的 sys.stdout.reconfigure(line_buffering=True)。Node： 確保以流動模式消費 stdout——在子程序管道間暫停流是常見雷區。Go / Rust： 若你控制原始碼，在每個 JSON-RPC 幀後顯式 flush。Shell 過濾器： 管道自動化 tail 時記得 grep --line-buffered。
<key>EnvironmentVariables</key>
<dict>
<key>PYTHONUNBUFFERED</key>
<string>1</string>
<key>NODE_OPTIONS</key>
<string>--max-old-space-size=4096</string>
</dict>
重寫智慧體之前的五步 stdio 分診
- 復現：在
ssh下把 plist 的ProgramArguments原樣貼進互動 shell——若突然好了，說明存在環境/TTY 差異。 - 類 strace：在 macOS 上短時執行
sudo fs_usage -w -f filesys | grep mcp觀察寫阻塞（生產慎用）。 - 拆分 stderr 到輪轉檔案，避免除錯垃圾與 stdout 上的 JSON-RPC 爭用。
- 浸泡測試：啟用緩解後用合成大負載壓測。
- 決定傳輸：若 stdio 仍脆弱，按部署指南規劃 HTTP MCP。
常見問題
調大管道 buffer 的 sysctl 有用嗎？ 當作最後手段——根因通常是讀寫節奏不配，而非單純緩衝區大小。
MCP 伺服器該往 stdout 打日誌嗎？ stdout 只留給 JSON-RPC；人類日誌走 stderr 或結構化檔案。
Apple Silicon 會改變緩衝嗎？ 不會——M4 只是讓你更快撞上 libc 預設行為。
為何 ProxyMac Mac mini 是加固 stdio MCP 的合適場所
Apple Silicon M4 mini 位於 港 / 日 / 韓 / 新 / 美，提供常開金屬，讓你每晚重放同一套 stdio 曲線，把 區域容量 綁在你呼叫的 SaaS API 旁，並把 幫助 連結放在 LaunchAgent 倉庫邊。人類必須審批 TCC 提示時回退 VNC；網路引入猶豫時讀同釋出線的 IPv6 Happy Eyeballs SSH。
