Skip to content

Пошаговая настройка: Полная конфигурация Clawdbot

Чему вы научитесь

По окончании этого руководства вы сможете:

  • ✅ Использовать интерактивный мастер для полной настройки Clawdbot
  • ✅ Понимать разницу между режимами QuickStart и Manual
  • ✅ Настраивать сеть Gateway и параметры аутентификации
  • ✅ Настраивать провайдеры AI моделей (setup-token и API Key)
  • ✅ Включать каналы коммуникации (WhatsApp, Telegram и др.)
  • ✅ Устанавливать и управлять пакетами навыков

После завершения работы мастера шлюз Clawdbot Gateway будет работать в фоновом режиме, и вы сможете общаться с AI ассистентом через настроенные каналы.

Трудности, с которыми вы сталкиваетесь

Ручное редактирование конфигурационных файлов утомительно:

  • Неясно, что означают параметры конфигурации и их значения по умолчанию
  • Легко пропустить критические настройки, что приведет к невозможности запуска
  • Не знаете, какой способ аутентификации AI модели выбрать (OAuth, API Key)
  • Конфигурация каналов сложна, методы аутентификации различаются для каждой платформы
  • Не знаете, какие навыки следует установить

Пошаговая настройка решает эти проблемы, проводя вас через всю конфигурацию с помощью интерактивных вопросов и предоставляя разумные значения по умолчанию.

Когда использовать этот метод

  • Первая установка: новый пользователь, использующий Clawdbot впервые
  • Переконфигурация: необходимо изменить настройки Gateway, переключить AI модель или добавить новый канал
  • Быстрая проверка: хотите быстро опробовать базовые функции, не изучая файлы конфигурации
  • Устранение неполадок: после ошибок конфигурации используйте мастер для повторной инициализации

Совет

Мастер обнаружит существующую конфигурацию и предложит сохранить, изменить или сбросить настройки.

Основная идея

Два режима

Мастер предоставляет два режима конфигурации:

Режим QuickStart (рекомендуется для новичков)

  • Использует безопасные значения по умолчанию: Gateway привязан к loopback (127.0.0.1), порт 18789, аутентификация по token
  • Пропускает большинство детальных параметров конфигурации
  • Подходит для локального использования, быстрое начало работы

Режим Manual (для продвинутых пользователей)

  • Ручная настройка всех параметров
  • Поддержка привязки LAN, удаленного доступа Tailscale, настраиваемых методов аутентификации
  • Подходит для развертывания на нескольких машинах, удаленного доступа или специальных сетевых сред

Процесс настройки

1. Подтверждение предупреждения безопасности
2. Выбор режима (QuickStart / Manual)
3. Настройка Gateway (порт, привязка, аутентификация, Tailscale)
4. Аутентификация AI модели (setup-token / API Key)
5. Настройка рабочей области (по умолчанию ~/clawd)
6. Настройка каналов (WhatsApp / Telegram / Slack и др.)
7. Установка навыков (опционально)
8. Завершение (запуск Gateway)

Предупреждение безопасности

В начале работы мастер отобразит предупреждение безопасности, и вам нужно подтвердить следующее:

  • Clawdbot — это любительский проект, все еще находится в стадии бета
  • После включения инструментов AI может читать файлы и выполнять операции
  • Вредоносные запросы могут побудить AI выполнять небезопасные действия
  • Рекомендуется использовать режим сопряжения/белый список + минимальные права доступа для инструментов
  • Регулярно выполняйте аудит безопасности

Важно

Если вы не понимаете базовые механизмы безопасности и контроля доступа, не включайте инструменты и не открывайте Gateway в интернете. Рекомендуется обратиться за помощью к опытному человеку перед использованием.


🎒 Подготовка перед началом

Перед запуском мастера убедитесь, что:

  • Clawdbot установлен: следуйте Быстрому старту для завершения установки
  • Версия Node.js: убедитесь, что Node.js ≥ 22 (проверьте с помощью node -v)
  • Аккаунт AI модели (рекомендуется):
    • Аккаунт Anthropic Claude (подписка Pro/Max), поддерживающий OAuth процесс
    • Или подготовьте API Key провайдеров OpenAI/DeepSeek и др.
  • Аккаунты каналов (опционально): если нужно использовать WhatsApp, Telegram и др., сначала зарегистрируйте соответствующие аккаунты
  • Сетевые права: если нужно использовать Tailscale, убедитесь, что клиент Tailscale установлен

Выполняем вместе

Шаг 1: Запуск мастера

Откройте терминал и выполните следующую команду:

