Быстрый старт: Установка, настройка и запуск Clawdbot

Что вы сможете сделать после изучения

Завершив это руководство, вы сможете:

✅ Установить Clawdbot на свое устройство
✅ Настроить аутентификацию AI моделей (Anthropic / OpenAI / другие провайдеры)
✅ Запустить демон Gateway
✅ Отправить первое сообщение через WebChat или настроенные каналы

Ваша текущая ситуация

Возможно, вы думаете:

"Локальный AI ассистент звучит сложно, с чего начать?"
"У меня много устройств (телефон, компьютер), как управлять ими централизованно?"
"Я привык к WhatsApp/Telegram/Slack, могу ли я общаться с AI через них?"

Хорошая новость: Clawdbot создан именно для решения этих проблем.

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

Когда вам нужно:

🚀 Первоначальная настройка персонального AI ассистента
🔧 Настройка множества каналов (WhatsApp, Telegram, Slack, Discord и др.)
🤖 Подключение AI моделей (Anthropic Claude, OpenAI GPT и др.)
📱 Кросс-платформенная синхронизация (узлы macOS, iOS, Android)

Почему рекомендуется режим Gateway?

Gateway — это плоскость управления Clawdbot, которая:

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

🎒 Подготовка к началу

Системные требования

Компонент	Требование
Node.js	≥ 22.12.0
Операционная система	macOS / Linux / Windows (WSL2)
Менеджер пакетов	npm / pnpm / bun

Внимание пользователям Windows

Настоятельно рекомендуется использовать WSL2 на Windows, потому что:

Многие каналы зависят от локальных бинарных файлов
Демоны (launchd/systemd) недоступны в Windows

Провайдер	Рекомендуемая модель	Причина
Anthropic	Claude Opus 4.5	Преимущество длинного контекста, повышенная устойчивость к prompt injection
OpenAI	GPT-5.2 + Codex	Сильные навыки программирования, поддержка мультимодальности

Основная концепция

Архитектура Clawdbot проста: один Gateway, множество каналов, один AI ассистент.

WhatsApp / Telegram / Slack / Discord / Signal / iMessage / WebChat
                │
                ▼
        ┌──────────────────┐
        │   Gateway       │  ← Плоскость управления (демон)
        │   127.0.0.1:18789 │
        └────────┬─────────┘
                 │
                 ├─→ AI Agent (pi-mono RPC)
                 ├─→ CLI (clawdbot ...)
                 ├─→ WebChat UI
                 └─→ Узлы macOS / iOS / Android

Ключевые понятия:

Понятие	Назначение
Gateway	Демон, отвечающий за управление сессиями, подключение каналов, вызов инструментов
Channel	Канал сообщений (WhatsApp, Telegram, Slack и др.)
Agent	Среда выполнения AI (режим RPC на основе pi-mono)
Node	Узел устройства (macOS/iOS/Android), выполняющий локальные операции на устройстве

Следуйте инструкциям

Шаг 1: Установка Clawdbot

Зачем После глобальной установки команда clawdbot будет доступна из любой директории.

Способ A: Использование npm (рекомендуется)

bash

npm install -g clawdbot@latest

Способ B: Использование pnpm

bash

pnpm add -g clawdbot@latest

Способ C: Использование bun

bash

bun install -g clawdbot@latest

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

added 1 package, and audited 1 package in 3s

Опция для разработчиков

Если вы планируете разрабатывать или вносить вклад из исходного кода, перейдите к Приложению: Сборка из исходного кода.

Шаг 2: Запуск мастера начальной настройки

Зачем Мастер проведет вас через все необходимые настройки: Gateway, каналы, навыки.

Запуск мастера (рекомендуется)

bash

clawdbot onboard --install-daemon

Что спросит мастер:

Шаг	Вопрос	Описание
1	Выбор способа аутентификации AI модели	OAuth / API Key
2	Настройка Gateway (порт, аутентификация)	По умолчанию: 127.0.0.1:18789
3	Настройка каналов (WhatsApp, Telegram и др.)	Можно пропустить, настроить позже
4	Настройка навыков (опционально)	Можно пропустить

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

✓ Gateway configured
✓ Workspace initialized: ~/clawd
✓ Channels configured
✓ Skills installed

To start the gateway, run:
  clawdbot gateway

Что такое Daemon?

--install-daemon устанавливает демон Gateway:

macOS: Служба launchd (уровень пользователя)
Linux: Пользовательская служба systemd

