Zeroclaw、Defapi 経由で低コストな Gemini & Claude API を導入
このチュートリアルでは、Defapi プラットフォームを介して Zeroclaw で様々な大規模言語モデル（LLM）を連携させる方法を解説します。Defapi を使用することで、公式インターフェースと完全に互換性のある体験を、非常に高いコストパフォーマンスで得ることができます。
イントロダクション
Zeroclaw は Rust ベースの自律型 AI Agent 実行環境であり、Telegram、Discord、Slack などのチャネルを通じてユーザーと対話することをサポートしています。一方、Defapi は高いコストパフォーマンスでモデル API を提供するプラットフォームであり、価格は公式の約半分です。世界中から安定したアクセスが可能で、各主要モデルベンダーの API プロトコル（v1/chat/completions、v1/messages、v1beta/models/ など）に全面的に互換しています。
具体的な操作手順
Defapi を介したモデルの連携は非常に簡単です。以下の設定ステップに従ってください。
1. API Key の取得
まず、Defapi 公式サイトにアクセスしてアカウントを登録します。必要なモデルのページ（例：Claude または Gemini モデル）で専用の API Key を取得してください。
例：Defapi Claude ページ または Defapi Gemini ページ。
2. 環境変数の設定
システムのターミナルまたは環境において、対応する環境変数を設定し、取得した API Key を入力します。
Claude モデルの場合：
export ANTHROPIC_API_KEY="dk-xxxxxxxxxxxxxxxx"
Gemini モデルの場合：
export GEMINI_API_KEY="dk-xxxxxxxxxxxxxxxx"
3. 設定ファイルの修正
Zeroclaw のメイン設定ファイル（通常は ~/.zeroclaw/config.toml にあります）を編集し、選択したモデルに合わせて設定を調整します。
Claude モデルを使用する場合（Claude Sonnet 4.5 の例）：
default_provider = "anthropic-custom:https://api.defapi.org"
api_key = "dk-xxxxxxxxxxxxxxxx"
default_model = "anthropic/claude-sonnet-4.5"
default_temperature = 0.7
Gemini モデルを使用する場合（Gemini 3 Flash の例）：
default_provider = "custom:https://api.defapi.org"
api_key = "dk-xxxxxxxxxxxxxxxx"
default_model = "gemini-3-flash"
default_temperature = 0.7
ヒント: Defapi のインターフェースは Anthropic 公式の
v1/messagesインターフェース、および Google のv1beta/models/*:generateContentインターフェースと完全に互換性があります。低レイヤーのコードを修正することなく、シームレスに切り替えることが可能です。
Zeroclaw が正常に動作しているかの確認
設定完了後、以下の方法で Zeroclaw が Defapi に正常に接続されているか確認できます。
方法1：直接メッセージを送信してテスト
ターミナルで Zeroclaw を起動し、テストメッセージを送信します：
zeroclaw agent -m "Hello, can you hear me?"
モデルが正常かつ迅速に応答を返せば、設定は成功です。
方法2：診断コマンドの使用
Zeroclaw には実行状態を確認するための診断コマンドが組み込まれています：
# システムステータスの確認
zeroclaw status
# システム診断の実行
zeroclaw doctor
# 利用可能なすべてのプロバイダーとモデルリストを表示
zeroclaw providers
方法3：チャネル設定のテスト
実際のインタラクションをテストするために、ソーシャルチャネル（例：Telegram）を設定できます：
[channels_config.telegram]
bot_token = "123456:your-telegram-token"
allowed_users = ["*"]
5 つの代表的なユースケース
Defapi の低コストという利点を活かし、Zeroclaw は以下のシナリオで広く活用できます。
ユースケース 1：コードレビューアシスタント
コードベースを自動的にレビューし、潜在的なバグ、セキュリティの脆弱性、最適化の提案を指摘します。
[agents.code_reviewer]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-sonnet-4.5"
system_prompt = "You are an expert code reviewer. Review the code for bugs, security issues, and best practices."
agentic = false
max_iterations = 1
ユースケース 2：インテリジェント・カスタマーサポート・ボット
24時間体制で、ユーザーに迅速な Q&A サポートとフレンドリーな応答を提供します。
[agents.support]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-haiku-4.5"
system_prompt = "You are a helpful customer support agent. Be concise and friendly."
max_iterations = 3
ユースケース 3：自動リサーチアシスタント
Web を自律的に検索し、結果を整理して要約します。深い調査や情報収集に適しています。
[agents.researcher]
provider = "custom:https://api.defapi.org"
model = "gemini-3-flash"
system_prompt = "You are a research assistant. Search the web and summarize findings."
agentic = true
max_depth = 2
allowed_tools = ["web_search", "http_request", "file_read"]
max_iterations = 8
ユースケース 4：データアナリスト
ローカルファイルや Shell ツールと連携して、データを分析し、深い洞察を提供します。
[agents.analyst]
provider = "anthropic-custom:https://api.defapi.org"
model = "anthropic/claude-sonnet-4.5"
system_prompt = "You are a data analyst. Analyze the provided data and provide insights."
agentic = true
allowed_tools = ["shell", "file_read"]
ユースケース 5：マルチモーダル・コンテンツ生成
画像やドキュメントなどの多様な入力ソースを組み合わせ、クリエイティブなマーケティングコピーやマルチメディアコンテンツを迅速に生成します。
[agents.content_creator]
provider = "custom:https://api.defapi.org"
model = "gemini-3-flash"
system_prompt = "You are a creative content creator. Generate engaging content based on user requests."
agentic = true
allowed_tools = ["web_search", "file_read"]
max_iterations = 3