セッション分割とツール公開が交差するときの痛み
sessions_spawn が見えない。 ドキュメントにあっても実行時ツール一覧に無いとき、版差・機能フラグ・セッション単位の許可のずれが典型です。導入と doctor で基準線を取り、ループバックと設定実体を突き合わせます。
allowAgents の入れ子。 親子で広げたつもりが子だけが効き spawn が黙殺されることがあります。最終ツール集合を表にし、マージ規則をコードと一致させます。
関数呼び出しモデル。 ツール非対応モデルへ落ちるとハングに見えます。フォールバック表にツール可否列を必ず足します。
doctor 緑でも壊れる経路。 公開 URL ではヘッダ改変でツールだけ死ぬことがあります。リバプロ のバッファとタイムアウトをセットで見ます。Webhook は 本番強化 の SSRF ログと相関します。チャネル混線は 2026.3 マルチチャネル の分離指針を併読してください。
2026.3 の複数チャネルと複数セッション
2026.3 はチャネル横断が強く、単一セッション前提が崩れやすいです。sessions_spawn の見え方は環境依存なので、バージョン・設定パス・起動ユニットをステージと本番で diff 固定し、PR ではモデル名と allowAgents を必須レビューにします。
sessions_spawn が無いときの順序
openclaw status でプロセスと設定読み込み元を確認し、続けて models 系出力でツール呼び出し可否を見ます。CLI とゲートウェイの版食い違いはコンテナのタグと設定マウントの両方を疑います。レース疑いは相関 ID 付きでループバック再現し、最後に ゲートウェイ doctor の JSON をチャネル診断と突き合わせます。
allowAgents ネストを運用で保つ
JSON の深さで意味が変わるため、行にエージェント ID、列に spawn 等の権限、末尾に設定ファイルと行番号を書いた表を環境ごとに一枚残します。コピペ運用は片環境だけ古い制限が残るのでテンプレート化し CI で検証します。
関数呼び出しと三層責務
モデル・ゲートウェイ・チャネルでツールは分断されます。ストリーミング時はチャンク境界で引数 JSON が壊れやすく、プロキシ設定 と同時に疑います。
status・models・doctor・ログの読み方
status で生存とバインド、models でプロファイルとツールヒント、doctor で依存とチャネル欠落（層別手順）、ログ でゲートウェイ・リバプロ・Webhook を相関 ID 結合、外向き拒否は SSRF 強化 と一行照合。この四順を固定するとオンコールが速いです。
判断マトリクス：sessions_spawn・allowAgents・モデル
レビュー用短表です。
| 症状 | 先に見る | 次に見る | 関連記事 |
|---|---|---|---|
| ツール一覧に spawn 無し | status・版一致 | models・allowAgents | インストール／gateway |
| 子だけ失敗 | allowAgents ネスト | 子セッションのモデル | 本番強化 |
| 公開 URL のみ失敗 | リバプロヘッダ | タイムアウト | nginx／Caddy |
| チャネル混線 | ワーカー分離 | ツール競合 | マルチチャネル |
SLO 例：spawn p95 五秒、変更ごと doctor、PR に設定 diff。
七段チェック（コメント例）
秘密はチャットに貼りません。
# 1) 版と doctor 基準線
# openclaw version
# openclaw doctor --json > /tmp/oc-doctor.json
# 2) プロセスと設定実体
# openclaw status
# rg -n "allowAgents" /path/to/config
# 3) モデルとツール能力
# openclaw models # 環境のサブコマンドに合わせる
# 4) ループバックでツール呼び出し試験
# curl -sS http://127.0.0.1:18789/health
# 5) 公開名で同一試験（ヘッダ差分）
# curl -N https://your.host.example/health
# 6) リバプロとゲートウェイで request id
# 7) SSRF／webhook 拒否ログと突合
検証スクリプトは本番鍵を混ぜない別リポジトリに置きます。
可観測性とロールバック
spawn 成功率と子セッション寿命をメトリクス化し、ロールバックはモデル・allowAgents・ゲートウェイ版のいずれか一本だけ戻します。並列 spawn と PDF 同居は熱制限が先に来るため、単一テナントなら SFTPMAC ホスト型リモート Mac が向きます。
FAQ
sessions_spawn は常に入りますか？
版と設定と allowAgents 次第です。無ければ status・models の後 インストール記事 の doctor まで戻ります。
親の allowAgents だけ直せば足りますか？
子とのマージ規則を確認し、表で最終ツール集合を可視化します。
まとめ： sessions_spawn 不在は版とポリシーの組み合わせであり得ます。四層で押さえ、本番境界 と マルチチャネル を同じリリースで管理してください。
限界： プロバイダは自前追跡。SFTPMAC ホスト型リモート Mac は隔離 SFTP と OpenClaw のイングレス用途向きです。
ツール負荷をリモート Mac で載せる場合は SFTPMAC をご覧ください。