リモート Mac(VNC)段階導入 · 判断表 · 二十分検収
v2026.5.18(2026-05-18 安定 rollup)はサブエージェントを「spawn できた」から「追跡・キュー・回伝できる」へ進めます。spawn はレジストリへの初期書き込みが成功した後にだけ accepted と報告され、主セッションは queued follow-ups と manual-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。
5.12–5.17 の現場では、サブエージェント障害の多くはモデル品質ではなくオーケストレーション層の不整合です。レジストリ未書き込みで accepted、完了イベントが主セッションに届かない、Codex app-server のネイティブ子と OpenClaw child session の対応がずれる——再現パスは決まっています。
書き込み失敗でも成功表示(修正済):5.18 は初期 registry save → accepted の順序を強制。失敗時は spawn エラーを返し、一覧に載らない幽霊子を減らします。
handoff 不到達:originating run session への completion handoff と sandbox-peer の announcement ルートが 5.18 で補強され、隔離沙箱で「終わったが主に届かない」を防ぎます。
follow-up の競合:queued follow-ups と manual-turn 優先で、IM 上の「割り込み指令」とバックグラウンド子タスクの順序を予測可能にします。
Codex ネイティブ orphaned:stale な childless ミラーの回復と registry 行の取消は OpenClaw 純 spawn とは別証拠束ねで記録してください。
リモート Mac 特有:SSH ユーザーと VNC デスクトップユーザーが違うと、spawn 一覧や権限ダイアログが見えず「5.18 リグレ」と誤判定します。
| 検収 | 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 / doctor | OAuth・権限 UI | orphaned 警告なし |
| subagents 設定整理 | doctor --fix | 設定 diff 目視 | 無効 timeoutMs 等を除去 |
最低コスト:SSH で証拠、VNC で同ユーザ再現。どちらか一方に寄せない。
ACP は「現在の IM を coding runtime に bind」、Subagent は「並列子 run + レジストリ + handoff」。Active Memory は主返信前の検索挿入であり、新しい run の spawn ではありません。
凍結とバックアップ:設定ディレクトリ、openclaw --version、Gateway ビルド、ノード ID。多プロジェクトは 隔離チェック を先に。
5.18 へ更新:更新後 openclaw doctor。subagents クリーンアップと plugin registry repair を確認。
最小 spawn 煙テスト:短い終了条件の子を一つ。accepted 前に registry 行があること。
handoff 検証:主セッションに読める完了要約。無ければ handoff / announcement / session lock をログ検索。
キュー follow-up:子実行中に割込指令を送り manual-turn 優先を確認。cron と混ぜない。
Codex 経路:app-server 利用時はネイティブ子と OpenClaw child の対応表を別紙で。
常駐と再起動:launchd 再起動後も keep モードの registry 行が意図どおりか。
ロールバック証跡:前後ログと transcript をチケットに。段階ロールバック と接続。
openclaw --version openclaw doctor openclaw status # テストチャネルで短周期 subagent の後: # rg -i "subagent|handoff|registry|spawn" /path/to/gateway.log | tail -n 80
横断修正(Telegram 隔離ポーリング、Discord 最終返信、Gateway 再起動時の pending drain)で「handoff 成功なのに IM に最終文が無い」ことがあります。先に 無応答排查 のチャネル配信章を当て、から registry に戻る。
CLI・Gateway が 5.18 線か。doctor の subagents 遗留キー。
spawn 後一覧が空なら書き込み失敗かユーザ不一致を先に疑う。
handoff / announcement / session lock のログ。子完了・主無文は final delivery 横断修正を確認。
Telegram forum topic、Discord progress などチャネル層。
CPU/メモリ逼迫時は session lock 待ちが伸びる。並列 spawn を下げてからモデル。
| 項目 | VNC | SSH | 合格 |
|---|---|---|---|
| コンソール版 | 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 手順に固定化してください。
レジストリ初期書き込みと 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 デスクトップに置き、検収を二十分規模に圧縮できます。