Bot QQ

​

Instalacja

openclaw plugins install @openclaw/qqbot

​

Konfiguracja początkowa

1. Przejdź do QQ Open Platform i zeskanuj kod QR za pomocą aplikacji QQ na telefonie, aby się zarejestrować / zalogować.
2. Kliknij Create Bot, aby utworzyć nowego bota QQ.
3. Znajdź AppID i AppSecret na stronie ustawień bota i skopiuj je.

4. Dodaj kanał:

openclaw channels add --channel qqbot --token "AppID:AppSecret"

5. Uruchom ponownie Gateway.

openclaw channels add

​

Konfiguracja

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecret: "YOUR_APP_SECRET",
    },
  },
}

• QQBOT_APP_ID
• QQBOT_CLIENT_SECRET

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecretFile: "/path/to/qqbot-secret.txt",
    },
  },
}

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "YOUR_APP_ID",
      clientSecret: { source: "env", provider: "default", id: "QQBOT_CLIENT_SECRET" },
    },
  },
}

• openclaw channels add --channel qqbot --token-file ... ustawia tylko AppSecret; appId musi już być ustawione w konfiguracji lub QQBOT_APP_ID.
• clientSecret przyjmuje ciąg zwykłego tekstu, ścieżkę pliku (clientSecretFile) albo ustrukturyzowany obiekt SecretRef.
• Starsze ciągi znaczników secretref:... / secretref-env:... są odrzucane dla clientSecret; zamiast nich należy użyć ustrukturyzowanego obiektu SecretRef.

​

Strumieniowanie

{
  channels: {
    qqbot: {
      streaming: {
        mode: "partial", // strumieniowanie bloków: "partial" (domyślnie) lub "off"
        nativeTransport: true, // użyj oficjalnego API stream_messages QQ dla wiadomości prywatnych C2C
      },
    },
  },
}

• streaming.mode: "off" wyłącza strumieniowanie bloków dla konta.
• streaming.nativeTransport: true przesyła odpowiedzi C2C (wiadomości prywatne) strumieniowo przez oficjalne API stream_messages QQ; nie wpływa to na cele grupowe/kanałowe.
• Starsze wartości skalarne streaming: true|false i klucz streaming.c2cStreamApi są migrowane do tej struktury za pomocą openclaw doctor --fix.
• /bot-streaming on|off przełącza tę samą konfigurację z poziomu wiadomości prywatnej.

​

Zasady dostępu

• allowFrom / groupAllowFrom określają, kto może rozmawiać z botem w kontekście C2C / grupy. dmPolicy / groupPolicy (open | allowlist | disabled) sterują trybem egzekwowania. dmPolicy ma domyślnie wartość allowlist, gdy allowFrom zawiera konkretny wpis (bez symbolu wieloznacznego), a w przeciwnym razie open. groupPolicy ma domyślnie wartość allowlist, gdy groupAllowFrom lub allowFrom zawiera konkretny wpis, a w przeciwnym razie open.
• Polecenia ukośnikowe „Auth: allowlist” wymagają jawnego wpisu bez symbolu wieloznacznego w allowFrom (lub groupAllowFrom w przypadku wywołań grupowych), niezależnie od dmPolicy / groupPolicy — zobacz Polecenia ukośnikowe.

​

Konfiguracja wielu kont

{
  channels: {
    qqbot: {
      enabled: true,
      appId: "111111111",
      clientSecret: "secret-of-bot-1",
      accounts: {
        bot2: {
          enabled: true,
          appId: "222222222",
          clientSecret: "secret-of-bot-2",
        },
      },
    },
  },
}

openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2"

​

Czaty grupowe

{
  channels: {
    qqbot: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["member_openid"],
      groups: {
        "*": {
          requireMention: true,
          commandLevel: "all",
          historyLimit: 50,
          tools: { deny: ["exec", "read", "write"] },
        },
        GROUP_OPENID: {
          name: "Release room",
          requireMention: false,
          ignoreOtherMentions: true,
          commandLevel: "safety",
          historyLimit: 20,
          prompt: "Keep replies short and operational.",
        },
      },
    },
  },
}

​

Głos (STT / TTS)

{
  channels: {
    qqbot: {
      stt: {
        provider: "your-provider",
        model: "your-stt-model",
      },
      tts: {
        provider: "your-provider",
        model: "your-tts-model",
        voice: "your-voice",
      },
      accounts: {
        "qq-main": {
          tts: {
            providers: {
              openai: { voice: "shimmer" },
            },
          },
        },
      },
    },
  },
}

• sttDirectFormats
• uploadDirectFormats
• transcodeEnabled

​

Formaty celów

​

Polecenia ukośnikowe

​

Multimedia i pamięć masowa

• Przychodzące, wychodzące i przekazywane przez Gateway multimedia współdzielą jeden katalog główny ładunków w ~/.openclaw/media/qqbot (z uwzględnieniem OPENCLAW_HOME, jeśli jest ustawione), dzięki czemu wysyłane pliki, pobierane pliki i pamięci podręczne transkodowania pozostają w jednym chronionym katalogu.
• Dostarczanie multimediów wzbogaconych do odbiorców C2C i grupowych odbywa się przez jedną ścieżkę sendMedia. Pliki lokalne i bufory w pamięci o rozmiarze co najmniej 5 MiB korzystają z punktów końcowych QQ do przesyłania fragmentami; mniejsze ładunki oraz źródła w postaci zdalnych adresów URL/Base64 korzystają z jednorazowego interfejsu API przesyłania.
• Jeśli aktualizacja na gorąco przerwie działanie Gateway przed zakończeniem zapisu openclaw.json, przy następnym uruchomieniu plugin przywróci ostatnie znane appId / clientSecret dla tego konta z wewnętrznej migawki (nigdy nie zastępując celowej zmiany konfiguracji), dzięki czemu ponowne skanowanie kodu QR nie jest wymagane.

​

Rozwiązywanie problemów

• Gateway nie uruchamia się / brak wiadomości przychodzących: należy sprawdzić, czy appId i clientSecret są prawidłowe oraz czy bot jest włączony na platformie QQ Open Platform. Brak danych uwierzytelniających jest zgłaszany jako „QQBot nie jest skonfigurowany (brak appId lub clientSecret)”.
• Konfiguracja za pomocą --token-file nadal jest wyświetlana jako nieskonfigurowana: --token-file ustawia tylko AppSecret. appId nadal musi być ustawione w konfiguracji lub QQBOT_APP_ID.
• Serie odpowiedzi grupowych kolidują ze sobą: gdy kolejka uczestnika się zapełnia, kolejka przychodząca usuwa wiadomości utworzone przez bota przed wiadomościami utworzonymi przez ludzi i scala serie zwykłych (niebędących poleceniami) wiadomości grupowych w jedną turę z przypisanym autorstwem, dzięki czemu zalew komunikatów botów nie powinien blokować wiadomości od ludzi.
• Wiadomości proaktywne nie docierają: QQ może blokować wiadomości inicjowane przez bota, jeśli użytkownik nie nawiązał ostatnio interakcji.
• Głos nie jest transkrybowany: należy upewnić się, że STT jest skonfigurowane, a dostawca jest osiągalny.

​

Powiązane

• Parowanie
• Grupy
• Rozwiązywanie problemów z kanałami