bash
clawdbot onboard

Почему Запускает интерактивный мастер настройки, который проведет вас через все необходимые параметры.

Вы должны увидеть:

  ┌─────────────────────────────────────────────────────┐
  │                                                   │
  │   Clawdbot onboarding                              │
  │                                                   │
  └─────────────────────────────────────────────────────┘

Шаг 2: Подтверждение предупреждения безопасности

Мастер сначала отобразит предупреждение безопасности (как описано в разделе "Основная идея").

Почему Гарантирует, что пользователи осведомлены о потенциальных рисках, чтобы избежать проблем с безопасностью из-за неправильного использования.

Действия:

  • Прочитайте содержание предупреждения безопасности
  • Введите y или выберите Yes, чтобы подтвердить понимание рисков
  • Если вы не принимаете риски, мастер завершится

Вы должны увидеть:

Security warning — please read.

Clawdbot is a hobby project and still in beta. Expect sharp edges.
...

I understand this is powerful and inherently risky. Continue? (y/N)

Шаг 3: Выбор режима конфигурации

bash
Рекомендуется для новичков, использует безопасные значения по умолчанию:
- Порт Gateway: 18789
- Адрес привязки: Loopback (127.0.0.1)
- Метод аутентификации: Token (автоматическая генерация)
- Tailscale: выключен
bash
Для продвинутых пользователей, ручная настройка всех параметров:
- Настраиваемый порт и привязку Gateway
- Выбор аутентификации Token или Password
- Настройка удаленного доступа Tailscale Serve/Funnel
- Детальная настройка каждого шага

Почему Режим QuickStart позволяет новичкам быстро начать работу, режим Manual дает продвинутым пользователям точный контроль.

Действия:

  • Используйте клавиши со стрелками для выбора QuickStart или Manual
  • Нажмите Enter для подтверждения

Вы должны увидеть:

? Onboarding mode
  QuickStart         Configure details later via clawdbot configure.
  Manual            Configure port, network, Tailscale, and auth options.

Шаг 4: Выбор режима развертывания (только режим Manual)

Если выбран режим Manual, мастер спросит о месте развертывания Gateway:

bash
Gateway работает на текущей машине:
- Может выполнять OAuth процесс и записывать локальные учетные данные
- Мастер завершит всю конфигурацию
- Подходит для локальной разработки или развертывания на одной машине
bash
Gateway работает на другой машине:
- Мастер настраивает только удаленный URL и аутентификацию
- OAuth процесс не выполняется, учетные данные нужно настроить вручную на удаленном хосте
- Подходит для сценариев развертывания на нескольких машинах

Почему Режим Local поддерживает полный процесс настройки, режим Remote настраивает только информацию для доступа.

Действия:

  • Выберите режим развертывания
  • Если режим Remote, введите URL и token удаленного Gateway

Шаг 5: Настройка Gateway (только режим Manual)

Если выбран режим Manual, мастер будет пошагово запрашивать настройки Gateway:

Порт Gateway

bash
? Gateway port (18789)

Описание:

  • Значение по умолчанию 18789
  • Если порт занят, введите другой порт
  • Убедитесь, что порт не заблокирован брандмауэром

Адрес привязки Gateway

bash
? Gateway bind
  Loopback (127.0.0.1)
  LAN (0.0.0.0)
  Tailnet (Tailscale IP)
  Auto (Loopback  LAN)
  Custom IP

Описание параметров:

  • Loopback: доступ только с локальной машины, наиболее безопасно
  • LAN: доступ с устройств в локальной сети
  • Tailnet: доступ через виртуальную сеть Tailscale
  • Auto: сначала пытается loopback, при неудаче переключается на LAN
  • Custom IP: ручное указание IP адреса

Совет

Рекомендуется использовать Loopback или Tailnet, избегая прямого открытия в локальной сети.

Метод аутентификации Gateway

bash
? Gateway auth
  Token              Recommended default (local + remote)
  Password

Описание параметров:

  • Token: рекомендуемый параметр, автоматическая генерация случайного token, поддержка удаленного доступа
  • Password: использование пользовательского пароля, обязательно для режима Tailscale Funnel

Удаленный доступ Tailscale (опционально)

bash
? Tailscale exposure
  Off               No Tailscale exposure
  Serve             Private HTTPS for your tailnet (devices on Tailscale)
  Funnel            Public HTTPS via Tailscale Funnel (internet)

Предупреждение Tailscale

  • Режим Serve: доступ только с устройств в сети Tailscale
  • Режим Funnel: открытый доступ через публичный HTTPS (требуется аутентификация по паролю)
  • Убедитесь, что клиент Tailscale установлен: https://tailscale.com/download/mac