Таким образом, Gateway будет автоматически работать в фоновом режиме без необходимости ручного запуска.

Шаг 3: Запуск Gateway

Зачем Gateway — это плоскость управления Clawdbot, она должна быть запущена первой.

Запуск в foreground (для отладки)

bash

clawdbot gateway --port 18789 --verbose

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

[clawdbot] Gateway started
[clawdbot] Listening on ws://127.0.0.1:18789
[clawdbot] Ready to accept connections

Запуск в background (рекомендуется)

Если вы использовали --install-daemon в мастере, Gateway запустится автоматически.

Проверка статуса:

bash

clawdbot gateway status

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

Gateway is running
PID: 12345
Port: 18789

Часто используемые опции

--port 18789: Указать порт Gateway (по умолчанию 18789)
--verbose: Включить подробное логирование (полезно при отладке)
--reset: Перезапустить Gateway (очистить сессии)

Шаг 4: Отправка первого сообщения

Зачем Проверить успешность установки и протестировать ответ AI ассистента.

Способ A: Прямой диалог через CLI

bash

clawdbot agent --message "Ship checklist" --thinking high

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

[clawdbot] Agent is thinking...
[clawdbot] 🚢 Ship checklist:
1. Check Node.js version (≥ 22)
2. Install Clawdbot globally
3. Run onboarding wizard
4. Start Gateway
5. Send test message

Способ B: Отправка сообщения через канал

Если вы настроили каналы в мастере (например, WhatsApp, Telegram), вы можете напрямую отправлять сообщения вашему AI ассистенту в соответствующем приложении.

Пример WhatsApp:

Откройте WhatsApp
Найдите ваш номер Clawdbot
Отправьте сообщение: Hello, I'm testing Clawdbot!

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

AI ассистент ответит на ваше сообщение

Защита DM Pairing

По умолчанию Clawdbot включает защиту DM Pairing:

Неизвестные отправители получат код сопряжения
Сообщения не будут обрабатываться до вашего одобрения сопряжения

Подробнее: DM Pairing и контроль доступа

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

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

[ ] Выполнить clawdbot --version и увидеть номер версии
[ ] Выполнить clawdbot gateway status и увидеть запущенный Gateway
[ ] Отправить сообщение через CLI и получить ответ AI
[ ] (Опционально) Отправить сообщение в настроенном канале и получить ответ AI

Часто встречающиеся проблемы

В: Gateway не запускается? О: Проверьте, не занят ли порт:

bash

lsof -i :18789  # macOS/Linux
netstat -ano | findstr :18789  # Windows

В: AI не отвечает? О: Проверьте правильность настройки API Key:

bash

clawdbot models list

В: Как просмотреть подробные логи? О: Добавьте --verbose при запуске:

bash

clawdbot gateway --verbose

Предупреждения о подводных камнях

❌ Забыли установить Daemon

Неправильно:

bash

clawdbot onboard  # Забыли --install-daemon

Правильно:

bash

clawdbot onboard --install-daemon

Foreground vs Background

Foreground: Подходит для отладки, Gateway остановится при закрытии терминала
Background: Подходит для production, автоматически перезапускается

❌ Слишком старая версия Node.js

Неправильно:

bash

node --version
# v20.x.x  # Слишком старая

Правильно:

bash

node --version
# v22.12.0 или выше

❌ Неправильный путь к конфигурационному файлу

Расположение конфигурационного файла Clawdbot по умолчанию:

Операционная система	Путь к конфигурации
macOS/Linux	`~/.clawdbot/clawdbot.json`
Windows (WSL2)	`~/.clawdbot/clawdbot.json`

Если вы редактируете конфигурационный файл вручную, убедитесь в правильности пути.

Резюме урока

В этом уроке вы научились:

✅ Устанавливать Clawdbot: Глобальная установка через npm/pnpm/bun
✅ Запускать мастер: clawdbot onboard --install-daemon для завершения настройки
✅ Запускать Gateway: clawdbot gateway или автоматический запуск демона
✅ Отправлять сообщения: Общаться с AI через CLI или настроенные каналы

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

Изучите Мастер настройки, чтобы узнать больше о параметрах мастера
Ознакомьтесь с Запуском Gateway, изучите различные режимы запуска (dev/production)
Изучите Отправку первого сообщения, исследуйте больше форматов сообщений и способов взаимодействия

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

