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.

​

Plugin integrado

openclaw plugins install @openclaw/nextcloud-talk

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

​

Configuração rápida (iniciante)

1. Garanta que o plugin Nextcloud Talk esteja disponível.
   • As versões empacotadas atuais do OpenClaw já o incluem.
   • Instalações mais antigas/personalizadas podem adicioná-lo manualmente com os comandos acima.
2. No seu servidor Nextcloud, crie um bot:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
3. Habilite o bot nas configurações da sala de destino.
4. Configure o OpenClaw:
   • Configuração: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Ou env: NEXTCLOUD_TALK_BOT_SECRET (somente conta padrão)
   Configuração via CLI:
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Campos explícitos equivalentes:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Segredo baseado em arquivo:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Reinicie o Gateway (ou finalize a configuração).

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

​

Observações

• Bots não podem iniciar DMs. O usuário deve enviar uma mensagem ao bot primeiro.
• A URL do Webhook deve ser acessível pelo Gateway; defina webhookPublicUrl se estiver atrás de um proxy.
• Uploads de mídia não são compatíveis com a API do bot; a mídia é enviada como URLs.
• A carga útil do Webhook não diferencia DMs de salas; defina apiUser + apiPassword para habilitar consultas de tipo de sala (caso contrário, DMs são tratadas como salas).

​

Controle de acesso (DMs)

• Padrão: channels.nextcloud-talk.dmPolicy = "pairing". Remetentes desconhecidos recebem um código de pareamento.
• Aprovar via:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• DMs públicas: channels.nextcloud-talk.dmPolicy="open" mais channels.nextcloud-talk.allowFrom=["*"].
• allowFrom corresponde apenas a IDs de usuário do Nextcloud; nomes de exibição são ignorados.

​

Salas (grupos)

• Padrão: channels.nextcloud-talk.groupPolicy = "allowlist" (controlado por menção).
• Coloque salas na lista de permissões com channels.nextcloud-talk.rooms:

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

• Para não permitir nenhuma sala, mantenha a lista de permissões vazia ou defina channels.nextcloud-talk.groupPolicy="disabled".

​

Capacidades

​

Referência de configuração (Nextcloud Talk)

• channels.nextcloud-talk.enabled: habilitar/desabilitar a inicialização do canal.
• channels.nextcloud-talk.baseUrl: URL da instância Nextcloud.
• channels.nextcloud-talk.botSecret: segredo compartilhado do bot.
• channels.nextcloud-talk.botSecretFile: caminho do segredo em arquivo regular. Symlinks são rejeitados.
• channels.nextcloud-talk.apiUser: usuário da API para consultas de sala (detecção de DM).
• channels.nextcloud-talk.apiPassword: senha da API/app para consultas de sala.
• channels.nextcloud-talk.apiPasswordFile: caminho do arquivo de senha da API.
• channels.nextcloud-talk.webhookPort: porta do listener de Webhook (padrão: 8788).
• channels.nextcloud-talk.webhookHost: host do Webhook (padrão: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: caminho do Webhook (padrão: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: URL do Webhook acessível externamente.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: lista de permissões de DM (IDs de usuário). open exige "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: lista de permissões de grupo (IDs de usuário).
• channels.nextcloud-talk.rooms: configurações por sala e lista de permissões.
• Grupos estáticos de acesso de remetente podem ser referenciados em allowFrom e groupAllowFrom com accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: limite do histórico de grupo (0 desabilita).
• channels.nextcloud-talk.dmHistoryLimit: limite do histórico de DM (0 desabilita).
• channels.nextcloud-talk.dms: substituições por DM (historyLimit).
• channels.nextcloud-talk.textChunkLimit: tamanho do bloco de texto de saída (caracteres).
• channels.nextcloud-talk.chunkMode: length (padrão) ou newline para dividir em linhas em branco (limites de parágrafo) antes da divisão por comprimento.
• channels.nextcloud-talk.blockStreaming: desabilitar streaming de blocos para este canal.
• channels.nextcloud-talk.blockStreamingCoalesce: ajuste de coalescência de streaming de blocos.
• channels.nextcloud-talk.mediaMaxMb: limite de mídia de entrada (MB).

​

Relacionado

• Visão geral dos canais — todos os canais compatíveis
• Pareamento — autenticação de DM e fluxo de pareamento
• Grupos — comportamento de chat em grupo e controle por menção
• Roteamento de canal — roteamento de sessão para mensagens
• Segurança — modelo de acesso e hardening