Подключение OpenClaw к DeepSeek: пошаговая инструкция
В нише нейросетевых инструментов постепенно набирает популярность OpenClaw — умный ИИ-ассистент, который работает прямо на компьютере или сервере пользователя. Такой ассистент может помогать выполнять различные задачи: отвечать на сообщения, искать информацию, автоматизировать рутинные действия и даже участвовать в бизнес-процессах.
По сути OpenClaw — это программа с собственными алгоритмами и инфраструктурой, которая умеет подключаться к различным каналам общения (например, Telegram) и взаимодействовать с языковыми моделями. Однако сама по себе программа не генерирует ответы. За «мышление» отвечает внешняя нейросеть, которая обрабатывает запросы пользователя и формирует ответы.
Другими словами, OpenClaw — это оболочка и инфраструктура для работы ИИ, а «мозгами» системы выступает подключенная языковая модель.
Как можно подключить нейросеть к OpenClaw
Существует несколько способов подключить модель к OpenClaw.
Первый вариант — подключение через подписочные сервисы. Например:
- Claude
- ChatGPT
- Gemini
Однако у такого подхода есть определенные ограничения. Например, некоторые сервисы могут блокировать подозрительные автоматизированные подключения или ограничивать использование через пользовательские подписки. Кроме того, отдельные сервисы недоступны в некоторых странах или требуют дополнительных инструментов для работы.
Второй вариант — использовать бесплатные или промежуточные сервисы вроде OpenRouter или некоторые открытые модели (например Qwen). Но у таких решений обычно есть ограничения по количеству запросов или токенов, поэтому они подходят скорее для тестирования, чем для постоянной работы.
Подключение через API
Еще один вариант — подключить нейросеть напрямую через API. Это один из самых гибких способов, потому что он позволяет оплачивать только фактическое использование модели.
Одним из самых доступных вариантов на данный момент считается API китайской нейросети DeepSeek. Именно о ней и пойдет речь в этой статье — точнее о том, как подключить DeepSeek к OpenClaw через API.
Почему DeepSeek через API
Есть несколько причин выбрать именно этот вариант.
Во-первых, DeepSeek считается одним из самых дешевых API среди современных языковых моделей. Согласно официальной документации DeepSeek, стоимость использования модели составляет примерно:
- $0.28 за 1 миллион входных токенов
- $0.42 за 1 миллион выходных токенов
Для сравнения, многие другие коммерческие модели стоят значительно дороже, особенно при большом количестве запросов.
Во-вторых, API-модель оплаты особенно выгодна, если вы используете нейросеть нерегулярно. Например:
- для автоматизации небольших задач
- для личного помощника
- для обработки сообщений
- для периодических запросов
В таком случае платить за использование API может оказаться дешевле, чем покупать ежемесячную подписку на сервис вроде ChatGPT.Конечно, многое зависит от конкретных задач. Если вы активно используете нейросеть каждый день, подписка может быть удобнее. Но если использование эпизодическое — API часто оказывается более экономичным вариантом.
Что понадобится заранее
Перед настройкой подготовьте:
- сервер
- API key от DeepSeek;
- Telegram bot token, если хотите работать через Telegram.
По официальной документации OpenClaw требует Node.js 22 или новее. Установщик OpenClaw умеет проверять и при необходимости ставить Node автоматически.
Шаг 1. Чистая установка или переустановка OpenClaw
Официально OpenClaw рекомендует устанавливать себя через installer script. Этот способ считается основным: он сам проверяет Node, устанавливает CLI и запускает onboarding.
Для Linux, macOS и WSL2 команда такая:
curl-fsSL https://openclaw.ai/install.sh | bash
Если же вам принципиально нужен вариант через pnpm, официальный сайт допускает ручную установку при наличии Node 22+. Важно: pnpm нужен именно для такого сценария, когда вы управляете установкой сами.
Шаг 2. Запуск мастера настройки
Главная команда для первоначальной настройки и возврата в мастер:
openclaw onboard
Это официальный onboarding wizard OpenClaw. Через него настраиваются провайдер модели, gateway, workspace и каналы.
Если вы хотите сразу установить daemon-сервис, используйте:
openclaw onboard --install-daemon
Такой режим тоже предусмотрен официальной документацией.
Шаг 3. Подключение DeepSeek
На этапе выбора модели и провайдера для DeepSeek удобнее использовать не встроенный OpenAI-провайдер, а Custom Provider с OpenAI-compatible API.
Почему так: официальная документация OpenClaw для custom provider поддерживает указание base URL, model ID, API key и режима совместимости, а документация DeepSeek прямо говорит, что API совместим с OpenAI SDK и использует базовый URL https://api.deepseek.com.
Заполнять поля стоит так:
· При выборе провайдера: Custom Provider
· Type / Compatibility: OpenAI-compatible
· Base URL: https://api.deepseek.com
· API key: ваш ключ DeepSeek
· Model ID: deepseek-chat
Именно deepseek-chat указан в официальных примерах DeepSeek API для Python, Node.js и curl.
Что писать в Endpoint ID
Если мастер сам предлагает автосгенерированное имя — это нормально. Но для читаемости конфигурации удобнее указать простой идентификатор вручную, например:
· Endpoint ID / Provider ID: deepseek
Тогда модель в конфиге будет выглядеть логично и понятно:
deepseek/deepseek-chat
Это не обязательное правило, а просто удобная практика именования.
Шаг 4. Первый запуск и проверка
Самый быстрый способ проверить, что модель подключилась корректно, — не Telegram, а встроенный Dashboard. В документации OpenClaw это прямо рекомендуется как fast path: после onboarding можно открывать dashboard командой openclaw dashboard.
Сначала проверьте gateway:
openclaw gateway status
Команда gateway status показывает состояние сервиса и, при необходимости, делает probe-проверку доступности gateway.
После этого откройте интерфейс:
openclaw dashboard
По официальной документации dashboard — это административная веб-панель для чата, конфигурации и управления сессиями.
Шаг 5. Подключение Telegram
Если Telegram-бота у вас еще нет, создайте его через @BotFather. В официальной документации Telegram указано, что токен получается через команду /newbot, а сам токен нужно хранить как пароль и никому не передавать.
OpenClaw в разделе Telegram тоже прямо указывает: откройте @BotFather, убедитесь, что это именно официальный аккаунт, выполните /newbot, сохраните токен. Если бот уже создан, заново создавать его не нужно.
Конект бота с Telegram
В OpenClaw для Telegram по умолчанию используется pairing для личных сообщений. Это официально указано в документации канала Telegram.
Если бот прислал сообщение вроде:
Access not configured Your Telegram user id: XXXXXXXX Pairing code: AЕYМLCJ7
значит, нужно одобрить подключение с сервера:
openclaw pairing approve telegram AЕYМLCJ7
Именно такой синтаксис команды есть в официальной CLI-документации OpenClaw.
Шаг 6. Завершение настроек и перезапуск
Когда onboarding завершен, еще раз проверьте состояние gateway:
openclaw gateway status
Если вы сменили модель или часть конфигурации, обычно достаточно перезапустить gateway. В практическом сценарии это выглядит так:
openclaw gateway restart
Самая короткая логика настройки
Если свести все к минимуму, последовательность такая:
1. Переустановить или установить OpenClaw.
2. Запустить openclaw onboard.
3. Выбрать Custom Provider.
4. Указать:
- OpenAI-compatible
- https://api.deepseek.com
- свой DeepSeek API key
- Endpoint ID: deepseek
- Model ID: deepseek-chat
5. Завершить onboarding.
6. Проверить openclaw gateway status.
7. Открыть openclaw dashboard.
8. Подключить или оставить существующего Telegram-бота.
9. При необходимости выполнить pairing через openclaw pairing approve telegram
.
Как работает веб-поиск
Веб-поиск в OpenClaw можно реализовать несколькими способами. Один из вариантов — использовать встроенный платный инструмент web_search, который в OpenClaw работает через внешнего провайдера поиска. Официальная документация указывает, что для этого можно подключить, например, Brave Search, Perplexity, Gemini, Grok или Kimi. Настройка такого поиска доступна прямо в onboarding wizard или позже через конфигурацию openclaw configure --section web.
Однако в этой инструкции рассматривается другой сценарий — бесплатный вариант с SearXNG, который поднимается отдельно на том же сервере, либо устанавливается в качестве Skills.
Системный промт для web-поиска.
Системный промт сам по себе не выполняет веб-поиск и не умеет «ходить в интернет». Он лишь задает правила поведения модели: например, использовать переданные результаты поиска как источник контекста и не придумывать факты без опоры на данные. То есть системный промт может влиять на то, как модель интерпретирует уже найденную информацию, но сам механизм поиска должен быть реализован отдельно — через встроенный web_search OpenClaw или через вашу внешнюю интеграцию, например с SearXNG.
Итог
Если вам нужен относительно недорогой способ запустить OpenClaw с внешней моделью, связка с DeepSeek через API — один из самых понятных вариантов для старта. У DeepSeek есть официальный OpenAI-compatible API, у OpenClaw — штатная поддержка custom provider через onboarding wizard, а Telegram подключается через стандартный bot token и pairing. В результате получается рабочая связка: OpenClaw как инфраструктура, DeepSeek как модель, Telegram как удобный интерфейс доступа.