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.

​

Bundled plugin

openclaw plugins install @openclaw/nextcloud-talk

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

​

Швидке налаштування (для початківців)

1. Переконайтеся, що Plugin Nextcloud Talk доступний.
   • Поточні пакетовані випуски OpenClaw вже містять його.
   • Старіші/власні встановлення можуть додати його вручну за допомогою команд вище.
2. На вашому сервері Nextcloud створіть бота:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
3. Увімкніть бота в налаштуваннях цільової кімнати.
4. Налаштуйте OpenClaw:
   • Конфігурація: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Або env: NEXTCLOUD_TALK_BOT_SECRET (лише обліковий запис за замовчуванням)
   Налаштування CLI:
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Еквівалентні явні поля:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Секрет із файлу:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Перезапустіть Gateway (або завершіть налаштування).

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

​

Примітки

• Боти не можуть ініціювати DMs. Користувач має спочатку надіслати повідомлення боту.
• URL Webhook має бути доступним для Gateway; установіть webhookPublicUrl, якщо він за проксі.
• Завантаження медіа не підтримуються bot API; медіа надсилаються як URLs.
• Корисне навантаження webhook не розрізняє DMs і кімнати; установіть apiUser + apiPassword, щоб увімкнути визначення типу кімнати (інакше DMs обробляються як кімнати).

​

Контроль доступу (DMs)

• За замовчуванням: channels.nextcloud-talk.dmPolicy = "pairing". Невідомі відправники отримують код сполучення.
• Схваліть через:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Публічні DMs: channels.nextcloud-talk.dmPolicy="open" плюс channels.nextcloud-talk.allowFrom=["*"].
• allowFrom зіставляє лише IDs користувачів Nextcloud; відображувані імена ігноруються.

​

Кімнати (групи)

• За замовчуванням: channels.nextcloud-talk.groupPolicy = "allowlist" (керовано згадками).
• Додавайте кімнати до allowlist за допомогою channels.nextcloud-talk.rooms:

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

• Щоб не дозволяти жодних кімнат, залиште allowlist порожнім або встановіть channels.nextcloud-talk.groupPolicy="disabled".

​

Можливості

​

Довідник конфігурації (Nextcloud Talk)

• channels.nextcloud-talk.enabled: увімкнути/вимкнути запуск каналу.
• channels.nextcloud-talk.baseUrl: URL інстансу Nextcloud.
• channels.nextcloud-talk.botSecret: спільний секрет бота.
• channels.nextcloud-talk.botSecretFile: шлях до секрету у звичайному файлі. Symlinks відхиляються.
• channels.nextcloud-talk.apiUser: користувач API для пошуку кімнат (визначення DM).
• channels.nextcloud-talk.apiPassword: пароль API/app для пошуку кімнат.
• channels.nextcloud-talk.apiPasswordFile: шлях до файлу пароля API.
• channels.nextcloud-talk.webhookPort: порт слухача webhook (за замовчуванням: 8788).
• channels.nextcloud-talk.webhookHost: хост webhook (за замовчуванням: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: шлях webhook (за замовчуванням: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: зовнішньо доступний URL webhook.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: allowlist для DM (IDs користувачів). open потребує "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: allowlist для груп (IDs користувачів).
• channels.nextcloud-talk.rooms: налаштування й allowlist для окремих кімнат.
• Статичні групи доступу відправників можна посилати з allowFrom і groupAllowFrom через accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: ліміт історії групи (0 вимикає).
• channels.nextcloud-talk.dmHistoryLimit: ліміт історії DM (0 вимикає).
• channels.nextcloud-talk.dms: перевизначення для окремих DM (historyLimit).
• channels.nextcloud-talk.textChunkLimit: розмір вихідного текстового фрагмента (символи).
• channels.nextcloud-talk.chunkMode: length (за замовчуванням) або newline для поділу за порожніми рядками (межами абзаців) перед поділом за довжиною.
• channels.nextcloud-talk.blockStreaming: вимкнути block streaming для цього каналу.
• channels.nextcloud-talk.blockStreamingCoalesce: налаштування об’єднання block streaming.
• channels.nextcloud-talk.mediaMaxMb: ліміт вхідних медіа (MB).

​

Пов’язане

• Огляд каналів — усі підтримувані канали
• Сполучення — автентифікація DM і потік сполучення
• Групи — поведінка групового чату та керування згадками
• Маршрутизація каналів — маршрутизація сесій для повідомлень
• Безпека — модель доступу та зміцнення захисту