Nextcloud Talk

​

Встроенный 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
   • Или переменная окружения: 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",
    },
  },
}

​

Примечания

• Боты не могут инициировать личные сообщения. Пользователь должен сначала написать боту.
• URL Webhook должен быть доступен для Gateway; если используется прокси, задайте webhookPublicUrl.
• Загрузка медиа не поддерживается API бота; медиа отправляются как URL.
• Полезная нагрузка Webhook не различает личные сообщения и комнаты; задайте apiUser + apiPassword, чтобы включить определение типа комнаты (иначе личные сообщения обрабатываются как комнаты).

​

Управление доступом (личные сообщения)

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

​

Комнаты (группы)

• По умолчанию: channels.nextcloud-talk.groupPolicy = "allowlist" (доступ по упоминанию).
• Добавьте комнаты в список разрешенных через channels.nextcloud-talk.rooms:

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

• Чтобы не разрешать ни одну комнату, оставьте список разрешенных пустым или задайте 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: путь к обычному файлу с секретом. Символические ссылки отклоняются.
• channels.nextcloud-talk.apiUser: пользователь API для поиска комнат (определение личных сообщений).
• channels.nextcloud-talk.apiPassword: пароль API/приложения для поиска комнат.
• 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: список разрешенных для личных сообщений (идентификаторы пользователей). open требует "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: список разрешенных для групп (идентификаторы пользователей).
• channels.nextcloud-talk.rooms: настройки и список разрешенных для отдельных комнат.
• Статические группы доступа отправителей можно указывать в allowFrom и groupAllowFrom через accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: лимит истории группы (0 отключает).
• channels.nextcloud-talk.dmHistoryLimit: лимит истории личных сообщений (0 отключает).
• channels.nextcloud-talk.dms: переопределения для отдельных личных сообщений (historyLimit).
• channels.nextcloud-talk.textChunkLimit: размер исходящего фрагмента текста (символы).
• channels.nextcloud-talk.chunkMode: length (по умолчанию) или newline для разделения по пустым строкам (границам абзацев) перед разбиением по длине.
• channels.nextcloud-talk.blockStreaming: отключить потоковую передачу блоков для этого канала.
• channels.nextcloud-talk.blockStreamingCoalesce: настройка объединения потоковой передачи блоков.
• channels.nextcloud-talk.mediaMaxMb: лимит входящих медиа (МБ).

​

См. также

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