Anleitung zur Integration der Gemini-API in Clawdbot (Moltbot/OpenClaw)

Vollständiges Tutorial zur Integration von Gemini 3 Flash in Clawdbot (Moltbot/OpenClaw) unter Verwendung des defapi.org Proxys.

Clawdbot bietet von Haus aus die beste Unterstützung für den "tool use" von Anthropic Claude. Die Gemini-Serie (insbesondere das schnelle Gemini 3 Flash mit extrem langem Kontext) zeigt jedoch eine hervorragende Leistung bei Suchanfragen, schnellen Antworten und multimodalen Aufgaben. Die direkte Anbindung an die offizielle Google Gemini API erfordert für den Clawdbot oft komplexe Formatkonvertierungsschichten (wie litellm oder benutzerdefinierte Relays). defapi.org bietet hier eine Lösung mit nahezu null Konfigurationsaufwand – es verpackt Gemini in eine Anthropic/OpenAI-kompatible Schnittstelle, was insbesondere für das Tool Calling eine hervorragende Durchlässigkeit bietet.

Das Highlight: Durch die Einbindung von Gemini 3 Flash über defapi.org sind die tatsächlichen Kosten etwa 50 % günstiger als bei der offiziellen Google API (basierend auf Community-Tests und Preisvergleichen von 2026: Offizielles Gemini 3 Flash Input ≈ $0,50–$1,00 / 1M Tokens, Output $3,00+; der defapi-Proxy bietet oft 40–60 % Rabatt, was bei intensiver Nutzung die Kosten halbiert, besonders geeignet für Agent-Szenarien wie den Clawdbot mit häufigen Tool-Aufrufen).

Hier sind die aktuellsten und stabilsten Schritte zur Einrichtung für das Jahr 2026.

1. Voraussetzungen

Clawdbot installiert (verwendete Version in diesem Test: 2026.1.24-3 (885167d)). Falls es sich um einen neuen Server handelt, können Sie die folgenden Befehle zur Schnellinstallation verwenden:
```
# fnm und Node.js 24 installieren
curl -o- https://fnm.vercel.app/install | bash
source ~/.bashrc
fnm install 24

# clawdbot installieren
npm install -g clawdbot
```
defapi.org Account registriert ( https://defapi.org ), Guthaben aufgeladen (unterstützt Alipay/WeChat/Kreditkarte).
API Key erhalten: Holen Sie sich Ihren defapi API Key im Dashboard (Format beginnt meist mit dk-).

2. Warum defapi statt der offiziellen API oder anderer Proxys?

Merkmal	defapi.org (gemini-3-flash)	Offizielle Google Gemini API	Andere Proxys (OpenRouter / LiteLLM etc.)
Komplexität der Einbindung	Extrem gering (3 Zeilen Config)	Hoch (erfordert Konvertierungsschicht)	Mittel (Anpassung kompatibler Modelle nötig)
Tool-Calling Kompatibilität	Gut (unterstützt function/tool role)	Erfordert zusätzliche Anpassung	Variiert je nach Proxy
Kontextlänge	1M Tokens nativ unterstützt	1M Tokens	Meist unterstützt
Multimodalität (Bild/Text)	Unterstützt (Clawdbot kann Bilder hochladen)	Unterstützt	Teilweise unterstützt
Kosten (rel. zu offiziell)	Ca. 50 % günstiger	Basispreis	20–40 % günstiger
Latenz	Etwas höher als offiziell, aber akzeptabel	Am niedrigsten	Mittel

Kurz gesagt: Für preisbewusste Clawdbot-Nutzer, die schnell Gemini 3 Flash nutzen möchten, ist defapi aktuell die attraktivste Wahl.

3. Detaillierte Konfigurationsschritte

Die neueste Version von Clawdbot (2026.1.24-3 (885167d)) empfiehlt die Verwendung einer JSON-Konfigurationsdatei.

Konfigurationsdatei erstellen

Erstellen oder bearbeiten Sie die Datei ~/.clawdbot/clawdbot.json in Ihrem Benutzerverzeichnis:
```
mkdir -p ~/.clawdbot
vi ~/.clawdbot/clawdbot.json
```

Konfigurationsinhalt einfügen

Fügen Sie den folgenden Inhalt in die clawdbot.json ein. Ersetzen Sie dabei apiKey durch Ihren echten defapi-Key:

{
    "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, beginnt mit dk-*",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gemini-3-flash",
                        "name": "gemini-3-flash"
                    }
                ]
            }
        }
    },
    "channels": {
        "telegram": {
            "botToken": "Ihr TG Token (optional)"
        }
    },
    "plugins": {
        "entries": {
            "telegram": {
                "enabled": true
            }
        }
    }
}

Wichtige Hinweise:

baseUrl: Muss https://api.defapi.org/v1 sein.
api: Tragen Sie openai-completions ein, da die Gemini-Schnittstelle von defapi voll kompatibel zum OpenAI-Format ist.
primary model: Das Referenzformat ist provider/model_id, hier also gemini/gemini-3-flash.

Ergebnis testen

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

Erwartete Ausgabe:

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?