Nextcloud Talk

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Dołączony Plugin

openclaw plugins install @openclaw/nextcloud-talk

openclaw plugins install ./path/to/local/nextcloud-talk-plugin

​

Szybka konfiguracja (dla początkujących)

1. Upewnij się, że Plugin Nextcloud Talk jest dostępny.
   • Bieżące pakietowe wydania OpenClaw już go zawierają.
   • Starsze/niestandardowe instalacje mogą dodać go ręcznie za pomocą powyższych poleceń.
2. Na swoim serwerze Nextcloud utwórz bota:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
3. Włącz bota w ustawieniach docelowego pokoju.
4. Skonfiguruj OpenClaw:
   • Konfiguracja: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Albo env: NEXTCLOUD_TALK_BOT_SECRET (tylko konto domyślne)
   Konfiguracja CLI:
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Równoważne pola jawne:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Sekret oparty na pliku:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Uruchom ponownie Gateway (albo dokończ konfigurację).

{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

​

Uwagi

• Boty nie mogą inicjować DM. Użytkownik musi najpierw napisać do bota.
• Adres URL Webhook musi być osiągalny przez Gateway; ustaw webhookPublicUrl, jeśli jest za proxy.
• Przesyłanie multimediów nie jest obsługiwane przez API bota; multimedia są wysyłane jako adresy URL.
• Ładunek Webhook nie rozróżnia DM i pokoi; ustaw apiUser + apiPassword, aby włączyć wyszukiwanie typu pokoju (w przeciwnym razie DM są traktowane jak pokoje).

​

Kontrola dostępu (DM)

• Domyślnie: channels.nextcloud-talk.dmPolicy = "pairing". Nieznani nadawcy otrzymują kod parowania.
• Zatwierdź przez:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Publiczne DM: channels.nextcloud-talk.dmPolicy="open" plus channels.nextcloud-talk.allowFrom=["*"].
• allowFrom dopasowuje tylko identyfikatory użytkowników Nextcloud; nazwy wyświetlane są ignorowane.

​

Pokoje (grupy)

• Domyślnie: channels.nextcloud-talk.groupPolicy = "allowlist" (bramka przez wzmiankę).
• Dodaj pokoje do listy dozwolonych za pomocą channels.nextcloud-talk.rooms:

{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}

• Aby nie zezwalać na żadne pokoje, pozostaw listę dozwolonych pustą albo ustaw channels.nextcloud-talk.groupPolicy="disabled".

​

Możliwości

​

Dokumentacja konfiguracji (Nextcloud Talk)

• channels.nextcloud-talk.enabled: włącza/wyłącza uruchamianie kanału.
• channels.nextcloud-talk.baseUrl: adres URL instancji Nextcloud.
• channels.nextcloud-talk.botSecret: współdzielony sekret bota.
• channels.nextcloud-talk.botSecretFile: ścieżka do sekretu w zwykłym pliku. Dowiązania symboliczne są odrzucane.
• channels.nextcloud-talk.apiUser: użytkownik API do wyszukiwania pokoi (wykrywanie DM).
• channels.nextcloud-talk.apiPassword: hasło API/aplikacji do wyszukiwania pokoi.
• channels.nextcloud-talk.apiPasswordFile: ścieżka do pliku hasła API.
• channels.nextcloud-talk.webhookPort: port nasłuchiwania Webhook (domyślnie: 8788).
• channels.nextcloud-talk.webhookHost: host Webhook (domyślnie: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: ścieżka Webhook (domyślnie: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: zewnętrznie osiągalny adres URL Webhook.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: lista dozwolonych DM (identyfikatory użytkowników). open wymaga "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: lista dozwolonych grup (identyfikatory użytkowników).
• channels.nextcloud-talk.rooms: ustawienia dla poszczególnych pokoi i lista dozwolonych.
• Statyczne grupy dostępu nadawców mogą być przywoływane z allowFrom i groupAllowFrom za pomocą accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: limit historii grupy (0 wyłącza).
• channels.nextcloud-talk.dmHistoryLimit: limit historii DM (0 wyłącza).
• channels.nextcloud-talk.dms: nadpisania dla poszczególnych DM (historyLimit).
• channels.nextcloud-talk.textChunkLimit: rozmiar wychodzącego fragmentu tekstu (znaki).
• channels.nextcloud-talk.chunkMode: length (domyślnie) albo newline, aby dzielić według pustych wierszy (granic akapitów) przed dzieleniem według długości.
• channels.nextcloud-talk.blockStreaming: wyłącza strumieniowanie bloków dla tego kanału.
• channels.nextcloud-talk.blockStreamingCoalesce: dostrajanie scalania strumieniowania bloków.
• channels.nextcloud-talk.mediaMaxMb: limit przychodzących multimediów (MB).

​

Powiązane

• Przegląd kanałów — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie DM i przepływ parowania
• Grupy — zachowanie czatu grupowego i bramkowanie wzmiankami
• Routing kanałów — routing sesji dla wiadomości
• Bezpieczeństwo — model dostępu i utwardzanie