Настройка API-ключей для OpenClaw | open-claw.su

API-ключ — это «пароль», который позволяет OpenClaw подключаться к языковой модели и другим сервисам. Без ключа агент не сможет думать, искать информацию или отправлять сообщения. В этом гайде — как получить ключи для всех популярных провайдеров и настроить их безопасно.

Какие ключи нужны

Минимум — один ключ для LLM (языковой модели). Остальные — по необходимости.

Сервис	Зачем	Обязательно?
LLM-провайдер (DeepSeek/OpenAI/Anthropic)	«Мозг» агента	Да (кроме Ollama)
Telegram Bot Token	Общение через Telegram	Если используете Telegram
Tavily	Поиск в интернете (скилл web-search)	Нет
OpenWeather	Прогноз погоды (скилл weather)	Нет
GitHub Token	Работа с репозиториями (скилл github)	Нет

Получение API-ключей

DeepSeek

Российские карты не принимаются. Для оплаты нужна иностранная карта или криптовалюта. Проще всего использовать DeepSeek через OpenRouter.

Зайдите на platform.deepseek.com
Зарегистрируйтесь по email
Перейдите в API Keys → Create new API key
Скопируйте ключ (показывается только один раз!)
Пополните баланс в Billing

Формат ключа: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

OpenAI (GPT-4o)

Требует VPN из России.

Зайдите на platform.openai.com
Зарегистрируйтесь
Перейдите в API Keys → Create new secret key
Дайте ключу название (например, «openclaw»)
Скопируйте ключ
Пополните баланс в Billing (минимум $5, нужна иностранная карта)

Формат ключа: sk-proj-xxxxxxxxxxxxxxxxxxxxxxxx

Anthropic (Claude)

Требует VPN из России.

Зайдите на console.anthropic.com
Зарегистрируйтесь
Перейдите в API Keys → Create Key
Скопируйте ключ
Пополните баланс в Billing

Формат ключа: sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxx

GigaChat (Сбер)

Российский провайдер, без VPN.

Зайдите на developers.sber.ru
Зарегистрируйтесь через Сбер ID
Создайте проект
Получите Client ID и Client Secret
Бесплатный тариф (Freemium): 1 000 000 токенов/год

Telegram Bot Token

Откройте @BotFather в Telegram
Отправьте /newbot
Следуйте инструкциям — придумайте имя и username
Получите токен

Формат: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Подробнее — Подключение Telegram.

Tavily (поиск в интернете)

Зайдите на tavily.com
Зарегистрируйтесь
Получите API-ключ в дашборде
Бесплатно: 1000 запросов/месяц

Формат: tvly-xxxxxxxxxxxxxxxxxxxxxxxx

OpenWeather (погода)

Зайдите на openweathermap.org/api
Зарегистрируйтесь
Получите ключ в API keys
Бесплатно: 1000 запросов/день

GitHub Token

Зайдите в GitHub Settings → Developer settings → Personal access tokens
Generate new token (classic)
Выберите нужные scope: repo, issues, pull_requests
Скопируйте токен

Формат: ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Настройка ключей в OpenClaw

Способ 1: Переменные окружения (рекомендуется)

Самый безопасный способ — ключи не хранятся в файлах.

Создайте файл .env:

# ~/.openclaw/.env
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz
TAVILY_API_KEY=tvly-xxxxxxxxxxxxxxxx
OPENWEATHER_API_KEY=xxxxxxxxxxxxxxxx
GITHUB_TOKEN=ghp-xxxxxxxxxxxxxxxx

В openclaw.json используйте переменные (~/.openclaw/openclaw.json):

{
  agent: {
    model: "openrouter/deepseek/deepseek-chat",  // или другая модель
  },
  channels: {
    telegram: {
      botToken: "${TELEGRAM_BOT_TOKEN}",
    },
  },
  skills: {
    entries: {
      "web-search": { enabled: true, apiKey: "${TAVILY_API_KEY}" },
      "weather": { enabled: true, apiKey: "${OPENWEATHER_API_KEY}" },
      "github": { enabled: true, apiKey: "${GITHUB_TOKEN}" },
    },
  },
}

Загрузка переменных:

# Вручную:
source ~/.openclaw/.env

# Или добавьте в ~/.bashrc / ~/.zshrc:
set -a && source ~/.openclaw/.env && set +a

