二〇二六年の OpenClaw では、リモート Mac ゲートウェイでModel Authカード、ツール呼び出しログの強化、CI 要約回帰が一連で扱いやすくなっています。本稿は前提・順踏み・Webhook の要点だけを Runbook 化しました。埋め込み手順、マルチエンドポイントと CI 要約、秘密管理と硬化も併読ください。ログイン不要です。

前提条件

Node.js 22 LTS以上、openclaw onboard --install-daemon（推奨時）、資格ローテ後の openclaw doctor、API キーは Git 外と chmod 600。HTTPS の SAN はモデル表のホストと一致。構造化ログ保存用にディスクを確保し、CI 側はビルド要約の受け口（チェック／Webhook）と外向き先 URL を許可リスト化します。

順を追った排障ステップ

上から順に。前段がクリーンなら次へ。

1
Model Auth と実行ルート

ルーティング表の /v1/chat/completions 等とラベルを一致。Git の別名だけ更新しているとカードは緑のまま四〇四になります。

2
ログキーワード（grep 用）

マスクのうえで上限付き grep。例：

  • model_auth_probe、invalid_api_key、insufficient_quota
  • tool_invocation、tool_result、permission_denied
  • rate_limit、retry_after、upstream_timeout

request_id でダッシュボードと CI 時刻を突き合わせます。

3
ヘルスプローブの統合

/health または openclaw gateway status --json に、軽量モデルへの最小認証呼び出しを同一シェルで足し、片方失敗で非ゼロ。LaunchAgent 手順と揃えます。

4
ツールログの要約行

構造化要約＋マスク。フラップ時は tool_name・所要・終了クラスが一行に出るかを確認し、全文に依存しないようにします。

5
同一 UID で再実行

失敗コマンドをゲートウェイと同じユーザーと plist 環境で SSH 再実行。HOME／キーチェーン差がツール拒否に見えることがあります。

リモート Mac CI との連携例

統合ヘルス失敗や重大度一致でラッパーを非ゼロにし、許可リストへ JSON を POST。二・四・八秒バックオフは Harbor／Jenkins 記事と同じ運用にすると揃います。失敗要約 Webhook のプレースホルダー例：

{
  "source": "openclaw-gateway",
  "pipeline_id": "<CI_PIPELINE_ID>",
  "commit": "<GIT_SHA_SHORT>",
  "gateway_host": "<GATEWAY_PUBLIC_HOSTNAME>",
  "model_auth_snapshot": "<OK|DEGRADED|FAIL>",
  "last_tool_error_excerpt": "<LAST_20_LOG_LINES_REDACTED>",
  "request_id": "<CORRELATION_REQUEST_ID>",
  "ts_unix": "<UNIX_TIMESTAMP>"
}

curl --max-time は短めに。環境系は 失敗回復と再試行へ誘導します。

よくあるエラー FAQ

Model Auth が黄に落ちる

時刻ずれ・部分リロード・カナリア鍵の取りこぼし。デーモンをまとめて再起動し、設定パスと NTP を確認します。

手動は通るが自動化だけ失敗

SSH エージェント・キーチェーン・FDA の差を比較。秘密は専用ユーザーのファイルへ。

CI 要約が短い

本番は意図通り。request_id でログ基盤へ遡ります。

まとめ

Model Auth → キーワード grep → ヘルス統合 → マスク済み要約の順で観測ループを閉じます。

ホーム、料金、購入、ヘルプ、技術ブログはログイン不要です。