В следующем уроке мы изучим Мастер настройки.
Вы узнаете:
Как использовать интерактивный мастер для настройки Gateway
Как настроить множество каналов (WhatsApp, Telegram, Slack и др.)
Как управлять навыками и аутентификацией AI моделей

Приложение: Сборка из исходного кода

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

1. Клонирование репозитория

bash

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

2. Установка зависимостей

bash

pnpm install

3. Сборка UI (первый запуск)

bash

pnpm ui:build  # Автоматическая установка зависимостей UI

4. Сборка TypeScript

bash

pnpm build

5. Запуск onboarding

bash

pnpm clawdbot onboard --install-daemon

6. Цикл разработки (автоперезагрузка)

bash

pnpm gateway:watch  # Автоперезагрузка при изменении TS файлов

Режим разработки vs Режим production

pnpm clawdbot ...: Прямой запуск TypeScript (режим разработки)
После pnpm build: Генерация директории dist/ (режим production)

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

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

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

Функция	Путь к файлу	Номера строк
Вход CLI	`src/cli/run-main.ts`	26-60
Команда Onboarding	`src/cli/program/register.onboard.ts`	34-100
Установка Daemon	`src/cli/daemon-cli/install.ts`	15-100
Служба Gateway	`src/daemon/service.ts`	Весь файл
Проверка среды выполнения	`src/infra/runtime-guard.ts`	Весь файл

Ключевые константы:

DEFAULT_GATEWAY_DAEMON_RUNTIME = "node": Среда выполнения демона по умолчанию (из src/commands/daemon-runtime.ts)
DEFAULT_GATEWAY_PORT = 18789: Порт Gateway по умолчанию (из конфигурации)

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

runCli(): Главный вход CLI, обработка парсинга аргументов и маршрутизации команд (src/cli/run-main.ts)
runDaemonInstall(): Установка демона Gateway (src/cli/daemon-cli/install.ts)
onboardCommand(): Команда интерактивного мастера (src/commands/onboard.ts)

Быстрый старт: Установка, настройка и запуск Clawdbot ​

Что вы сможете сделать после изучения ​

Ваша текущая ситуация ​

Когда использовать этот подход ​

🎒 Подготовка к началу ​

Системные требования ​

Рекомендуемые AI модели ​

Основная концепция ​

Следуйте инструкциям ​

Шаг 1: Установка Clawdbot ​

Способ A: Использование npm (рекомендуется) ​

Способ B: Использование pnpm ​

Способ C: Использование bun ​

Шаг 2: Запуск мастера начальной настройки ​

Запуск мастера (рекомендуется) ​

Шаг 3: Запуск Gateway ​

Запуск в foreground (для отладки) ​

Запуск в background (рекомендуется) ​

Шаг 4: Отправка первого сообщения ​

Способ A: Прямой диалог через CLI ​

Способ B: Отправка сообщения через канал ​

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

Предупреждения о подводных камнях ​

❌ Забыли установить Daemon ​

❌ Слишком старая версия Node.js ​

❌ Неправильный путь к конфигурационному файлу ​

Резюме урока ​

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

Приложение: Сборка из исходного кода ​

1. Клонирование репозитория ​

2. Установка зависимостей ​

3. Сборка UI (первый запуск) ​

4. Сборка TypeScript ​

5. Запуск onboarding ​

6. Цикл разработки (автоперезагрузка) ​

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

Быстрый старт: Установка, настройка и запуск Clawdbot

Что вы сможете сделать после изучения

Ваша текущая ситуация

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

🎒 Подготовка к началу

Системные требования

Рекомендуемые AI модели

Основная концепция

Следуйте инструкциям

Шаг 1: Установка Clawdbot

Способ A: Использование npm (рекомендуется)

Способ B: Использование pnpm

Способ C: Использование bun

Шаг 2: Запуск мастера начальной настройки

Запуск мастера (рекомендуется)

Шаг 3: Запуск Gateway

Запуск в foreground (для отладки)

Запуск в background (рекомендуется)

Шаг 4: Отправка первого сообщения

Способ A: Прямой диалог через CLI

Способ B: Отправка сообщения через канал

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

Предупреждения о подводных камнях

❌ Забыли установить Daemon

❌ Слишком старая версия Node.js

❌ Неправильный путь к конфигурационному файлу

Резюме урока

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

Приложение: Сборка из исходного кода

1. Клонирование репозитория

2. Установка зависимостей

3. Сборка UI (первый запуск)

4. Сборка TypeScript

5. Запуск onboarding

6. Цикл разработки (автоперезагрузка)

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