Start

Мастер настройки (CLI)

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

Обзор

Мастер настройки — рекомендуемый метод настройки Clawdbot на macOS, Linux или Windows (через WSL2). Он предоставляет пошаговый процесс конфигурации для локальных или удалённых подключений шлюза, каналов, навыков и параметров рабочего пространства.

Основные команды

КомандаОписание
clawdbot onboardОсновной мастер настройки
clawdbot dashboardОткрывает UI для чата в браузере
clawdbot configureПеренастроить существующую установку
clawdbot configure --section webНастроить веб-поиск (Brave Search API)

Режимы настройки

Быстрый старт (Рекомендуется)

Конфигурация по умолчанию для большинства пользователей:

  • Локальный шлюз на loopback
  • Порт 18789 с токен-аутентификацией
  • ЛС Telegram/WhatsApp используют режим allowlist

Расширенный режим

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

Процесс конфигурации

1. Обнаружение существующей конфигурации

Мастер обнаруживает ~/.clawdbot/clawdbot.json и предлагает:

  • Сохранить - Использовать существующую конфигурацию
  • Изменить - Обновить конкретные настройки
  • Сбросить - Начать заново

2. Модель и аутентификация

Выберите вашего ИИ-провайдера:

ПровайдерОписание
Anthropic API KeyРекомендуется для лучшей производительности
Anthropic OAuthДля подписчиков Claude Pro/Max
OpenAI API KeyGPT-4 и другие модели
OpenAI CodexПодписка для работы с кодом
Vercel AI GatewayПрокси-вариант
Локальные моделиАвтономная работа

3. Настройка рабочего пространства

Рабочее пространство по умолчанию: ~/.clawdbot/workspace

Создаваемые файлы инициализации:

  • AGENTS.md - Конфигурация агента
  • SOUL.md - Настройки личности
  • TOOLS.md - Доступные инструменты
  • IDENTITY.md - Информация об идентичности

4. Конфигурация шлюза

Настройте параметры вашего шлюза:

  • Порт: По умолчанию 18789
  • Адрес привязки: Loopback или сеть
  • Режим аутентификации: На основе токена (рекомендуется)
  • Tailscale: Опциональный удалённый доступ

5. Настройка каналов

Опциональные интеграции:

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • Signal
  • iMessage
  • Google Chat
  • Mattermost

6. Установка демона

  • macOS: LaunchAgent
  • Linux/WSL2: пользовательский юнит systemd

7. Проверка работоспособности

Валидация запуска шлюза и подключения.

8. Установка навыков

Опциональные пакеты навыков через npm/pnpm.

Удалённый режим

Подключение к существующему шлюзу, работающему в другом месте:

clawdbot onboard --remote

На удалённом хосте никакие установки не выполняются — настраивается только подключение локального клиента.

Неинтерактивный режим

Для автоматизации и скриптов:

clawdbot onboard --non-interactive \
  --auth-choice anthropic \
  --anthropic-api-key $ANTHROPIC_API_KEY

Несколько агентов

Создание изолированных экземпляров агентов:

clawdbot agents add work
clawdbot agents add personal
clawdbot agents list

Каждый агент имеет собственное рабочее пространство и конфигурацию.

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