Zeroclaw подключает низкостоимостные Gemini и Claude API от Defapi

Этот урок научит вас подключать различные большие языковые модели в Zeroclaw через платформу Defapi. Используя Defapi, вы получаете опыт работы, полностью совместимый с официальными интерфейсами, при крайне выгодной стоимости.

Введение

Zeroclaw — это среда выполнения автономных ИИ-агентов, написанная на Rust, которая поддерживает взаимодействие с пользователями через такие каналы, как 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: Интеллектуальный чат-бот поддержки

Круглосуточное предоставление быстрых ответов и дружелюбной поддержки пользователям.

[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: Агент для автоматизированных исследований

Способен самостоятельно искать информацию в сети и структурировать результаты, подходит для глубокого анализа и сбора данных.

[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