Шаг 6: Настройка рабочей области

Мастер запросит директорию рабочей области:

bash
? Workspace directory (~/clawd)

Описание:

  • Значение по умолчанию ~/clawd (то есть /Users/ваше_имя_пользователя/clawd)
  • Рабочая область хранит историю сессий, конфигурацию агентов, данные навыков и др.
  • Можно использовать абсолютный или относительный путь

Поддержка нескольких конфигураций (Profile)

Установив переменную окружения CLAWDBOT_PROFILE, можно использовать независимые конфигурации для различных рабочих сред:

Значение ProfileПуть рабочей областиФайл конфигурации
default или не установлено~/clawd~/.clawdbot/clawdbot.json
work~/clawd-work~/.clawdbot/clawdbot.json (work profile)
dev~/clawd-dev~/.clawdbot/clawdbot.json (dev profile)

Пример:

bash
# Использование work profile
export CLAWDBOT_PROFILE=work
clawdbot onboard

Вы должны увидеть:

Ensuring workspace directory: /Users/ваше_имя_пользователя/clawd
Creating sessions.json...
Creating agents directory...

Шаг 7: Настройка аутентификации AI модели

Мастер выведет список поддерживаемых провайдеров AI моделей:

bash
? Choose AI model provider
  Anthropic                    Claude Code CLI + API key
  OpenAI                       Codex OAuth + API key
  MiniMax                      M2.1 (recommended)
  Qwen                         OAuth
  Venice AI                     Privacy-focused (uncensored models)
  Google                       Gemini API key + OAuth
  Copilot                      GitHub + local proxy
  Vercel AI Gateway            API key
  Moonshot AI                  Kimi K2 + Kimi Code
  Z.AI (GLM 4.7)            API key
  OpenCode Zen                 API key
  OpenRouter                   API key
  Custom API Endpoint
  Skip for now

После выбора провайдера мастер отобразит конкретный метод аутентификации в зависимости от типа провайдера. Вот параметры аутентификации для основных провайдеров:

Anthropic способы аутентификации:

  • claude-cli: использование существующей OAuth аутентификации Claude Code CLI (требуется доступ к Keychain)
  • token: вставка setup-token, сгенерированного с помощью claude setup-token
  • apiKey: ручной ввод Anthropic API Key

Способ Anthropic setup-token (рекомендуется)

Рекомендуется использовать способ setup-token, причины:

  • Нет необходимости управлять API Key вручную
  • Генерация долгосрочного токена
  • Подходит для пользователей с подпиской Pro/Max

Процесс:

  1. Сначала выполните в другом терминале: claude setup-token
  2. Эта команда откроет браузер для OAuth авторизации
  3. Скопируйте сгенерированный setup-token
  4. В мастере выберите Anthropictoken
  5. Вставьте setup-token в мастер
  6. Учетные данные автоматически сохранятся в директории ~/.clawdbot/credentials/

Способ API Key

Если выбран API Key:

  • Мастер предложит ввести API Key
  • Учетные данные сохранятся в директории ~/.clawdbot/credentials/
  • Поддержка нескольких провайдеров, можно переключаться в любое время

Пример:

bash
? Enter API Key
sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Шаг 8: Выбор модели по умолчанию

После успешной аутентификации мастер отобразит список доступных моделей:

bash
? Select default model
  anthropic/claude-sonnet-4-5      Anthropic Sonnet 4.5 (200k ctx)
  anthropic/claude-opus-4-5          Anthropic Opus 4.5 (200k ctx)
  openai/gpt-4-turbo                OpenAI GPT-4 Turbo
  deepseek/DeepSeek-V3                DeepSeek V3
  (Keep current selection)

Рекомендации:

  • Рекомендуется использовать Claude Sonnet 4.5 или Opus 4.5 (200k контекст, улучшенная безопасность)
  • Если бюджет ограничен, можно выбрать версию Mini
  • Нажмите Keep current selection, чтобы сохранить текущую конфигурацию

Шаг 9: Настройка каналов коммуникации

Мастер выведет список всех доступных плагинов каналов коммуникации:

bash
? Select channels to enable
 whatsapp       WhatsApp (Baileys Web Client)
 telegram       Telegram (Bot Token)
 slack          Slack (Bot Token + App Token)
 discord        Discord (Bot Token)
 googlechat     Google Chat (OAuth)
  (Press Space to select, Enter to confirm)

