2026年 OpenClaw MCP stdio と Streamable HTTP の実践チュートリアル

MCP は OpenClaw ゲートウェイとツール層の接点です。stdio は EOF やパイプ詰まり、Streamable HTTP は逆プロキシと締切のズレで 408/504 っぽく見えがちです。三層タイムアウトのドリルと ENOENT の五項目を整理します。 Webhook と TLS／締切の実務ノート、 並列ビルドのディスク FAQ も参照してください。

1. stdio と Streamable HTTP：本番で何が変わるか

stdio は同じノード向き。パイプ切断で子へキャンセルが伝わりやすいが HOME と cwd をラッパーで固定するのが定石。Streamable HTTP は別ホスト向きだが二重タイムアウトとプロキシバッファに弱く、トークンや mTLS を省略すると踏み台化しやすいです。

経験則： 単一ノードは stdio、水平展開のみ HTTP。四問で決め、迷うなら stdio。

2. 再現できるツールタイムアウト・ドリル

遅いスタブで クライアント／ゲートウェイ／上流 の三タイムアウトをログし、真ん中だけ短くして一度失敗を作り、火を吐いた層だけ広げます。HTTP はチャンクとバッファ、stdio は SIGTERM と孤児 node の fd 枯渇を疑います。

3. ENOENT：五項目で大半のチケットを閉じる

ENOENT はパス欠落。(1) 絶対／cwd 相対。(2) シェルと launchd の PATH。(3) bind。(4) 大小文字。(5) arm64 と Rosetta。argv と getcwd() を一度だけログ。

4. オンコール貼り付けチェックリスト

  • トレースごとに三層タイムアウトの実値。
  • HTTP はチャンクとプロキシバッファ。
  • stdio は stderr の永続化と孤児子。
  • ENOENT は argv／cwd／uid の突合せ。
  • 修正後は同じスタブでドリル再実行。

MCP ゲートウェイに Mac mini を置く意味

MCP ゲートウェイはレイテンシとローカル I/O に敏感です。Mac mini（Apple Silicon）は静音と数ワット級のアイドル電力で常駐向き、macOS は launchd と開発ツールが一体で説明しやすく、Gatekeeper／SIP／FileVault も含めセキュリティレビューが取りやすいです。

専有クラウド Mac でリージョンと帯域を揃えるなら Macstripe ホームページを先に照合し、手元検証の起点として Mac mini M4 を検討してください。