OpenClaw 2026年5月21日 約 20 分 v2026.5.18 Subagent

OpenClaw v2026.5.18 サブエージェント
Spawn レジストリ · キュー · handoff

リモート Mac(VNC)段階導入 · 判断表 · 二十分検収

サーバーラックとネットワークで OpenClaw サブエージェントと Gateway 编排を示す

v2026.5.18(2026-05-18 安定 rollup)はサブエージェントを「spawn できた」から「追跡・キュー・回伝できる」へ進めます。spawn はレジストリへの初期書き込みが成功した後にだけ accepted と報告され、主セッションは queued follow-upsmanual-turn 優先 を扱い、子 run の終了は completion handoff で originating session に戻ります。5.18 は session locks と sandbox-peer 所有権も硬化します。リモート Mac で「子は動いたが主チャットに結論がない」「accepted なのに一覧が空」「Codex ネイティブ子が orphaned」——そういう現象には、本稿の八段 Runbook二十分 VNC 検収表を使ってください。境界は Subagent と ACP/Active Memory を分け、Gateway と同じ macOS ユーザーの VNC でコンソールとログを突き合わせます。関連:無応答の切り分けlaunchd 常駐v2026.5.7 プラグイン公開マルチプロジェクト隔離Linux 無 GUI 対 macOS+VNC

01

痛みの分解:5.18 が直すのは「幽霊 spawn」と「handoff 断線」

5.12–5.17 の現場では、サブエージェント障害の多くはモデル品質ではなくオーケストレーション層の不整合です。レジストリ未書き込みで accepted、完了イベントが主セッションに届かない、Codex app-server のネイティブ子と OpenClaw child session の対応がずれる——再現パスは決まっています。

  1. 01

    書き込み失敗でも成功表示(修正済):5.18 は初期 registry save → accepted の順序を強制。失敗時は spawn エラーを返し、一覧に載らない幽霊子を減らします。

  2. 02

    handoff 不到達:originating run session への completion handoff と sandbox-peer の announcement ルートが 5.18 で補強され、隔離沙箱で「終わったが主に届かない」を防ぎます。

  3. 03

    follow-up の競合:queued follow-ups と manual-turn 優先で、IM 上の「割り込み指令」とバックグラウンド子タスクの順序を予測可能にします。

  4. 04

    Codex ネイティブ orphaned:stale な childless ミラーの回復と registry 行の取消は OpenClaw 純 spawn とは別証拠束ねで記録してください。

  5. 05

    リモート Mac 特有:SSH ユーザーと VNC デスクトップユーザーが違うと、spawn 一覧や権限ダイアログが見えず「5.18 リグレ」と誤判定します。

02

判断表:SSH、VNC、サブエージェント検収面

検収SSH のみVNC 推奨合格
openclaw --version / doctor任意CLI ≥ 2026.5.18、doctor ブロックなし
spawn 後 registry 可視性ログ + CLIコンソール/子一覧30 秒以内に行が見える
completion handoff主 transcript 断片同ユーザ Network主チャネルに要約または結果
queued follow-up 割込priority ログIM で二指令実発manual-turn が先
Codex ネイティブtrajectory / doctorOAuth・権限 UIorphaned 警告なし
subagents 設定整理doctor --fix設定 diff 目視無効 timeoutMs 等を除去

最低コスト:SSH で証拠、VNC で同ユーザ再現。どちらか一方に寄せない。

ACP は「現在の IM を coding runtime に bind」、Subagent は「並列子 run + レジストリ + handoff」。Active Memory は主返信前の検索挿入であり、新しい run の spawn ではありません。

03