Действия:

  • Используйте клавиши со стрелками для навигации
  • Нажмите Пробел для переключения состояния выбора
  • Нажмите Enter для подтверждения выбора

Оптимизация режима QuickStart

В режиме QuickStart мастер автоматически выберет каналы с быстрым запуском (например, WebChat) и пропустит настройку DM политики, используя безопасные значения по умолчанию (режим pairing).

После выбора каналов мастер будет пошагово запрашивать настройки каждого канала:

Настройка WhatsApp

bash
? Configure WhatsApp
  Link new account     Open QR code in browser
  Skip

Действия:

  • Выберите Link new account
  • Мастер отобразит QR код
  • Используйте WhatsApp для сканирования QR кода и входа
  • После успешного входа данные сессии сохранятся в ~/.clawdbot/credentials/

Настройка Telegram

bash
? Configure Telegram
  Bot Token
  Skip

Действия:

  • Выберите Bot Token
  • Введите Bot Token, полученный от @BotFather
  • Мастер проверит успешность подключения

Получение Bot Token

  1. В Telegram найдите @BotFather
  2. Отправьте /newbot для создания нового бота
  3. Следуйте инструкциям для установки имени и имени пользователя бота
  4. Скопируйте сгенерированный Bot Token

Настройка Slack

bash
? Configure Slack
  App Token         xapp-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  Bot Token         xoxb-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  Signing Secret   a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
  Skip

Описание: Slack требует три учетных данных, получаемых из настроек Slack App:

  • App Token: Workspace level token
  • Bot Token: Bot user OAuth token
  • Signing Secret: используется для проверки подписи запросов

Создание Slack App

  1. Посетите https://api.slack.com/apps
  2. Создайте новое App
  3. На странице Basic Information получите Signing Secret
  4. На странице OAuth & Permissions установите App в Workspace
  5. Получите Bot Token и App Token

Шаг 10: Настройка навыков (опционально)

Мастер спросит, хотите ли вы установить навыки:

bash
? Install skills? (Y/n)

Рекомендации:

  • Выберите Y для установки рекомендуемых навыков (например, пакетный менеджер bird, локальный TTS sherpa-onnx-tts)
  • Выберите n для пропуска, в дальнейшем можно управлять через команду clawdbot skills

Если выбрана установка, мастер выведет список доступных навыков:

bash
? Select skills to install
 bird           macOS Homebrew пакетная установка
 sherpa-onnx-tts  Локальный TTS движок (приоритет конфиденциальности)
  (Press Space to select, Enter to confirm)

Шаг 11: Завершение настройки

Мастер подведет итог всей конфигурации и запишет в файл конфигурации:

bash
 Writing config to ~/.clawdbot/clawdbot.json
 Workspace initialized at ~/clawd
 Channels configured: whatsapp, telegram, slack
 Skills installed: bird, sherpa-onnx-tts

────────────────────────────────────────────────────

Configuration complete!

Next steps:
  1. Start Gateway:
     clawdbot gateway --daemon

  2. Test connection:
     clawdbot message send --to +1234567890 --message "Hello!"

  3. Manage configuration:
     clawdbot configure

Docs: https://docs.clawd.bot/start/onboarding
────────────────────────────────────────────────────

Контрольная точка ✅

После завершения работы мастера подтвердите следующее:

  • [ ] Файл конфигурации создан: ~/.clawdbot/clawdbot.json
  • [ ] Рабочая область инициализирована: директория ~/clawd/ существует
  • [ ] Учетные данные AI модели сохранены: проверьте ~/.clawdbot/credentials/
  • [ ] Каналы настроены: просмотрите узел channels в clawdbot.json
  • [ ] Навыки установлены (если выбрано): просмотрите узел skills в clawdbot.json

Команды проверки:

bash
## Просмотр сводки конфигурации
clawdbot doctor

## Просмотр статуса Gateway
clawdbot gateway status

## Просмотр доступных каналов
clawdbot channels list

Частые проблемы

Частая ошибка 1: Порт занят

Сообщение об ошибке:

Error: Port 18789 is already in use

Решение:

  1. Найдите занимающий процесс: lsof -i :18789 (macOS/Linux) или netstat -ano | findstr 18789 (Windows)
  2. Остановите конфликтующий процесс или используйте другой порт

Частая ошибка 2: Сбой OAuth процесса

Сообщение об ошибке:

Error: OAuth exchange failed

Возможные причины:

  • Проблемы с сетью, не удается получить доступ к серверам Anthropic
  • OAuth code устарел или неверный формат
  • Браузер заблокирован и не может открыться

