Введение: в эпоху ИИ, если вы не можете без затрат завершить развертывание OpenClaw с помощью инструментов ИИ, то я не рекомендую вам настраивать OpenClaw.
Следующий контент был завершен за 5 часов в диалоге с gemini 3. С помощью этого руководства вы сможете завершить локальную настройку за 15 минут. Если возникнут какие-либо проблемы, вы можете сделать скриншот и отправить его любому AI инструменту для решения проблемы.
Глобальная карта прохождения: подготовка "припасов" (настройка окружения) → установка маленького рака → настройка ИИ мозга → подключение Telegram → использование прокси и устранение проблем.
Если у вас все еще не получается, вы можете присоединиться к моему AI чату.
Первый шаг: подготовка "припасов" (всего 3 минуты)
1. Работа рака зависит от Node.js, и требуется версия 22 или выше.
1. Откройте браузер и посетите официальный сайт Node.js: nodejs.org
2. Загрузите Windows установочный пакет версии v22.x (рекомендуется загрузка версии LTS с долгосрочной поддержкой).
Установите, дважды щелкнув, как обычное программное обеспечение, просто нажимайте "Далее" (Next) (убедитесь, что по умолчанию отмечена опция "Добавить в PATH").
3. Проверьте, успешно ли: нажмите клавиши Win + R на клавиатуре, введите cmd и нажмите Enter, чтобы открыть черное окно командной строки. Введите: node -v
Если на экране отображается v22.x.x, значит, среда готова!
2. Загрузите Git:
1. Откройте браузер и перейдите на страницу загрузки Git: https://git-scm.com/download/win
2. Нажмите "Нажмите здесь, чтобы скачать" для загрузки последнего установочного пакета Windows 64-bit.
Дважды щелкните на загруженный установочный пакет и просто нажимайте "Далее" (Next).
3. В новом окне сначала введите git --version, если он выводит строку версии, значит, Git установлен успешно.
3. Ключ API MiniMax (ключ большой модели)
1. Зарегистрируйтесь и войдите в открытую платформу MiniMax.
После пополнения базового пакета создайте API Key (долгая строка символов, начинающаяся с sk-). Это определяет интеллект рака.
4. Токен бота Telegram (ключ пульта управления)
1. Откройте Telegram и найдите @BotFather.
2. Отправьте команду /newbot и следуйте инструкциям, чтобы дать вашему боту имя.
После успешного выполнения вы получите токен, похожий на 123456789:ABCDefgh...
Шаг 2: Загрузите "рак" одним нажатием (всего 1 минута)
Среда готова, теперь просто перенесите рака на ваш компьютер.
Продолжайте в том черном окне cmd, скопируйте и вставьте следующую строку команды и нажмите Enter:
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
После завершения индикатора выполнения введите openclaw --version, если вы видите номер версии, поздравляем, рак уже на вашем компьютере!
Шаг 3: Инициализация конфигурации (всего 10 минут)
Рак сам по себе является лишь "оболочкой", нам нужно инъектировать ему "мозг" (то есть API большого модели) и настроить его способ работы.
Введите следующую команду в cmd для запуска мастера конфигурации:
openclaw onboard
На экране появятся несколько вопросов на английском, выберите так:
1. Я понимаю, что это персонально по умолчанию, и использование другими пользователями требует блокировки. Продолжить? Выберите "ДА".
2. Выберите режим настройки (выберите режим установки): используйте клавиши вверх и вниз, чтобы выбрать "Быстрый старт".
3. Подключение к приложениям для обмена сообщениями: он спросит, хотите ли вы подключиться к Telegram, Discord или WeChat. Сначала установите "мозг", просто выберите "Пропустить".
4. Выберите AI Model (выберите AI модель): здесь нужно выбрать большую языковую модель в качестве мозга.
Я выбрал MiniMax (у него сейчас есть план с бесплатным лимитом, который не требует сложной настройки API Key, чтобы запуститься (вы также можете воспользоваться другими AI моделями))
Для сетевой среды в Китае лучше всего выбрать MiniMax (сеть морской раковины), это самый простой вариант.
Токен, купленный за 29 юаней, достаточно, чтобы рак работал долго! После покупки официальный сайт также даст вам купон на 15 юаней.
Ссылка на себя включает: 10% специальная скидка + права Builder, возврат + привилегии сообщества!
👉 Портал:
https://platform.minimaxi.com/subscribe/coding-plan?code=2tgeq3tHNt&source=link
Руководство по подключению мозга MiniMax
После покупки пакета на платформе MiniMax (открытой платформе) найдите ваш API Key и код модели, которую вы будете использовать (обычно это abab6.5s-chat или abab6.5-chat и т.д.).
Получив эти две вещи, вернитесь в только что открытое черное окно командной строки Windows:
Шаг 1: Принудительно сбросьте, дважды нажав клавиши Ctrl + C на клавиатуре, затем введите ещё раз:
openclaw onboard
Шаг 2: Выберите MiniMax
Выберите AI Model: в списке моделей используйте клавиши вверх и вниз, чтобы тщательно проверить, есть ли опция под названием MiniMax.
Базовый URL API: https://api.minimax.chat/v1 （это совместимый адрес интерфейса официального стандарта MiniMax）
Ключ API: вставьте сгенерированный вами ключ в панели MiniMax
Совместимость конечной точки: выберите OpenAI-совместимый
Идентификатор модели: введите код модели, соответствующий вашему пакету (например, abab6.5s-chat), если есть: просто выберите и вставьте ваш API Key, всё очень просто.
Если нет (или версия другая): выберите Custom Provider, а затем, как раньше, введите "три вещи":
Шаг 3: Запустите конфигурацию после завершения, введите финальную команду:
openclaw gateway
Если ваша сеть стабильна, это точно сразу выдаст зеленую надпись "Успешная проверка!" Затем ваш браузер автоматически откроет консоль рака.
Просто нажмите клавишу Enter на клавиатуре, выберите первый пункт > Сохранить текущее (minimax-cn/MiniMax-M2.5). Примечание: M2.5 подходит для обработки длинных текстов и генерации аналитики.
Нажав Enter, при условии, что сеть работает хорошо, на экране сразу же появится зеленый текст: Успешная проверка!
Ваш браузер должен автоматически открыть веб-страницу консоли, похожую на эту. (Если не открылось автоматически, то адрес консоли по умолчанию всегда http://127.0.0.1:18789)
Шаг 4: Токен бота Telegram (ключ пульта управления) (всего 1 минута)
Привяжите Telegram-бота
Как вы хотите предоставить токен этого бота Telegram?
Выберите Введите токен бота Telegram.
Вставьте длинный токен, который вы получили от @BotFather, и нажмите Enter.
Откройте Telegram и найдите @BotFather (официальный бот, убедитесь, что он с синей галочкой).
Отправьте команду /newbot в чате.
Следуя инструкциям, дайте вашему боту яркое отображаемое имя.
Дайте ему уникальный идентификатор пользователя (⚠️ должен заканчиваться на _bot, например, SanjinClaw_bot).
После успешного создания BotFather отправит вам длинный токен HTTP API (что-то вроде 123456789:AAH...). Скопируйте его полностью, это "душа" вашего бота!
Откройте черное окно
Введите эту команду, чтобы принудительно записать ваш токен в мозг рака (не забудьте заменить последние китайские символы на ваш настоящий токен, сохранив кавычки): openclaw config set channels.telegram.botToken "ваш_настоящий_Token"
Перейдите в Telegram и найдите только что созданное имя пользователя вашего бота, нажмите Start или отправьте любое сообщение (например, hello).
Сейчас на экране будет следующий шаг: Настроить навыки сейчас? (рекомендуется).
Просто нажмите Enter, чтобы выбрать > Да!
На этом интерфейсе перечислены различные "плагины третьих сторон", предустановленные раком.
В данный момент мне не нужно устанавливать эти ненужные дополнительные плагины, я могу позволить раку установить их позже, поэтому я пропустил.
Просто нажмите Enter: оставьте текущий выбранный вариант [•] Пропустить на данный момент (Продолжить без установки зависимостей) и просто нажмите клавишу Enter на клавиатуре.
Официальный запуск: после завершения мастера введите команду запуска в командной строке (обычно это openclaw gateway или введите openclaw start в соответствии с последними подсказками на экране) и нажмите Enter.
Как только командная строка указывает, что служба запущена (Server started), ваш Telegram-бот уже официально "ожил"!
Веб-консоль
Адрес консоли по умолчанию для всех: http://127.0.0.1:18789
Поэтому в инструкции указан этот адрес, он подходит для всех.
Шаг 5: Разблокировка сети и официальное зажигание (всего 1 минута)
Поскольку OpenClaw требует подключения к зарубежным серверам Telegram, а командная строка Windows по умолчанию не использует прокси, нам нужно вручную "построить лестницу".
Инъекция сетевого прокси
В черном окне, где вы только что завершили мастер, подтвердите локальный порт вашего прокси (например, 7890 для Clash), затем введите по очереди эти три строки команд и нажмите Enter:
set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
openclaw gateway
(⚠️ Внимание: это черное окно ни в коем случае нельзя закрывать, это "сердце" рака, закрытие приведет к отключению питания.)
Возможные проблемы:
1. Почему Telegram выдает множество ошибок? (проблемы с сетью)
Ошибка Network request failed возникает из-за того, что хотя мы используем MiniMax, который находится в Китае (то есть с хорошим интернетом), сервер Telegram находится за границей.
Командная строка Windows (cmd) по умолчанию является "послушным", она не будет автоматически использовать прокси, установленные на вашем компьютере. Поэтому рак сталкивается с проблемами при попытке подключения к Telegram.
🛠️ Решение (подключите прокси к командной строке):
Сначала убедитесь, что на вашем компьютере установлено программное обеспечение прокси (например, Clash, v2ray и т.д.) и у него есть локальный порт (обычно Clash - 7890, v2ray - 10809).
Нажмите Ctrl + C, чтобы остановить текущую службу.
В черном окне вручную установите переменные окружения прокси (предположим, ваш порт - 7890), введите по очереди эти три строки команд: set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890
openclaw gateway
После этого настройки рак сможет без проблем подключиться к Telegram!
2. Почему есть предупреждения Doctor? (механизм защиты от злоупотреблений в группе)
hannels.telegram.groupPolicy is "allowlist", но groupAllowFrom пусто
Рак по умолчанию включил режим белого списка для групп. Если не добавить ограничений, любой может добавить вашего бота в беспорядочные группы, и он будет отвечать без усталости, мгновенно исчерпая вашу квоту API и вычислительную мощность компьютера.
Решение:
В данный момент он может нормально отвечать вам в личных сообщениях. Когда мы протестируем, если всё в порядке, вы можете открыть файл конфигурации (C:\Users\0xsanjin\.openclaw\openclaw.json) и изменить groupPolicy на "open".
3. Telegram отображает: openclaw: access not configured
Эта фраза означает: "Есть человек с ID 1402624995, который хочет поговорить со мной, код пары - 2FPYxxxx. Хозяин, пожалуйста, одобрите его в панели!"
Как "разблокировать" его? (всего за 10 секунд)
Чтобы не прерывать сейчас выполняющуюся службу, выполните следующие шаги:
Откройте новое окно командной строки, нажав клавиши Win + R на клавиатуре, введите cmd и нажмите Enter, появится совершенно новое черное окно.
Введите "особый указ" в это новое окно и введите команду, которую требует ваш скриншот с телефона, без единой ошибки (или скопируйте и вставьте):
openclaw pairing approve telegram 2FPYxxxx
Нажмите Enter! Командная строка сообщит вам о успешном соединении.
4. Проблема, отображаемая в веб-консоли, как на изображении ниже
Это также мера безопасности рака. Хотя консоль открыта на вашем собственном компьютере (127.0.0.1), чтобы предотвратить подключение других вредоносных программ к вашему большому модели, рак генерирует "случайный пароль (токен)" при запуске.
Возможно, вы только что ввели адрес http://127.0.0.1:18789 вручную в браузере, веб-страница была отклонена, потому что не имела этого "пароля".
Откройте браузер и введите http://127.0.0.1:18789, если вы увидите ошибку в верхней части экрана: unauthorized: gateway token missing.
Операция: введите в новом открытом окне cmd notepad C:\Users\ваше_имя_пользователя\.openclaw\openclaw.json.
Найдите ключ: в появившемся блокноте нажмите Ctrl + F, чтобы найти token, и скопируйте ту строку пароля (без кавычек).
Вставьте пароль в настройки (Settings) в нижнем левом углу страницы или просто измените адрес на
http://127.0.0.1:18789/?token=ваш_пароль. Красная полоса мгновенно станет зеленой!