OpenClaw QQ: быстрый старт за 3 минуты

[AIYA.DE5.NET]

Источник: репозиторий constansino/openclaw_qq, файл docs/quickstart.md
Оригинал: openclaw_qq/docs/quickstart.md at main · constansino/openclaw_qq · GitHub
Эта версия синхронизирована с форумом для удобства поиска, обсуждения и непрерывного сопровождения.

Быстрый старт за 3 минуты

1. Предварительные условия

• OpenClaw установлен и запущен.
• Запущен сервер OneBot v11 (рекомендуются NapCat или Lagrange).
• В конфигурации OneBot параметр message_post_format должен быть array.

2. Установка плагина

cd openclaw/extensions
git clone https://github.com/constansino/openclaw_qq.git qq
cd ../..
pnpm install && pnpm build

Если у вас глобальная установка OpenClaw (npm install -g openclaw) и вы обновляете только каталог расширений, обычно достаточно выполнить npm install в ~/.openclaw/extensions/qq, затем openclaw gateway restart.

3. Приоритетно используйте настройку через WebUI (рекомендуется)

Настройте channels.qq напрямую в OpenClaw WebUI — обычно это быстрее и стабильнее, чем вручную писать JSON.

Рекомендуется сначала заполнить:

• wsUrl
• accessToken
• requireMention
• admins（необязательно）
• allowedGroups（необязательно）

4. Ручная JSON-настройка (необязательно)

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

{
  "channels": {
    "qq": {
      "wsUrl": "ws://127.0.0.1:3001",
      "accessToken": "your_token",
      "requireMention": true
    }
  },
  "plugins": {
    "entries": {
      "qq": { "enabled": true }
    }
  }
}

5. Проверка запуска

openclaw gateway restart

Проверки:

• Напишите боту в личные сообщения — отвечает ли он нормально.
• В группе упомяните бота через @ — отвечает ли он нормально.
• В логах нет постоянных переподключений/ошибок аутентификации.

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

• Нужен контроль администраторов/чёрно-белые списки: см. Справочник по конфигурации.
• Нужен контейнерный деплой: см. Инструкцию по развёртыванию NapCat。