Решение:

  1. Проверьте сетевое подключение
  2. Перезапустите clawdbot onboard для повторного OAuth
  3. Или используйте способ API Key

Частая ошибка 3: Сбой настройки канала

Сообщение об ошибке:

Error: WhatsApp authentication failed

Возможные причины:

  • QR код устарел
  • Аккаунт ограничен WhatsApp
  • Зависимости не установлены (например, signal-cli)

Решение:

  1. WhatsApp: повторно отсканируйте QR код
  2. Signal: убедитесь, что signal-cli установлен (см. документацию по каналу)
  3. Bot Token: убедитесь, что формат token верный и он не истек

Частая ошибка 4: Сбой настройки Tailscale

Сообщение об ошибке:

Error: Tailscale binary not found in PATH or /Applications.

Решение:

  1. Установите Tailscale: https://tailscale.com/download/mac
  2. Убедитесь, что добавлен в PATH или установлен в /Applications
  3. Или пропустите настройку Tailscale, настройте вручную позже

Частая ошибка 5: Ошибка формата файла конфигурации

Сообщение об ошибке:

Error: Invalid config at ~/.clawdbot/clawdbot.json

Решение:

bash
# Исправление конфигурации
clawdbot doctor

# Или сброс конфигурации
clawdbot onboard --mode reset

Краткое содержание урока

Пошаговая настройка — это рекомендуемый способ конфигурации Clawdbot, который проводит вас через все необходимые параметры с помощью интерактивных вопросов:

Ключевые моменты:

  • ✅ Поддержка двух режимов: QuickStart и Manual
  • ✅ Предупреждение безопасности напоминает о потенциальных рисках
  • ✅ Автоматическое обнаружение существующей конфигурации, можно сохранить/изменить/сбросить
  • ✅ Поддержка процесса Anthropic setup-token (рекомендуется) и способа API Key
  • ✅ Поддержка нескольких конфигураций через CLAWDBOT_PROFILE
  • ✅ Автоматическая настройка каналов и навыков
  • ✅ Генерация безопасных значений по умолчанию (привязка loopback, аутентификация token)

Рекомендуемый рабочий процесс:

  1. Первое использование: clawdbot onboard --install-daemon
  2. Изменение конфигурации: clawdbot configure
  3. Устранение неполадок: clawdbot doctor
  4. Удаленный доступ: настройка Tailscale Serve/Funnel

Следующие шаги:


Анонс следующего урока

В следующем уроке мы изучим Запуск Gateway.

Вы узнаете:

  • Как запустить демон Gateway
  • Разницу между режимами разработки и производства
  • Как мониторить статус Gateway
  • Использование launchd/systemd для автоматического запуска

Приложение: Справка по исходному коду

Нажмите, чтобы просмотреть расположение исходного кода

Обновлено: 2026-01-27

ФункцияПуть файлаНомера строк
Главный процесс мастераsrc/wizard/onboarding.ts87-452
Подтверждение предупреждения безопасностиsrc/wizard/onboarding.ts46-85
Настройка Gatewaysrc/wizard/onboarding.gateway-config.ts28-249
Определение интерфейса мастераsrc/wizard/prompts.ts36-52
Настройка каналовsrc/commands/onboard-channels.ts-
Настройка навыковsrc/commands/onboard-skills.ts-
Определение типов мастераsrc/wizard/onboarding.types.ts1-26
Schema конфигурацииsrc/config/zod-schema.ts-

Ключевые типы:

  • WizardFlow: "quickstart" | "advanced" - тип режима мастера
  • QuickstartGatewayDefaults: настройки Gateway по умолчанию для режима QuickStart
  • GatewayWizardSettings: настройки конфигурации Gateway
  • WizardPrompter: интерфейс интерактивного взаимодействия мастера

Ключевые функции:

  • runOnboardingWizard(): главный процесс мастера
  • configureGatewayForOnboarding(): настройка сети и аутентификации Gateway
  • requireRiskAcknowledgement(): отображение и подтверждение предупреждения безопасности

Значения по умолчанию (режим QuickStart):

  • Порт Gateway: 18789
  • Адрес привязки: loopback (127.0.0.1)
  • Метод аутентификации: token (автоматическая генерация случайного token)
  • Tailscale: off
  • Рабочая область: ~/clawd

Расположение файлов конфигурации:

  • Основная конфигурация: ~/.clawdbot/clawdbot.json
  • OAuth учетные данные: ~/.clawdbot/credentials/oauth.json
  • API Key учетные данные: ~/.clawdbot/credentials/
  • Данные сессий: ~/clawd/sessions.json