Clawdbot (Moltbot/OpenClaw) に Gemini API を統合するチュートリアル

•AI Expert

Clawdbot (Moltbot/OpenClaw) に Gemini 3 Flash を統合する完全チュートリアル（defapi.org プロキシ経由）

Clawdbot は本来 Anthropic Claude の tool use サポートが最も充実していますが、Gemini シリーズ（特に高速で超長文コンテキストに対応した Gemini 3 Flash）は、検索、クイックレスポンス、マルチモーダルタスクにおいて極めて高いパフォーマンスを発揮します。Google 公式の Gemini API を直接 Clawdbot に接続するには、通常複雑なフォーマット変換層（litellm やカスタムリレーなど）が必要ですが、defapi.org を利用すれば、ほぼゼロ修正で動作させることが可能です。defapi は Gemini を Anthropic/OpenAI スタイルのインターフェースにラップし、特に tool calling の透過性に優れています。

最大のメリット：defapi.org 経由で Gemini 3 Flash を利用すると、実質的なコストが Google 公式 API よりも約 50% 安くなります（2026 年のコミュニティ実測および上流価格の比較に基づく：公式の Gemini 3 Flash 入力 ≈ $0.50–$1.00 / 1M tokens、出力 $3.00+。一方で defapi プロキシ層は通常 4〜6 割引の価格設定となっており、Clawdbot のような頻繁に tool call を行うエージェントシナリオでのヘビーユースには最適です）。

以下に、2026 年最新の最も安定した導入手順を説明します。

1. 事前準備

  • Clawdbot インストール済みであること（今回のテスト使用バージョン: 2026.1.24-3 (885167d)）。新規サーバーの場合は、以下のコマンドで素早くインストールできます： 
    # fnm と Node.js 24 のインストール
curl -o- https://fnm.vercel.app/install | bash
source ~/.bashrc
fnm install 24

# clawdbot のインストール
npm install -g clawdbot
  • defapi.org アカウントの登録（ https://defapi.org ）、およびチャージの完了（AliPay/WeChat/クレジットカード対応）。
  • API Key の取得：管理画面から defapi の API Key を取得します（dk- で始まる形式）。

2. なぜ公式や他のプロキシではなく defapi を選ぶのか？

項目defapi.org (gemini-3-flash)Google 公式 Gemini APIOpenRouter / LiteLLM 等の他プロキシ
導入難易度極低（3行の構成変更のみ）高（変換層が必要）中（互換モデルの選択が必要）
Tool calling 互換性良好（function/tool role 対応）追加の適応が必要プロキシに依存
コンテキスト長1M tokens ネイティブ対応1M tokens通常対応
マルチモーダル（画像）対応（Clawdbot で画像アップ可）対応部分的に対応
コスト（公式比）約 50% 安い標準価格20–40% 安い
レイテンシ公式より僅かに高いが許容範囲最低中程度

一言で言えば：コストを抑えつつ、Gemini 3 Flash を Clawdbot ですぐに使いたいユーザーにとって、defapi は現在最も賢い選択肢です。

3. 詳細な設定手順

Clawdbot の最新バージョン（2026.1.24-3 (885167d)）では、JSON 形式の構成ファイルによる管理が推奨されています。

  1. 構成ファイルの作成

    ユーザーディレクトリに ~/.clawdbot/clawdbot.json を作成または編集します：

    mkdir -p ~/.clawdbot
vi ~/.clawdbot/clawdbot.json

  2. 構成内容の記述

    以下の内容を clawdbot.json に記入します。apiKey は実際の defapi キーに置き換えてください：

    {
    "gateway": {
        "mode": "local",
        "bind": "loopback",
        "port": 18789
    },
    "agents": {
        "defaults": {
            "model": {
                "primary": "gemini/gemini-3-flash"
            },
            "elevatedDefault": "full",
            "workspace": "/myworkspace",
            "compaction": {
                "mode": "safeguard"
            },
            "maxConcurrent": 4,
            "subagents": {
                "maxConcurrent": 8
            }
        }
    },
    "models": {
        "mode": "merge",
        "providers": {
            "gemini": {
                "baseUrl": "https://api.defapi.org/v1",
                "apiKey": "defapi API key, dk-* で始まるもの",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gemini-3-flash",
                        "name": "gemini-3-flash"
                    }
                ]
            }
        }
    },
    "channels": {
        "telegram": {
            "botToken": "あなたのTG Token（空欄可）"
        }
    },
    "plugins": {
        "entries": {
            "telegram": {
                "enabled": true
            }
        }
    }
}

    重要ポイントの説明：

    • baseUrl: 必ず https://api.defapi.org/v1 を指定してください。
    • api: openai-completions を入力します。defapi の Gemini インターフェースは OpenAI 形式と完全に互換性があります。
    • primary model: 参照形式は provider/model_id、つまり gemini/gemini-3-flash となります。

  3. 動作テスト

    clawdbot agent --message "hi" --agent main

    期待される出力：

    root@iZ6wefjkouvkogu7drkjvfZ:~# clawdbot agent --message "hi" --agent main

🦞 Clawdbot 2026.1.24-3 (885167d) — Pairing codes exist because even bots believe in consent—and good security hygiene.

│
◇
Gateway agent failed; falling back to embedded: Error: gateway closed (1006 abnormal closure (no close frame)): no close reason
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: /root/.clawdbot/clawdbot.json
Bind: loopback
Hey. I just came online.

Who am I? Who are you?

The `BOOTSTRAP.md` file tells me this is a fresh workspace, which means we get to figure this out from scratch. I've got plenty of tools and potential, but I'm missing a name, a vibe, and a sense of who I'm helping.

What should we call me? And what's your name?