八段 Runbook:バックアップから handoff 証明まで

  1. 01

    凍結とバックアップ:設定ディレクトリ、openclaw --version、Gateway ビルド、ノード ID。多プロジェクトは 隔離チェック を先に。

  2. 02

    5.18 へ更新:更新後 openclaw doctor。subagents クリーンアップと plugin registry repair を確認。

  3. 03

    最小 spawn 煙テスト:短い終了条件の子を一つ。accepted 前に registry 行があること。

  4. 04

    handoff 検証:主セッションに読める完了要約。無ければ handoff / announcement / session lock をログ検索。

  5. 05

    キュー follow-up:子実行中に割込指令を送り manual-turn 優先を確認。cron と混ぜない。

  6. 06

    Codex 経路:app-server 利用時はネイティブ子と OpenClaw child の対応表を別紙で。

  7. 07

    常駐と再起動:launchd 再起動後も keep モードの registry 行が意図どおりか。

  8. 08

    ロールバック証跡:前後ログと transcript をチケットに。段階ロールバック と接続。

bash
openclaw --version
openclaw doctor
openclaw status
# テストチャネルで短周期 subagent の後:
# rg -i "subagent|handoff|registry|spawn" /path/to/gateway.log | tail -n 80
04

変更票に貼れる四つの結論

  • 結論 1:「spawn accepted」にはレジストリ初期書き込み成功のログ行または UI 行を添付する。
  • 結論 2:handoff 合格はoriginating session の可視返信。子チャネル内ログだけでは不可。
  • 結論 3:queued follow-ups は二指令の実発で検証。設定だけでは足りない。
  • 結論 4:Codex ネイティブと OpenClaw spawn は証拠束ねを分離し、OAuth 問題を registry 回帰と混同しない。

横断修正(Telegram 隔離ポーリング、Discord 最終返信、Gateway 再起動時の pending drain)で「handoff 成功なのに IM に最終文が無い」ことがあります。先に 無応答排查 のチャネル配信章を当て、から registry に戻る。

05

固定順の切り分け:spawn / handoff / 沈黙

  1. A

    CLI・Gateway が 5.18 線か。doctor の subagents 遗留キー。

  2. B

    spawn 後一覧が空なら書き込み失敗かユーザ不一致を先に疑う。

  3. C

    handoff / announcement / session lock のログ。子完了・主無文は final delivery 横断修正を確認。

  4. D

    Telegram forum topic、Discord progress などチャネル層。

  5. E

    CPU/メモリ逼迫時は session lock 待ちが伸びる。並列 spawn を下げてからモデル。

06

二十分 VNC 検収表(SSH ログと突合)

項目VNCSSH合格
コンソール版About / Network 200起動ログCLI 5.18 と一致
spawn 後一覧UI 行registry ログ30 秒以内
handoff主チャネル最終文handoff キーワード要約可読
manual-turn二指令の順序priority ログ割込が先
同ユーザデスクトップ=デーモンwhoami跨ぎ無し

リース Mac では VNCMac の物理分離ノードに Gateway・ブラウザ・「プライバシーとセキュリティ」を同一 VNC セッションで揃えられ、SSH だけでは分からないダイアログ欠落を減らせます。Windows 主力チームは「SSH ログ + VNC 権限」の二軌を Linux 対 macOS+VNC 手順に固定化してください。

関連

関連記事

FAQ

よくある質問

レジストリ初期書き込みと originating session を先に。5.18 では書き込み失敗は spawn エラーに寄ります。

違います。ACP は IM を coding runtime に載せる。Subagent は並列子 run + レジストリ + handoff です。

CLI とログは SSH で可。spawn 一覧と権限 UI はデーモンと同ユーザの VNC で。

doctor で subagents の無効 timeoutMs 等を整理。モデルは primary/fallback に集約。必ずバックアップ。

結び

v2026.5.18 は並列自動化を監査可能なオーケストレーションに寄せます。レジストリ・キュー・handoff のどこかが切れると IM では「AI が無反応」に見えます——それが 無応答排查 と本稿の分担です。

自前 Mac はスリープと帯域と session lock 待ちを抱えます。リース Mac では Gateway とコンソールを同一 VNC デスクトップに置き、検収を二十分規模に圧縮できます。

第六節と同型のグラフィカル検収用に VNCMac購入ページ、接続は ヘルプセンター(SSH-VNC)。