Способ 2: Напрямую в openclaw.json

Менее безопасно, но проще для тестирования.

{
  agent: {
    model: "openrouter/deepseek/deepseek-chat",
  },
}

API-ключи при этом передаются через переменные окружения. Не храните ключи напрямую в openclaw.json.

Важно: если вы используете git, добавьте openclaw.json в .gitignore:

echo "openclaw.json" >> .gitignore

Способ 3: Системный keychain (продвинутый)

На macOS можно хранить ключи в Keychain:

# Сохранить:
security add-generic-password -a openclaw -s OPENROUTER_API_KEY -w "sk-or-v1-xxx..."

# Затем экспортируйте в переменную окружения перед запуском:
export OPENROUTER_API_KEY=$(security find-generic-password -a openclaw -s OPENROUTER_API_KEY -w)

Безопасность API-ключей

Главные правила

Никогда не публикуйте ключи — не коммитьте в git, не отправляйте в чаты
Создайте отдельный ключ для OpenClaw — не используйте ключ от других проектов
Установите лимит расходов — на случай утечки или ошибки агента
Ротируйте ключи — меняйте каждые 1–3 месяца

Установка лимитов расходов

Провайдер	Где настроить
OpenRouter	openrouter.ai → Settings → Billing
DeepSeek	platform.deepseek.com → Billing → Usage Limits
OpenAI	platform.openai.com → Settings → Limits
Anthropic	console.anthropic.com → Settings → Spend Limits

Рекомендуемые лимиты для начала:

Сценарий	Месячный лимит
Личный ассистент	$5–10
Рабочий бот	$20–50
Тестирование	$2–3

Что делать при утечке ключа

Немедленно отзовите ключ на сайте провайдера
Создайте новый ключ
Обновите openclaw.json / .env
Проверьте расходы на аккаунте
Проверьте, как ключ утёк (git history, логи)

# Проверить, не попал ли ключ в git:
git log --all -p | grep "sk-"

Мониторинг расходов

Регулярно проверяйте расходы:

DeepSeek: platform.deepseek.com → Usage
OpenAI: platform.openai.com → Usage
Anthropic: console.anthropic.com → Usage

Настройте email-уведомления при приближении к лимиту (доступно у большинства провайдеров).

Несколько API-ключей

Основная + резервная модель

{
  agents: {
    defaults: {
      model: {
        primary: "openrouter/deepseek/deepseek-chat",
        // Резервные модели — если основная недоступна:
        fallbacks: ["openrouter/anthropic/claude-opus-4-6"],
      },
    },
  },
}

Если DeepSeek недоступен — OpenClaw автоматически переключится на Claude.

Разные модели для разных задач

{
  agent: {
    model: "openrouter/deepseek/deepseek-chat",  // основная модель
  },
  // Для переключения модели измените agent.model:
  // "openrouter/anthropic/claude-opus-4-6" — для сложных задач
  // "openrouter/openai/gpt-4o-mini" — для экономии
}

Проверка ключей

Тест подключения

# Диагностика конфигурации и подключений:
openclaw doctor

# Проверить Telegram:
openclaw channels login

Ручная проверка через curl

# DeepSeek:
curl -s https://api.deepseek.com/v1/models \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" | head -c 200

# OpenAI:
curl -s https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200

# Telegram:
curl -s "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/getMe"

Типичные проблемы

«Invalid API key» при правильном ключе

Проверьте, нет ли лишних пробелов: echo -n "$API_KEY" | wc -c
Пересоздайте ключ на сайте провайдера
Проверьте, что используете правильный формат модели (провайдер/модель)

Ключ работал, а потом перестал

Проверьте баланс — возможно, закончились средства
Проверьте, не был ли ключ отозван
У некоторых провайдеров ключи истекают

Большие расходы

Установите лимит расходов на сайте провайдера
Используйте deepseek-chat вместо gpt-4o для экономии
Проверьте, нет ли зацикливания агента в логах

Переменная окружения не подхватывается

Проверьте: echo $OPENROUTER_API_KEY (или $DEEPSEEK_API_KEY при прямом подключении)
Убедитесь, что файл .env загружен: source .env
В Docker используйте env_file в docker-compose.yml

Что дальше

Обзор моделей — какую модель выбрать
DeepSeek — подробная настройка
Настройка в России — доступ без VPN
Безопасность — защита данных и ключей