Руководство по настройке

Места хранения

Clawdbot разделяет конфигурацию и установку:

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

Предварительные требования

• Node.js >= 22
• pnpm (рекомендуется) или npm
• Docker (опционально, для контейнерной настройки)

Методы установки

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

curl -fsSL https://clawd.bot/install.sh | bash

Через npm

npm i -g clawdbot
clawdbot setup

Через pnpm

pnpm add -g clawdbot
clawdbot setup

Рабочие процессы

Стабильный рабочий процесс (приложение macOS)

Для большинства пользователей приложение macOS обеспечивает наиболее простой опыт:

1. Установка - Скачайте и запустите Clawdbot.app
2. Настройка - Завершите мастер настройки
3. Разрешения - Предоставьте необходимый доступ к системе
4. Режим шлюза - Убедитесь, что шлюз в локальном режиме
5. Каналы - Подключите каналы связи (WhatsApp, Telegram и т.д.)
6. Проверка - Запустите clawdbot health для подтверждения настройки

Рабочий процесс разработки

Для участников и опытных пользователей:

# Клонировать репозиторий
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Установить зависимости
pnpm install

# Запустить шлюз разработки с горячей перезагрузкой
pnpm gateway:watch

Настройте приложение macOS в режим локального подключения. Приложение подключается к работающему шлюзу на настроенном порту (по умолчанию: ws://127.0.0.1:18789).

Хранение учётных данных

Примечания по платформам

macOS

Приложение автоматически управляет шлюзом через LaunchAgent.

Linux

Использует пользовательский сервис systemd. Включите lingering для предотвращения остановки сервиса при выходе из системы:

sudo loginctl enable-linger $USER

Windows (WSL2)

Запускайте Clawdbot внутри WSL2 с дистрибутивом Linux. Настройка идентична Linux.

Стратегия обновления

Храните личное содержимое в директориях ~/.clawdbot/ отдельно от установки:

# Обновление через npm
npm update -g clawdbot

# Или получение последнего исходного кода
cd clawdbot
git pull
pnpm install

Ваше рабочее пространство и конфигурация остаются нетронутыми при обновлениях.

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

Проверьте вашу установку:

clawdbot health

Ожидаемый вывод:

• Статус шлюза: Работает
• Порт: 18789
• Каналы: Подключены
• Агент: Готов

Устранение неполадок

Шлюз не запускается

1. Проверьте, используется ли порт 18789: lsof -i :18789
2. Просмотрите логи: cat /tmp/clawdbot/gateway.log
3. Сбросить конфигурацию: clawdbot configure --reset

Проблемы подключения каналов

1. Повторная аутентификация: clawdbot channels login
2. Проверить учётные данные: ls ~/.clawdbot/credentials/
3. Проверить allowlist: Посмотреть clawdbot.json

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

• Мастер настройки - Пошаговая настройка
• Сопряжение - Контроль доступа
• Персональный ассистент - Создайте своего ассистента