Arang.dev
検索

OpenClawでClaude Opus 4.6モデルを適用する – Unknown Modelエラーの解決

OpenClawでClaude Opus 4.6 Thinkingモデルを使用する際に発生する'Unknown model'エラーの原因と解決プロセスをまとめた。

#OpenClaw#Claude#Opus 4.6#Troubleshooting#AI
🌐 翻訳済み

この記事はAIによって韓国語から機械翻訳されています。原文と表現が異なる場合があります。

原文（韓国語）を読む

状況

Google AntigravityでClaude Opus 4.5が廃止され、Opus 4.6に移行された。Antigravityアプリでは正常にOpus 4.6を使用できるが、OpenClawでモデルをgoogle-antigravity/claude-opus-4-6-thinkingに変更するとエラーが発生した。

⚠️ Agent failed before reply: Unknown model: google-antigravity/claude-opus-4-6-thinking

原因分析

1. npmインストール → gitインストールへの切り替えが必要

従来npmでインストールしたOpenClawは/opt/homebrew/lib/node_modules/openclawに位置するが、この形態はソース修正や依存関係のアップデートが難しい。モデルレジストリの修正のためにgitベースのインストールに切り替える必要があった。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- \
  --install-method git \
  --git-dir ~/src/openclaw \
  --no-onboard

2. Control UI Originエラー

gitインストール後、ゲートウェイを起動するとControl UIでWebSocket接続が切断された。

disconnected (1008): origin not allowed

これはControl UIのOriginがゲートウェイの許可リストにないために発生した問題だ。openclaw.jsonにcontrolUi.allowedOriginsを追加するか、ゲートウェイが提供するUI(http://127.0.0.1:18789/)にアクセスすれば解決される。

3. gateway.modeの問題

ゲートウェイサービスが起動するが、ポートが開かない症状があった。

Gateway start blocked: set gateway.mode=local (current: remote) or pass --allow-unconfigured.

gateway.modeがremoteに設定されていると、ローカルでサービスの起動が拒否される。

openclaw config set gateway.mode local

4. 核心的な原因: pi-ai モデルレジストリの未反映

openclaw models listで確認するとOpus 4.6がリストに全くなかった。

$ openclaw models list --provider google-antigravity --all --plain
google-antigravity/claude-opus-4-5-thinking
google-antigravity/claude-sonnet-4-5
google-antigravity/claude-sonnet-4-5-thinking
google-antigravity/gemini-3-flash
google-antigravity/gemini-3-pro-high
# ... Opus 4.6이 없다

OpenClawはモデル検証を内部パッケージ@mariozechner/pi-aiのモデルカタログに依存する。PR #10720で基本モデルをOpus 4.6に変更したが、実際のモデル定義はpi-aiパッケージのアップデートが必要だった。

解決過程

Step 1: 問題の確認

GitHub Issue #10716で同様の問題が報告されており、コメントで修正方法を確認した。

Step 2: ソースコードの修正

問題のコメントを参考に3つのファイルを修正した。核心はモデルレジストリにOpus 4.6モデルの定義を追加することだ。

  1. モデルカタログにOpus 4.6を追加 — pi-aiパッケージ内のモデル定義ファイルにclaude-opus-4-6-thinkingエントリを追加
  2. モデルマッピング/ルーティング設定 — Antigravity providerが該当モデルIDを認識するようにマッピングを追加
  3. 基本モデルの変更 — 基本値をclaude-opus-4-6-thinkingにアップデート

Step 3: ビルドと適用

cd ~/src/openclaw
pnpm install
pnpm build
openclaw gateway restart

Step 4: サービス復旧

LaunchAgentが破損している場合が多かった。完全初期化後、再インストール:

# 기존 서비스 정리
openclaw gateway stop || true
launchctl bootout gui/$UID/ai.openclaw.gateway 2>/dev/null || true
 
# lock 파일 정리 (OAuth 락 꼬임 방지)
find ~/.openclaw /tmp/openclaw -type f -name "*.lock" -delete 2>/dev/null
 
# 재설치
openclaw doctor --repair
openclaw gateway install --force
openclaw gateway start

Step 5: 確認

$ openclaw models list --provider google-antigravity --all --plain | grep 4-6
google-antigravity/claude-opus-4-6-thinking
google-antigravity/claude-sonnet-4-6-thinking
 
$ openclaw gateway status
# RPC probe: ok ✅

発生した付随的な問題

OAuth Token Refresh Lock

複数のゲートウェイプロセスが同時にOAuthトークンを更新しようとしてロックが発生する問題があった。

OAuth token refresh failed: Lock file is already being held

すべてのゲートウェイプロセスを終了し、lockファイルを削除した後、1つだけ再起動すれば解決される。

gateway.bind 値の混同

gateway.bindにlocalを入れるとvalidationエラーが発生する。有効な値はloopback、lanなどだ。ローカル専用ならloopbackを使用する。

openclaw config set gateway.bind loopback  # ✅
openclaw config set gateway.bind local     # ❌ Invalid input

Alpine Linuxのlocalhost → IPv6 問題

これは別の問題だが、Dockerコンテナ(Alpineベース)でlocalhostがIPv6(::1)として解釈され、healthcheckが失敗する場合がある。127.0.0.1と明示すれば解決される。

教訓

  1. npmインストール ↔ gitインストールへの切り替えは思ったより簡単だ。 ~/.openclaw/ディレクトリが状態をすべて保管するため、インストールパスだけが変わり、設定/セッション/認証はそのまま維持される。
  2. モデルサポートは複数のレイヤーにまたがる。 Providerがモデルをサポートしていても、クライアント(OpenClaw)のモデルレジストリに登録されて初めて使用できる。
  3. LaunchAgentは頻繁に破損する。 macOSでサービス管理時にlaunchctl bootout → install --forceパターンを覚えておくと良い。
  4. ログをまず見よう。 ~/.openclaw/logs/gateway.err.logがほとんどの答えを持っている。

コメント

コメントを読み込み中...
OpenClawでClaude Opus 4.6モデルを適用する – Unknown Modelエラーの解決 | Arang