Интеграция Clawdbot с Discord

Обзор интеграции Clawdbot с Discord

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

Почему стоит использовать Clawdbot с Discord?

Discord — ведущая платформа для игр и общения в сообществах. Интеграция Clawdbot с Discord предлагает:

Быстрая настройка (для начинающих)

1. Создайте бота Discord и скопируйте токен бота
2. В настройках приложения Discord включите Message Content Intent (и Server Members Intent при необходимости)
3. Установите токен через env (DISCORD_BOT_TOKEN=...) или config (channels.discord.token)
4. Пригласите бота на ваш сервер с правами на сообщения
5. Запустите шлюз
6. Доступ через ЛС по умолчанию требует сопряжения; подтвердите код сопряжения при первом контакте

Минимальная конфигурация:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Настройка Clawdbot Discord

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

Перед подключением Clawdbot к Discord убедитесь, что у вас есть:

• Clawdbot установлен на вашем устройстве
• Аккаунт Discord
• Доступ к порталу разработчиков Discord
• Права администратора сервера

Шаг 1: Создание приложения Discord

Настройте ваше приложение Clawdbot Discord:

1. Перейдите на портал разработчиков Discord
2. Нажмите "New Application"
3. В вашем приложении: Bot → Add Bot
4. Скопируйте токен бота

Шаг 2: Включение Gateway Intents

Включите intents, необходимые для Clawdbot:

• Message Content Intent — требуется для чтения содержимого сообщений
• Server Members Intent — требуется для белых списков или поиска имён

Шаг 3: Генерация URL приглашения

Используйте генератор OAuth2 URL на портале разработчиков:

Необходимые разрешения для Clawdbot Discord:

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

Шаг 4: Настройка Clawdbot Discord

Добавьте вашего Discord бота в Clawdbot:

Переменная окружения:

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

Файл конфигурации (~/.clawdbot/clawdbot.json):

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Если установлены и env, и config, приоритет имеет config.

Шаг 5: Запуск шлюза

clawdbot gateway --port 18789

Discord запускается автоматически, когда доступен токен и channels.discord.enabled не равен false.

Шаг 6: Проверка подключения

Проверьте статус вашего Clawdbot Discord:

clawdbot channels status discord

Как это работает

• Личные чаты объединяются в основную сессию агента (по умолчанию agent:main:main)
• Каналы гильдий остаются изолированными как agent:<agentId>:discord:channel:<channelId>
• Групповые ЛС игнорируются по умолчанию; включите через channels.discord.dm.groupEnabled
• Маршрутизация детерминирована: ответы всегда возвращаются в канал, откуда пришло сообщение

Функции Clawdbot Discord

Управление доступом к ЛС

Личные чаты безопасны по умолчанию через channels.discord.dm.policy:

Пример (строгий белый список):

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

Настройка каналов гильдии

Установите правила для каждой гильдии или канала:

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

Slash-команды

Clawdbot Discord поддерживает нативные slash-команды:

Нативные команды по умолчанию "auto" (включены для Discord/Telegram). Переопределите с помощью:

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

История контекста гильдии

Установите channels.discord.historyLimit (по умолчанию 20), чтобы включить последние N сообщений гильдии как контекст при ответе на упоминание. Установите 0 для отключения.

Реакции

Агент может вызывать реакции через инструмент discord (контролируется channels.discord.actions.*).

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

Полный пример конфигурации

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

Запись конфигурации

По умолчанию Discord может записывать обновления конфигурации, вызванные /config set|unset. Отключите с помощью:

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

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

Clawdbot безопасно хранит учётные данные Discord:

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

Ваши данные Clawdbot Discord остаются на вашей локальной машине.

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

Бот не в сети

Если Clawdbot Discord отображается как не в сети:

1. Проверьте токен: clawdbot channels verify discord
2. Проверьте подключение шлюза
3. Просмотрите логи: cat /tmp/clawdbot/discord.log

Slash-команды не работают

Если slash-команды Clawdbot Discord не работают:

1. Перерегистрируйте команды через конфигурацию
2. Проверьте права бота
3. Проверьте регистрацию команд для конкретного сервера

Ошибки разрешений

Если Clawdbot Discord не хватает разрешений:

1. Проверьте позицию роли бота в настройках сервера
2. Проверьте разрешения для конкретного канала
3. Пригласите повторно с правильными разрешениями

Разрешение имён

Разрешение имя → id использует поиск участников гильдии и требует Server Members Intent. Если бот не может искать участников, используйте id или упоминания <@id>.

Лучшие практики Clawdbot Discord

1. Используйте режим сопряжения: Безопасно по умолчанию с кодами сопряжения для ЛС
2. Установите ограничения каналов: Ограничьте Clawdbot Discord соответствующими каналами
3. Настройте роли: Используйте доступ на основе ролей для Clawdbot Discord
4. Мониторьте активность: Регулярно просматривайте логи Clawdbot Discord
5. Используйте slash-команды: Лучший UX, чем текстовые команды

Примеры использования Clawdbot Discord

Поддержка сообщества

Разверните Clawdbot Discord как бота поддержки:

• Автоматически отвечайте на FAQ
• Эскалируйте сложные вопросы
• Обеспечивайте помощь 24/7

Игровые сообщества

Используйте Clawdbot Discord для игровых серверов:

• Поиск информации об играх
• Координация команд
• Планирование событий

Сообщества разработчиков

Clawdbot Discord для серверов разработчиков:

• Помощь с кодом
• Поиск документации
• Сортировка багов

Дальнейшие шаги

• Интеграция Clawdbot с WhatsApp - Подключите Clawdbot к WhatsApp
• Интеграция Clawdbot с Telegram - Настройте Clawdbot в Telegram
• Руководство по настройке Clawdbot - Полное руководство по установке