Mac mini M4 への新鮮な OpenClaw インストールは launchd がエラーを出さないため「緑に見える」——トークンが回ると webhook がフラップする。この 2026 マトリクスはインストール後検証を二表にする：明示的合格ラインを持つ決定的 スモーク と、オペレータに openclaw doctor を信じるか、インストール文書に戻るか、レディネス SLO 作業へ昇格するかを示す 症状ルーティング。
儀式の錨を 包括的 macOS インストールとデプロイ に置き、診断を doctor 主導のヘルス修正 に揃え、ヘルス対レディネス SLO ガイダンス でプローブを分割し、ヘッドレスオンボードとデーモン受け入れ で仕上げる。
「クラッシュログなし」がスモークではない理由
Apple Silicon 上のゲートウェイはバックグラウンドインデクサと CI 残骸と統合メモリを共有する。誤ユーザー、古いトークンファイル、意図しないインターフェースにバインドされた管理ソケットといった静かな部分失敗は、最初の署名 webhook まで表面化しない。スモークはしたがって アイデンティティ、バージョン、ネットワーク姿勢 を一緒に主張し、プロセスの生存だけではない。
- バージョン漂移： launchd リロード前に
openclaw --versionがチケット済みセマバーと一致しなければならない。 - doctor の偽グリーン： チェックが通り
openclaw gateway statusが想定外リスナーを示すなら二進位ではなく方針が間違っている。 - ヘッドレスギャップ： GUI ブレークグラス計画なしの受け入れは最初の TCC 退行で失敗する——VNC を恥ではなく文書化する。
オペレータ規則： バージョン、doctor 要約、ゲートウェイ状態の三行を変更記録に貼れないなら、そのホストは本番に昇格しない。
マトリクス A — スモークチェック対合格基準対証拠成果物
| チェック | 合格基準 | 証拠成果物 |
|---|---|---|
| CLI セマバーピン | openclaw --version がピン留めリリースと一致 |
チケット添付または CI ログ抜粋 |
| doctor ベースライン | openclaw doctor がゼロ終了；ゴールデンホスト比で新警告なし |
マスク済み stdout をオブジェクトストアへ |
| ゲートウェイ姿勢 | openclaw gateway status が期待リスナーのみ表示 |
スクリーンショットまたは構造化 JSON キャプチャ |
| ディスク余裕 | ワークボリューム空き ≥ 最大バースト成果物の 2 倍 | チケット内 df 抜粋 |
マトリクス B — 症状対解釈対次の一手
| 症状 | ありそうな解釈 | 次の一手 |
|---|---|---|
| doctor クリーン、webhook 401 | トークンファイルは読めるが launchd が使うものではない | ユーザーコンテキストを diff；ヘッドレス受け入れチェックリストを再実行。 |
| ステータスに余分なリスナー | 設定ドリフトまたは手動オーバーライド | plist 環境をリポと比較；トラフィック前にバインドフラグをロールバック。 |
| モデル呼び出し後にレディネスがフラップ | GPU ウォームアップに対してレディネスプローブが厳しすぎる | レディネス SLO 記事に従いライブネスとモデルレディネスを分割。 |
変更窓の数値ガードレール
- 証拠 SLA： launchd リロードから 30 分以内にスモーク出力を添付しないと自動ロールバック。
- doctor デルタ： ゴールデン比で新警告は最大 2；超えたらマージブロッカー。
- Webhook リハーサル： 本番イングレスを切り替える前にステージングで署名付き再生を少なくとも 5 回。
8 つの HowTo 手順（JSON-LD と対応）
- CLI をピン留め——
openclaw --versionを変更チケットに記録。 - doctor を実行し stdout を保存し、plist または環境編集の前後比較に使う。
- ゲートウェイ状態を検査し、リスナーがループバック優先方針に従うか確認。
- ワークスペースルートでディスクを測定；重いツールチェーンの前にボリューム拡張。
- LaunchAgent アイデンティティを検証し、キーチェーンパーティションがシークレット範囲と一致するようにする。
- レディネス分割を適用：先に高速ライブネス、次にモデル依存チェック。
- Webhook ドライラン——現実的なボディサイズと時計スキュー境界を含める。
- plist とトークンのロールバックをリハーサル——監査ログは削除しない。
よくある質問
CI は同じスモークスイートを走らせるべきか？
はい、ただし非対話チェックのみ；GUI 依存ステップはラベル付きステージングプールと文書化された VNC ブレークグラスに属する。
長寿命ホストでスモークの再実行頻度は？
少なくとも launchd 向け cron で日次に加え、すべてのシークレットローテーションのたび；成果物欠落はスキップではなく失敗実行として扱う。
誠実な OpenClaw 運用は ネイティブ macOS で SSH ファースト自動化と同意エッジ用の VNC を要する。規律あるインストール後マトリクスは openclaw --version、openclaw doctor、openclaw gateway status を監査人が再生できる証拠に結びつけ、「緑ダッシュ、赤顧客」を防ぐ。香港、日本、韓国、シンガポール、米国 で 専用 Mac mini M4 を レンタル すれば隔離ホストを得られ、ステージングのスモークと本番のスモークが誤ってキーチェーン名前空間を共有しない。マトリクスが繰り返しドリフトを示すなら、一台のゲートウェイに矛盾する役割を載せる前に 料金 でホストを追加する。