Справка по настройке OpenClaw QQ

Документ OpenClaw QQ
1

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

Справочник по конфигурации (версия с группировкой)

Цель: сначала понять «что обязательно настроить», затем посмотреть «что включать по необходимости».

A. Обязательные параметры

  • wsUrl: адрес OneBot WebSocket.
  • accessToken: токен доступа OneBot (если включена аутентификация).

B. Базовые триггеры и контроль доступа

  • requireMention: порог срабатывания в групповых чатах (@ / ответ / ключевое слово).
  • keywordOnlyTrigger: принимать ли в групповых чатах только триггеры по ключевым словам (игнорируя @ / ответы).
  • admins: список QQ-аккаунтов администраторов.
  • adminOnlyChat: чат могут запускать только администраторы.
  • allowedGroups: белый список групп.
  • blockedUsers: чёрный список пользователей.

C. Стабильность и отказоустойчивость

  • maxRetries: число автоматических повторов после ошибки (по умолчанию 0, выключено).
  • retryDelayMs: интервал между повторами (действует только при maxRetries > 0).
  • fastFailErrors: при совпадении — быстрое переключение модели/пропуск ожидания (по умолчанию пустой массив, выключено).
  • enableEmptyReplyFallback: запасной вариант при пустом ответе.
  • emptyReplyFallbackText: текст запасного ответа при пустом ответе.

D. Параллельность и прерывание

  • queueDebounceMs: окно антидребезга/объединения сообщений в рамках одной сессии (по умолчанию 0, выключено).
  • interruptOnNewMessage: прерывать ли старый ответ новым сообщением (по умолчанию выключено).

E. Усиление контекста

  • historyLimit: количество внедряемых строк истории группы (рекомендуется по умолчанию 0).
  • enrichReplyForwardContext: рекурсивно ли разбирать reply/forward.
  • maxReplyLayers / maxForwardLayers: верхний предел глубины рекурсии.
  • maxTotalContextChars: верхний предел бюджета символов для внедрения.

F. Вывод и анти-риск (Risk Control)

  • maxMessageLength: максимальная длина одного сообщения.
  • rateLimitMs: интервал между отправкой частей.
  • formatMarkdown: преобразование Markdown в обычный текст.
  • antiRiskMode: режим обхода (смягчения) risk-control.
  • showReplySessionSource: добавлять к ответу метку сессии-источника (очень полезно в сценариях временных сессий).
  • forwardLongReplyThreshold: порог для автоматического объединения длинных ответов в пересланное сообщение.

G. Мультимедиа и каналы

  • enableTTS: переключатель голосовых ответов.
  • enableGuilds: поддержка сообщений QQ-каналов.
  • sharedMediaHostDir / sharedMediaContainerDir: пути общего доступа к медиа (часто используется при развёртывании в контейнере).

Рекомендуемая минимальная production-конфигурация

{
  "channels": {
    "qq": {
      "wsUrl": "ws://127.0.0.1:3001",
      "accessToken": "your_token",
      "requireMention": true,
      "admins": "10000001",
      "adminOnlyChat": true,
      "allowedGroups": "20000001",
      "rateLimitMs": 1000,
      "maxRetries": 0,
      "retryDelayMs": 3000,
      "fastFailErrors": [],
      "queueDebounceMs": 0,
      "injectGatewayMeta": false,
      "interruptOnNewMessage": false
    }
  }
}

Дальнейшее чтение

OpenClaw QQ 高级能力与完整参数
OpenClaw QQ 项目概览
OpenClaw QQ 文档中心
OpenClaw QQ 3 分钟快速开始