Пошаговая настройка: Полная конфигурация 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: Запуск мастера
Откройте терминал и выполните следующую команду:
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: Выбор режима конфигурации
Рекомендуется для новичков, использует безопасные значения по умолчанию:
- Порт Gateway: 18789
- Адрес привязки: Loopback (127.0.0.1)
- Метод аутентификации: Token (автоматическая генерация)
- Tailscale: выключенДля продвинутых пользователей, ручная настройка всех параметров:
- Настраиваемый порт и привязку 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:
Gateway работает на текущей машине:
- Может выполнять OAuth процесс и записывать локальные учетные данные
- Мастер завершит всю конфигурацию
- Подходит для локальной разработки или развертывания на одной машинеGateway работает на другой машине:
- Мастер настраивает только удаленный URL и аутентификацию
- OAuth процесс не выполняется, учетные данные нужно настроить вручную на удаленном хосте
- Подходит для сценариев развертывания на нескольких машинахПочему Режим Local поддерживает полный процесс настройки, режим Remote настраивает только информацию для доступа.
Действия:
- Выберите режим развертывания
- Если режим Remote, введите URL и token удаленного Gateway
Шаг 5: Настройка Gateway (только режим Manual)
Если выбран режим Manual, мастер будет пошагово запрашивать настройки Gateway:
Порт Gateway
? Gateway port (18789)Описание:
- Значение по умолчанию 18789
- Если порт занят, введите другой порт
- Убедитесь, что порт не заблокирован брандмауэром
Адрес привязки Gateway
? 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
? Gateway auth
Token Recommended default (local + remote)
PasswordОписание параметров:
- Token: рекомендуемый параметр, автоматическая генерация случайного token, поддержка удаленного доступа
- Password: использование пользовательского пароля, обязательно для режима Tailscale Funnel
Удаленный доступ Tailscale (опционально)
? 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: Настройка рабочей области
Мастер запросит директорию рабочей области:
? 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) |
Пример:
# Использование work profile
export CLAWDBOT_PROFILE=work
clawdbot onboardВы должны увидеть:
Ensuring workspace directory: /Users/ваше_имя_пользователя/clawd
Creating sessions.json...
Creating agents directory...Шаг 7: Настройка аутентификации AI модели
Мастер выведет список поддерживаемых провайдеров AI моделей:
? 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-tokenapiKey: ручной ввод Anthropic API Key
Способ Anthropic setup-token (рекомендуется)
Рекомендуется использовать способ setup-token, причины:
- Нет необходимости управлять API Key вручную
- Генерация долгосрочного токена
- Подходит для пользователей с подпиской Pro/Max
Процесс:
- Сначала выполните в другом терминале:
claude setup-token - Эта команда откроет браузер для OAuth авторизации
- Скопируйте сгенерированный setup-token
- В мастере выберите
Anthropic→token - Вставьте setup-token в мастер
- Учетные данные автоматически сохранятся в директории
~/.clawdbot/credentials/
Способ API Key
Если выбран API Key:
- Мастер предложит ввести API Key
- Учетные данные сохранятся в директории
~/.clawdbot/credentials/ - Поддержка нескольких провайдеров, можно переключаться в любое время
Пример:
? Enter API Key
sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxШаг 8: Выбор модели по умолчанию
После успешной аутентификации мастер отобразит список доступных моделей:
? 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: Настройка каналов коммуникации
Мастер выведет список всех доступных плагинов каналов коммуникации:
? 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
? Configure WhatsApp
Link new account Open QR code in browser
SkipДействия:
- Выберите
Link new account - Мастер отобразит QR код
- Используйте WhatsApp для сканирования QR кода и входа
- После успешного входа данные сессии сохранятся в
~/.clawdbot/credentials/
Настройка Telegram
? Configure Telegram
Bot Token
SkipДействия:
- Выберите
Bot Token - Введите Bot Token, полученный от @BotFather
- Мастер проверит успешность подключения
Получение Bot Token
- В Telegram найдите @BotFather
- Отправьте
/newbotдля создания нового бота - Следуйте инструкциям для установки имени и имени пользователя бота
- Скопируйте сгенерированный Bot Token
Настройка Slack
? 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
- Посетите https://api.slack.com/apps
- Создайте новое App
- На странице Basic Information получите Signing Secret
- На странице OAuth & Permissions установите App в Workspace
- Получите Bot Token и App Token
Шаг 10: Настройка навыков (опционально)
Мастер спросит, хотите ли вы установить навыки:
? Install skills? (Y/n)Рекомендации:
- Выберите
Yдля установки рекомендуемых навыков (например, пакетный менеджер bird, локальный TTS sherpa-onnx-tts) - Выберите
nдля пропуска, в дальнейшем можно управлять через командуclawdbot skills
Если выбрана установка, мастер выведет список доступных навыков:
? Select skills to install
✓ bird macOS Homebrew пакетная установка
✓ sherpa-onnx-tts Локальный TTS движок (приоритет конфиденциальности)
(Press Space to select, Enter to confirm)Шаг 11: Завершение настройки
Мастер подведет итог всей конфигурации и запишет в файл конфигурации:
✓ 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
Команды проверки:
## Просмотр сводки конфигурации
clawdbot doctor
## Просмотр статуса Gateway
clawdbot gateway status
## Просмотр доступных каналов
clawdbot channels listЧастые проблемы
Частая ошибка 1: Порт занят
Сообщение об ошибке:
Error: Port 18789 is already in useРешение:
- Найдите занимающий процесс:
lsof -i :18789(macOS/Linux) илиnetstat -ano | findstr 18789(Windows) - Остановите конфликтующий процесс или используйте другой порт
Частая ошибка 2: Сбой OAuth процесса
Сообщение об ошибке:
Error: OAuth exchange failedВозможные причины:
- Проблемы с сетью, не удается получить доступ к серверам Anthropic
- OAuth code устарел или неверный формат
- Браузер заблокирован и не может открыться
Решение:
- Проверьте сетевое подключение
- Перезапустите
clawdbot onboardдля повторного OAuth - Или используйте способ API Key
Частая ошибка 3: Сбой настройки канала
Сообщение об ошибке:
Error: WhatsApp authentication failedВозможные причины:
- QR код устарел
- Аккаунт ограничен WhatsApp
- Зависимости не установлены (например, signal-cli)
Решение:
- WhatsApp: повторно отсканируйте QR код
- Signal: убедитесь, что signal-cli установлен (см. документацию по каналу)
- Bot Token: убедитесь, что формат token верный и он не истек
Частая ошибка 4: Сбой настройки Tailscale
Сообщение об ошибке:
Error: Tailscale binary not found in PATH or /Applications.Решение:
- Установите Tailscale: https://tailscale.com/download/mac
- Убедитесь, что добавлен в PATH или установлен в
/Applications - Или пропустите настройку Tailscale, настройте вручную позже
Частая ошибка 5: Ошибка формата файла конфигурации
Сообщение об ошибке:
Error: Invalid config at ~/.clawdbot/clawdbot.jsonРешение:
# Исправление конфигурации
clawdbot doctor
# Или сброс конфигурации
clawdbot onboard --mode resetКраткое содержание урока
Пошаговая настройка — это рекомендуемый способ конфигурации Clawdbot, который проводит вас через все необходимые параметры с помощью интерактивных вопросов:
Ключевые моменты:
- ✅ Поддержка двух режимов: QuickStart и Manual
- ✅ Предупреждение безопасности напоминает о потенциальных рисках
- ✅ Автоматическое обнаружение существующей конфигурации, можно сохранить/изменить/сбросить
- ✅ Поддержка процесса Anthropic setup-token (рекомендуется) и способа API Key
- ✅ Поддержка нескольких конфигураций через CLAWDBOT_PROFILE
- ✅ Автоматическая настройка каналов и навыков
- ✅ Генерация безопасных значений по умолчанию (привязка loopback, аутентификация token)
Рекомендуемый рабочий процесс:
- Первое использование:
clawdbot onboard --install-daemon - Изменение конфигурации:
clawdbot configure - Устранение неполадок:
clawdbot doctor - Удаленный доступ: настройка Tailscale Serve/Funnel
Следующие шаги:
- Запуск Gateway: запуск Gateway в фоновом режиме
- Отправка первого сообщения: начало диалога с AI ассистентом
- Общие сведения о DM сопряжении: контроль безопасности незнакомых отправителей
Анонс следующего урока
В следующем уроке мы изучим Запуск Gateway.
Вы узнаете:
- Как запустить демон Gateway
- Разницу между режимами разработки и производства
- Как мониторить статус Gateway
- Использование launchd/systemd для автоматического запуска
Приложение: Справка по исходному коду
Нажмите, чтобы просмотреть расположение исходного кода
Обновлено: 2026-01-27
| Функция | Путь файла | Номера строк |
|---|---|---|
| Главный процесс мастера | src/wizard/onboarding.ts | 87-452 |
| Подтверждение предупреждения безопасности | src/wizard/onboarding.ts | 46-85 |
| Настройка Gateway | src/wizard/onboarding.gateway-config.ts | 28-249 |
| Определение интерфейса мастера | src/wizard/prompts.ts | 36-52 |
| Настройка каналов | src/commands/onboard-channels.ts | - |
| Настройка навыков | src/commands/onboard-skills.ts | - |
| Определение типов мастера | src/wizard/onboarding.types.ts | 1-26 |
| Schema конфигурации | src/config/zod-schema.ts | - |
Ключевые типы:
WizardFlow:"quickstart" | "advanced"- тип режима мастераQuickstartGatewayDefaults: настройки Gateway по умолчанию для режима QuickStartGatewayWizardSettings: настройки конфигурации GatewayWizardPrompter: интерфейс интерактивного взаимодействия мастера
Ключевые функции:
runOnboardingWizard(): главный процесс мастераconfigureGatewayForOnboarding(): настройка сети и аутентификации GatewayrequireRiskAcknowledgement(): отображение и подтверждение предупреждения безопасности
Значения по умолчанию (режим 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