Создание персонального ассистента

Обзор

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

Соображения безопасности

Clawdbot может выполнять команды, получать доступ к файлам и отправлять сообщения. Важные меры безопасности:

• Настройте channels.whatsapp.allowFrom для ограничения доступа
• Используйте выделенный номер телефона для ассистента
• Начните с отключенных heartbeat ("0m") до установления доверия
• Проверьте разрешения перед предоставлением доступа к shell

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

• Node.js 22+
• Глобально установленный Clawdbot
• Второй номер телефона для ассистента (рекомендуется)

Рекомендуемая архитектура

Используйте два телефона для наиболее безопасной настройки:

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Ваш телефон    │────▶│  Ассистент      │────▶│  Ваш компьютер  │
│  (Личный)       │     │  Номер телефона │     │  (Clawdbot)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Ваше личное устройство отправляет сообщения на второй телефон (ассистент), который связан с Clawdbot, работающим на вашем компьютере.

Быстрый старт

1. Подключение WhatsApp Web

clawdbot channels login whatsapp

Отсканируйте QR-код телефоном ассистента.

2. Запуск шлюза

clawdbot gateway --port 18789

3. Настройка списка разрешённых

Отредактируйте ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"],
      "dmPolicy": "allowlist"
    }
  }
}

Рабочее пространство и память

Рабочее пространство по умолчанию

Расположение: ~/.clawdbot/workspace

Содержит файлы инструкций:

Контроль версий

Относитесь к рабочему пространству как к git-репозиторию для резервного копирования:

cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"

Сессии

Сессии хранятся для каждого отправителя. Команды управления сессиями:

Heartbeats (Проактивные задачи)

Heartbeats — это периодические проверки, при которых агент читает HEARTBEAT.md для получения задач.

Конфигурация

В ~/.clawdbot/clawdbot.json:

{
  "heartbeat": {
    "interval": "30m",
    "enabled": true
  }
}

Поведение

• По умолчанию: каждые 30 минут
• Агент читает HEARTBEAT.md для ожидающих задач
• Отвечает HEARTBEAT_OK, если ничего не требует внимания
• Установите "0m" для отключения

Пример HEARTBEAT.md

# Задачи Heartbeat

- Проверить новые письма и составить сводку важных
- Просмотреть календарь на предмет предстоящих встреч
- Отслеживать цены акций AAPL, GOOGL

Обработка медиа

Входящие вложения

Clawdbot может получать и обрабатывать:

• Изображения
• Документы
• Голосовые сообщения
• Видео

Исходящие медиа

Отправляйте медиа с помощью синтаксиса MEDIA:<путь>:

MEDIA:/path/to/image.png

Операции

Команды статуса

# Проверить работоспособность
clawdbot health

# Просмотреть статус
clawdbot status

# Проверить логи
tail -f /tmp/clawdbot/gateway.log

Логирование

Логи хранятся в /tmp/clawdbot/:

Многоканальная настройка

Настройте несколько каналов в clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+1234567890"]
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

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

• Сопряжение - Настройка контроля доступа
• Витрина - Посмотрите, что создали другие
• Навыки - Расширение с помощью плагинов