Руководство по интеграции Gemini API в Clawdbot (Moltbot/OpenClaw)

Полное руководство по интеграции Gemini 3 Flash в Clawdbot (Moltbot/OpenClaw) с использованием прокси defapi.org

Clawdbot нативно обладает самой полной поддержкой tool use для Anthropic Claude, однако серия Gemini (особенно быстрая Gemini 3 Flash с огромным контекстным окном) показывает отличные результаты в поиске, быстрых ответах и мультимодальных задачах. Прямое подключение к официальному Google Gemini API в Clawdbot обычно требует сложных слоев преобразования форматов (таких как litellm или кастомные реле), в то время как defapi.org предлагает решение, которое работает практически без правок — оно упаковывает Gemini в интерфейс, совместимый со стилем Anthropic/OpenAI, особенно качественно транслируя tool calling.

Главная особенность: Подключение Gemini 3 Flash через defapi.org обходится примерно на 50% дешевле официального API Google (согласно тестам сообщества и сравнению цен на начало 2026 года: официальный Gemini 3 Flash стоит ≈ $0.50–$1.00 / 1M токенов на вход, $3.00+ на выход; прокси-слой defapi обычно дает скидку 40–60%, что в сумме экономит более половины бюджета при интенсивном использовании, особенно в сценариях агентов Clawdbot с высокой частотой вызовов инструментов).

Ниже приведены самые актуальные и стабильные шаги подключения на 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: Скопируйте ваш API Key в панели управления defapi (формат начинается на dk-).

2. Почему стоит выбрать defapi, а не официальный API или другие прокси?

Характеристика	defapi.org (gemini-3-flash)	Официальный Google Gemini API	Другие прокси (OpenRouter / LiteLLM и т.д.)
Сложность интеграции	Очень низкая (правка 3 строк конфига)	Высокая (нужен слой конвертации)	Средняя (нужен подбор совместимой модели)
Совместимость Tool calling	Отличная (поддержка ролей function/tool)	Требует доработки	Зависит от прокси
Длина контекста	Нативная поддержка 1M токенов	1M токенов	Обычно поддерживается
Мультимодальность (фото/текст)	Поддерживается (Clawdbot может загружать фото)	Поддерживается	Частично поддерживается
Стоимость (отн. офиц.)	Примерно на 50% дешевле	Базовая цена	Дешевле на 20–40%
Задержка (Latency)	Чуть выше официальной, но приемлемо	Минимальная	Средняя

Вкратце: Для пользователей Clawdbot, чувствительных к бюджету и желающих быстро запустить Gemini 3 Flash, defapi — лучший выбор на данный момент.

3. Детальные шаги настройки

Последние версии Clawdbot (2026.1.24-3 (885167d) ) рекомендуют использовать конфигурационный файл в формате JSON.

Создание конфигурационного файла

Создайте или отредактируйте ~/.clawdbot/clawdbot.json в домашней директории пользователя:
```
mkdir -p ~/.clawdbot
vi ~/.clawdbot/clawdbot.json
```

Запись конфигурации

Вставьте следующее содержимое в 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": "Ваш API ключ defapi, начинается на dk-*",
                "api": "openai-completions",
                "models": [
                    {
                        "id": "gemini-3-flash",
                        "name": "gemini-3-flash"
                    }
                ]
            }
        }
    },
    "channels": {
        "telegram": {
            "botToken": "Ваш токен TG (опционально)"
        }
    },
    "plugins": {
        "entries": {
            "telegram": {
                "enabled": true
            }
        }
    }
}

Пояснение ключевых моментов:

baseUrl: Должен быть https://api.defapi.org/v1.
api: Укажите openai-completions, так как интерфейс Gemini у defapi полностью совместим с форматом OpenAI.
primary model: Формат ссылки — provider/model_id, то есть gemini/gemini-3-flash.

Проверка работы

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?