/health・CI 要約まで再現する手順です。健康診断・ログ書き戻し型・段階キャッシュと併読ください。
前提条件（Node 24／ゲートウェイ）
Node.js 24 LTS をログインシェルと LaunchAgent で同一パスに揃え、openclaw doctor を同ユーザーで実行します。ゲートウェイはルーティングに専念し、キーは環境変数等のみとします。
- 単一 API 障害を複数先＋フォールバックで緩和する。
- 要約に
git rev-parse --shortと設定版を載せ、プルと GW 変更を切り分ける。
| 構成 | 向くケース | 注意 |
|---|---|---|
単一 baseUrl | 検証 | 単一点障害 |
| 複数＋ルール | 本番寄り | 順序・timeout 文書化 |
インストールと要点
公式導線で CLI を入れ doctor を通します。HTTPS_PROXY／NO_PROXY／NODE_EXTRA_CA_CERTS はシェルと plist を一致させ、onboard でリッスンとトークンを保存。外向きはリバプロ前提で README に書きます。
複数 OpenAI 互換エンドポイントとルーティング設定の手順表
各先に baseUrl・認証・timeout を宣言し、モデル接頭辞／正規表現を上から評価するルール列を置きます。
| # | 作業 | 完了条件 |
|---|---|---|
| 1 | A／B を登録（例 primary・fallback） | curl -I で TLS OK |
| 2 | gpt-*→A、実験系→B、最後に * | ログで chosenBackend 一致 |
| 3 | timeout・再試行・429／5xx フォールバック | 遅延が列を塞がない |
| 4 | CI でスモーク、要約に設定ハッシュ | 緑＋追跡可能 |
/health によるヘルスチェック
集約 JSON に各先の到達性を載せ、curl -sfS …/health の失敗で launchctl kickstart します。TCP のみだと誤陽性が出るため軽い認証プローブを足します。詳細は健康診断記事へ。
curl -sfS "http://127.0.0.1:18789/health" | jq .
CI Webhook／ログ要約との連動例
末尾で内部 URL に sha・変更ファイル・ルート検証結果を POST、または GITHUB_STEP_SUMMARY へ Markdown 追記し、PR 画面で開発と運用が同じ要約を見ます。
echo "- sha: $(git rev-parse --short HEAD)" >> "$GITHUB_STEP_SUMMARY"
curl -sfS -X POST "$INTERNAL_WEBHOOK_URL" -d "{\"sha\":\"$(git rev-parse HEAD)\"}"
よくあるエラー FAQ
404：baseUrl のスラッシュとパス二重を curl で直叩き比較。401：launchd にキー未設定が多い→plist と kickstart。既定にしか流れない：具体ルールを上へ、model ログを確認。health は良いが本番失敗：TCP 以外のプローブを追加。
まとめ
Node 24・ルーティング表・/health・CI 要約を一連にすると、ゲートウェイ安定と依存プル・モデル切替の協調がしやすくなります。ブログ一覧もどうぞ。
ゲートウェイを安定稼働させ、CI と開発プルを同じ要約でつなぐ
ホーム・購入・ヘルプはログイン不要で閲覧できる範囲からご利用いただけます。帯域と常時稼働に余裕のある Apple Silicon ノードで、多端点ルーティングとヘルス監視をまとめて運びたいチーム向けです。