OpenClaw 429エラーでフェイルオーバーしない問題：原因と完全修正ガイド2026

{
  "profiles": {
    "primary": {
      "provider": "anthropic",
      "model": "claude-3-5-sonnet-20241022",
      "apiKey": "sk-ant-...",
      "fallbackOnRateLimit": true,
      "rateLimitCooldown": 3600,
      "fallbackProfile": "secondary"
    },
    "secondary": {
      "provider": "openai",
      "model": "gpt-4o",
      "apiKey": "sk-proj-...",
      "fallbackOnRateLimit": true,
      "rateLimitCooldown": 1800,
      "fallbackProfile": "tertiary"
    },
    "tertiary": {
      "provider": "google",
      "model": "gemini-2.0-flash",
      "apiKey": "AIza...",
      "fallbackOnRateLimit": false
    }
  },
  "activeProfile": "primary",
  "autoRecoveryEnabled": true,
  "autoRecoveryCheckInterval": 300
}

# ステップ1：現在のモデルの状態を確認
openclaw models status
# Output例:
# Primary: claude-3-5-sonnet (RATE_LIMITED - 429, cooldown: 3547s remaining)
# Secondary: gpt-4o (available)

# ステップ2：クールダウンをスキップして強制切替
openclaw models failover --force --target secondary

# ステップ3：現在のセッションにホットリロードを送信
openclaw gateway --signal SIGUSR1

# ステップ4：切替確認
openclaw models status
# Output例:
# Active: gpt-4o (secondary profile)
# Primary: claude-3-5-sonnet (RATE_LIMITED - cooling down)

#!/bin/bash
# /usr/local/bin/openclaw-model-recovery.sh

PRIMARY_MODEL="claude-3-5-sonnet-20241022"
CHECK_URL="https://api.anthropic.com/v1/messages"
API_KEY="sk-ant-..."

# プライマリの可用性テスト
RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" \
  -X POST "$CHECK_URL" \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"'$PRIMARY_MODEL'","max_tokens":1,"messages":[{"role":"user","content":"hi"}]}')

if [ "$RESPONSE" = "200" ]; then
  # プライマリが使える場合は切り戻す
  openclaw models use $PRIMARY_MODEL --primary
  echo "$(date): Recovered to primary model $PRIMARY_MODEL"
fi

# crontab設定：5分ごとに実行
# */5 * * * * /usr/local/bin/openclaw-model-recovery.sh >> /var/log/openclaw-recovery.log 2>&1

# auth-profiles.jsonにOpenRouterプロファイルを追加
{
  "profiles": {
    "openrouter-auto": {
      "provider": "openrouter",
      "model": "auto",
      "apiKey": "sk-or-v1-...",
      "openrouter": {
        "fallback_models": [
          "anthropic/claude-3-5-sonnet",
          "openai/gpt-4o",
          "google/gemini-2.0-flash"
        ],
        "route": "fallback"
      }
    }
  }
}

# OpenClawでの設定コマンド
openclaw models add openrouter-auto
openclaw models use openrouter-auto