Nextcloud Talk

Status: dołączony Plugin (bot Webhook). Obsługiwane są wiadomości bezpośrednie, pokoje, reakcje i wiadomości markdown.

Dołączony Plugin

Nextcloud Talk jest dostarczany jako dołączony Plugin w bieżących wydaniach OpenClaw, więc standardowe kompilacje pakietowe nie wymagają osobnej instalacji.

Jeśli używasz starszej kompilacji lub niestandardowej instalacji, która wyklucza Nextcloud Talk, zainstaluj pakiet npm bezpośrednio:

Instalacja przez CLI (rejestr npm):

openclaw plugins install @openclaw/nextcloud-talk

Użyj samej nazwy pakietu, aby podążać za bieżącym oficjalnym tagiem wydania. Przypnij dokładną wersję tylko wtedy, gdy potrzebujesz odtwarzalnej instalacji.

Lokalny checkout (podczas uruchamiania z repozytorium git):

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

Szczegóły: Pluginy

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ę).

Minimalna konfiguracja:

{  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)

Pełna konfiguracja: Konfiguracja

Opcje dostawcy:

• 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