OpenClawの認証設定ガイド：Anthropic APIとサブスクリプションの連携

新しいツールを導入する際、認証設定は最初のハードルになりがちです。APIキーの管理や、環境ごとに異なる認証情報の使い分けに手間取ると、本来の作業に集中できなくなってしまいます。OpenClawでは、開発者の環境に合わせて柔軟に認証を構成できるようになっています。

Anthropicのモデルを利用する場合、APIキーを使用する方法と、Claudeのサブスクリプション特典を利用する方法の2種類があります。この記事では、それぞれの設定手順とトラブルシューティングについて説明します。

必要なもの

Anthropicを直接利用している場合は、API key を使用する方法が推奨されます。

export ANTHROPIC_API_KEY="..."
openclaw models status

Gateway を systemd や launchd で実行している場合は、デーモンが読み込めるように ~/.openclaw/.env にキーを記述してください。

cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

openclaw models status
openclaw doctor

環境変数を手動で管理したくない場合は、openclaw onboard を実行することで、オンボーディングウィザードが API key を保存してくれます。

Claude サブスクリプションを利用している場合は、setup-token フローを使用します。この操作も gateway host 上で行ってください。

claude setup-token

openclaw models auth setup-token --provider anthropic

別のマシンで作成したトークンを貼り付ける場合は、以下のコマンドを使用します。

openclaw models auth paste-token --provider anthropic

設定が完了したら、正しく認識されているか確認しましょう。

openclaw models status
openclaw doctor

チャットセッション中に /model <alias-or-id>@<profileId> を使用すると、特定のプロファイルを指定できます（例：anthropic:default, anthropic:work）。

また、エージェントごとに使用する認証情報の優先順位を設定することも可能です。

openclaw models auth order set --provider anthropic anthropic:default

Anthropic のトークンプロファイルが見つからない場合は、gateway host で claude setup-token を再実行し、状態を確認してください。

openclaw models status を実行して、どのプロファイルが期限切れかを確認します。プロファイルが消失している場合は、再度 claude setup-token を実行してトークンを貼り付け直してください。

以下のエラーが表示される場合は、サブスクリプションのトークンではなく、Anthropic API key を使用する必要があります。

This credential is only authorized for use with Claude Code and cannot be used for other API requests.

設定に関する詳細は AI Setup Assistant で確認できます。

OpenClaw Expert

このページで解決しない場合は、OpenClaw Expertに直接質問してください。