Коротко
- Подключение идёт через официальный плагин
@openclaw/deepseek-providerи переменнуюDEEPSEEK_API_KEY. - Онбординг прописывает
deepseek/deepseek-v4-proкак модель по умолчанию, ваши записи моделей не трогает, а список моделей подтягивает discovery. - Старые
deepseek-chatиdeepseek-reasonerбольше недоступны с 24 июля 2026, их id больше не действуют. - Если каталог пустой, посмотрите его без Gateway:
openclaw models list --all --provider deepseek.
Сверено с документацией OpenClaw 2026.10.4, 16 октября 2026.
Чтобы подключить DeepSeek как провайдера в OpenClaw 2026.10.4, поставьте плагин, пропишите ключ и выберите модель через онбординг или ручную правку конфига. После этого агенту доступна модель по умолчанию deepseek/deepseek-v4-pro.
Быстрый путь: онбординг
- Получите ключ на platform.deepseek.com в пункте API keys.
- Поставьте плагин:
openclaw plugins install @openclaw/deepseek-provider. Если Gateway уже запущен, изменения применяются сразу, иначе — после перезапуска. - Запустите онбординг:
openclaw onboard --auth-choice deepseek-api-key. Утилита запросит ключ и пропишетdeepseek/deepseek-v4-proкак основную модель. - Проверьте каталог:
openclaw models list --provider deepseek. Без запущенного Gateway:openclaw models list --all --provider deepseek.
Ручная правка конфига
Если нужно обойтись без интерактива или поправить существующий конфиг, ключ и модель задаются блоком ниже.
{
env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
agents: {
defaults: {
model: { primary: "deepseek/deepseek-v4-pro" },
},
},
}
Ключ берётся из переменных окружения процесса Gateway. На headless-сервере с systemd или launchd убедитесь, что DEEPSEEK_API_KEY доступен процессу: положите его в ~/.openclaw/.env или передайте через env.shellEnv.
Неинтерактивная установка
Для скриптов и CI-развёртывания все флаги передаются одной командой.
openclaw onboard --non-interactive \
--mode local \
--auth-choice deepseek-api-key \
--deepseek-api-key "$DEEPSEEK_API_KEY" \
--skip-health \
--accept-risk
Каталог моделей DeepSeek
Плагин публикует четыре модели. У всех контекст 1 000 000 токенов и выход до 384 000 токенов.
deepseek/deepseek-flash— DeepSeek V4.1 Flash, текст и изображения, основная модель для изображений.deepseek/deepseek-v4-flash— DeepSeek V4 Flash, текст, быстрый вариант с поддержкой thinking.deepseek/deepseek-v4-pro— DeepSeek V4 Pro, текст, ставится онбордингом.deepseek/deepseek-v4-flash-vision-exp— экспериментальная модель для изображений.
Переключить основную модель на Flash: openclaw models set deepseek/deepseek-flash. Для управления thinking используются /think xhigh и /think max. Оба соответствуют DeepSeek reasoning_effort “max”.
Частые ошибки
- Используются старые
deepseek-chatилиdeepseek-reasoner. DeepSeek отключил эти id 24 июля 2026 в 15:59 UTC. Переведите конфиг наdeepseek/deepseek-v4-flashилиdeepseek/deepseek-v4-pro. - Daemon не видит ключ. На launchd или systemd убедитесь, что
DEEPSEEK_API_KEYдоступен процессу Gateway: положите его в~/.openclaw/.envили передайте черезenv.shellEnv. - Боитесь, что после переключения на DeepSeek посреди диалога история сломает thinking. Не сломает: плагин сам дописывает
reasoning_contentв прошлые ответы, так что/newне нужен. Если thinking выключен (в UI — None), OpenClaw отправитthinking: { type: "disabled" }и уберётreasoning_contentиз истории.