OpenClaw OAuth複数エージェントでrefresh_token_reused2026：トークン競合の完全対策ガイド

refresh_token_reusedとは？OAuthの基本を理解する

OAuthでは認証に2種類のトークンを使います：

つまり問題は単純です。エージェントAとエージェントBが同じリフレッシュトークンで同時に新しいアクセストークンを発行しようとします。エージェントAが成功すると、そのリフレッシュトークンは無効化されます。数ミリ秒後にエージェントBが同じトークンを使おうとすると「すでに使用済み」エラーになります。

なぜ複数エージェントで問題が起きるのか

OpenClawはX.comでも話題の「複数エージェント並列稼働」が人気です。@jdrhyne氏は「自分のOpenClaw（Brosef）を3インスタンス並列稼働させている」とX.comで報告しています。しかしこれが問題を引き起こします。

12時間ごとに必ず発生する理由

OpenAIとGitHub Copilotのアクセストークンは、セキュリティ上の理由から約12時間で自動失効します。これはOAuthの標準的なセキュリティ設計です。

複数エージェントが稼働していると、12時間に1回必ずこの競合が発生します。エージェントが3台あれば、最初に成功した1台だけが正常に更新され、残り2台はフォールバックモデルに切り替えられます（設定によってはタスクが失敗します）。

【緊急対処】今すぐrefresh_token_reusedを止める方法

既に問題が発生している場合の即効対処法です。

# 1. 全エージェントを停止
pkill -f "openclaw" 2>/dev/null
# Windowsの場合: Get-Process openclaw | Stop-Process

# 2. OAuth認証をリセット（全プロファイル）
openclaw auth reset --all
# または特定プロファイルのみ
openclaw auth reset --profile openai-codex

# 3. 新しいOAuth認証を実行
openclaw auth login --profile openai-codex
# ブラウザでOAuth認証フローを完了

# 4. 全エージェントを順番に起動（同時起動しない！）
openclaw start agent-1
sleep 30  # 30秒待つ
openclaw start agent-2
sleep 30
openclaw start agent-3

根本解決策1：エージェントごとに別のOAuthプロファイルを作る

最も確実な解決策です。各エージェントが独自のOAuthプロファイル（=独自のリフレッシュトークン）を持つことで、競合がゼロになります。

# プロファイル作成（各エージェント用）
openclaw auth add --profile codex-agent-1
openclaw auth add --profile codex-agent-2
openclaw auth add --profile codex-agent-3

# openclaw.json でエージェントごとにプロファイルを指定
{
  "agents": {
    "agent-1": {
      "auth_profile": "codex-agent-1",
      "model": "openai-codex"
    },
    "agent-2": {
      "auth_profile": "codex-agent-2",
      "model": "openai-codex"
    },
    "agent-3": {
      "auth_profile": "codex-agent-3",
      "model": "openai-codex"
    }
  }
}

根本解決策2：CoPilotプロキシを使ってOAuth依存をなくす

X.com上で@jonahships_が紹介した方法が大変話題になりました：「ClaudeのMax subscriptionを使い切ったので、OpenClawにCoPilotのサブスクをAPIエンドポイントとしてルーティングするプロキシを自分で設定させた」

CoPilotプロキシを使うと、OAuthのリフレッシュトークン問題を完全に回避できます。プロキシはAPI呼び出しをCoPilotサブスクリプション経由でルーティングし、OAuth認証の複雑さを隠蔽します。

# OpenClawにプロキシ設定を依頼するプロンプト例
「私はGitHub CoPilotのサブスクリプションを持っています。
これをAPIエンドポイントとしてOpenClawに使わせてください。
CoPilotプロキシを設定して、複数のエージェントが
OAuthトークン競合なしに使えるようにしてください」

# OpenClawが自動でプロキシ設定スクリプトを生成します
# 設定後はocplaw.jsonでプロキシエンドポイントを指定

{
  "agents": {
    "defaults": {
      "model_endpoint": "http://localhost:8080/copilot-proxy/v1",
      "auth_type": "proxy"
    }
  }
}

根本解決策3：トークン更新のミューテックス（排他制御）設定

openclaw.jsonにミューテックス設定を追加することで、複数エージェントが同時にトークン更新を試みないようにできます。これはOpenClaw v1.8以降でサポートされる機能です。

{
  "oauth": {
    "token_refresh": {
      "mutex": true,
      "mutex_timeout_ms": 30000,
      "retry_on_reused": true,
      "retry_delay_ms": 2000,
      "max_retries": 3
    }
  },
  "agents": {
    "defaults": {
      "failover_on_token_error": false
    }
  }
}

複数エージェント環境のOAuth設定ベストプラクティス

# APIキー方式の設定（OAuth不要）
openclaw auth add --type api-key --key "sk-xxx..." --profile openai-api
# エージェントごとにプロファイルを指定

openclaw start agent-1
sleep 3600  # 1時間待機
openclaw start agent-2
sleep 3600
openclaw start agent-3

エージェント数別の推奨構成

VPN接続と複数エージェントOAuthの関係

複数エージェントのOAuth認証では、すべてのエージェントが同じIPアドレスからアクセスすることがセキュリティ上望ましい場合があります。OAuth認証フロー中にIPが変わると（VPN切替等で）、一部のプロバイダーは不審なアクセスとして認証を失敗させることがあります。

VPN07のような安定した高速VPNは、すべてのエージェントに同一の安定したIPを提供することで、OAuth認証の一貫性を保ちます。特に1000Mbpsの千兆回線は、複数エージェントが同時にAPIアクセスしても帯域が枯渇しないため、競合リスクを最小化できます。

よくある質問

refresh_token_reusedエラーのログ分析と自動診断

エラーが発生した時、ログを読んで根本原因を特定する方法を説明します。OpenClawのログはエラーの詳細情報を含んでおり、適切に読めば問題の原因が特定できます。

# macOSのログファイル場所
~/.openclaw/logs/gateway.log
~/.openclaw/logs/cli.log
~/.openclaw/logs/agent-{name}.log

# refresh_token_reusedエラーを検索
grep "refresh_token_reused\|token.reused\|OAuth" ~/.openclaw/logs/gateway.log | tail -20

# エラー発生のタイムスタンプとエージェント名を確認
grep "refresh_token" ~/.openclaw/logs/gateway.log | awk '{print $1, $2, $NF}' | tail -10

# 診断コマンドで詳細を確認
openclaw doctor --verbose --include-auth