Nextcloud Talk

Nextcloud Talk é um plugin de canal disponível para download (@openclaw/nextcloud-talk) que conecta o OpenClaw a uma instância auto-hospedada do Nextcloud por meio de um bot de Webhook do Talk. Há suporte para mensagens diretas, salas, reações e mensagens em markdown; mídias são enviadas como URLs.

Instalação

openclaw plugins install @openclaw/nextcloud-talk

Use a especificação simples do pacote para acompanhar a tag da versão oficial atual. Fixe uma versão exata somente quando precisar de uma instalação reproduzível.

A partir de um checkout local (fluxos de desenvolvimento):

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

Reinicie o Gateway após a instalação. Detalhes: Plugins

Configuração rápida (iniciante)

1. Instale o plugin (acima).

2. No servidor Nextcloud, crie um bot:

   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction

   Mantenha --feature response: sem esse recurso, as respostas de saída falham com o código 401. Corrija um bot existente com ./occ talk:bot:state --feature webhook --feature response --feature reaction <botId> 1.

3. Ative o bot nas configurações da sala de destino.

4. Configure o OpenClaw:

   • Configuração: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Ou variável de ambiente: NEXTCLOUD_TALK_BOT_SECRET (somente para a conta padrão)

   Configuração pela CLI (--url/--token são aliases dos campos explícitos; nc-talk e nc funcionam como aliases do canal):

   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 armazenado 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 conclua a configuração).

Configuração mínima:

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

Observações

• Os bots não podem iniciar mensagens diretas. O usuário precisa enviar uma mensagem ao bot primeiro.
• A URL do Webhook deve estar acessível pelo servidor Nextcloud; defina webhookPublicUrl quando o Gateway estiver atrás de um proxy. As solicitações do Webhook são assinadas com HMAC-SHA256 usando o segredo do bot; assinaturas inválidas são rejeitadas e sujeitas a limitação de taxa.
• A API do bot não oferece suporte ao upload de mídias; a mídia de saída é acrescentada como uma linha Attachment: <url>.
• A carga útil do Webhook não diferencia mensagens diretas de salas; defina apiUser + apiPassword para habilitar consultas do tipo de sala (armazenadas em cache por cerca de 5 minutos). Sem esses campos, todas as conversas são tratadas como salas.
• As solicitações de saída passam pela proteção contra SSRF. Para um host Nextcloud em uma rede privada/interna confiável, habilite explicitamente channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: true.
• Com apiUser/apiPassword e webhookPublicUrl definidos, openclaw channels status verifica o bot e emite um aviso quando o recurso response está ausente.

Controle de acesso (mensagens diretas)

• Padrão: channels.nextcloud-talk.dmPolicy = "pairing". Remetentes desconhecidos recebem um código de pareamento.
• Aprove por meio de:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Mensagens diretas públicas: channels.nextcloud-talk.dmPolicy="open" junto com channels.nextcloud-talk.allowFrom=["*"].
• allowFrom corresponde somente a IDs de usuário do Nextcloud (em letras minúsculas); nomes de exibição são ignorados.

Salas (grupos)

• Padrão: channels.nextcloud-talk.groupPolicy = "allowlist" (exige menção).
• Adicione salas à lista de permissões com channels.nextcloud-talk.rooms, usando o token da sala como chave; "*" define um padrão curinga:

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

• Chaves por sala: requireMention (padrão: true), enabled (false desativa a sala), allowFrom (lista de remetentes permitidos por sala), tools (substituições de permissão/bloqueio de ferramentas), skills (limita as Skills carregadas), systemPrompt.
• Para não permitir nenhuma sala, mantenha a lista de permissões vazia ou defina channels.nextcloud-talk.groupPolicy="disabled".

Recursos

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

Configuração completa: Configuração

Opções do provedor:

• channels.nextcloud-talk.enabled: ativa/desativa a inicialização do canal.
• channels.nextcloud-talk.baseUrl: URL da instância do Nextcloud.
• channels.nextcloud-talk.botSecret: segredo compartilhado do bot (string ou referência de segredo).
• channels.nextcloud-talk.botSecretFile: caminho do arquivo comum que contém o segredo. Links simbólicos são rejeitados.
• channels.nextcloud-talk.apiUser: usuário da API para consultas de salas (detecção de mensagens diretas) e verificação de status.
• channels.nextcloud-talk.apiPassword: senha da API/do aplicativo para consultas de salas.
• channels.nextcloud-talk.apiPasswordFile: caminho do arquivo de senha da API.
• channels.nextcloud-talk.webhookPort: porta do listener do 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 (padrão: pairing). open exige allowFrom=["*"].
• channels.nextcloud-talk.allowFrom: lista de permissões de mensagens diretas (IDs de usuário).
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled (padrão: allowlist).
• channels.nextcloud-talk.groupAllowFrom: lista de remetentes permitidos em salas (IDs de usuário); usa allowFrom como alternativa quando não definido.
• channels.nextcloud-talk.rooms: configurações e lista de permissões por sala (consulte acima).
• Grupos estáticos de acesso de remetentes podem ser referenciados em allowFrom e groupAllowFrom com accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: limite do histórico de grupos (0 desativa).
• channels.nextcloud-talk.dmHistoryLimit: limite do histórico de mensagens diretas (0 desativa).
• channels.nextcloud-talk.dms: substituições por mensagem direta, indexadas pelo ID do usuário (historyLimit).
• channels.nextcloud-talk.textChunkLimit: tamanho dos segmentos de texto de saída em caracteres (padrão: 4000).
• channels.nextcloud-talk.chunkMode: length (padrão) ou newline para dividir em linhas em branco (limites de parágrafos) antes da segmentação por tamanho.
• channels.nextcloud-talk.blockStreaming: desativa o streaming em blocos para este canal.
• channels.nextcloud-talk.blockStreamingCoalesce: ajuste da aglutinação do streaming em blocos.
• channels.nextcloud-talk.responsePrefix: prefixo das respostas de saída.
• channels.nextcloud-talk.markdown.tables: modo de renderização de tabelas markdown (off | bullets | code | block).
• channels.nextcloud-talk.mediaMaxMb: limite de mídia de entrada (MB).
• channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: permite que hosts Nextcloud privados/internos ultrapassem a proteção contra SSRF.
• channels.nextcloud-talk.accounts.<id>: substituições por conta (mesmas chaves); defaultAccount seleciona a conta padrão. As variáveis de ambiente NEXTCLOUD_TALK_BOT_SECRET / NEXTCLOUD_TALK_API_PASSWORD se aplicam somente à conta padrão.

Relacionados

• Visão geral dos canais — todos os canais compatíveis
• Pareamento — autenticação de mensagens diretas e fluxo de pareamento
• Grupos — comportamento de chats em grupo e exigência de menção
• Roteamento de canais — roteamento de sessões para mensagens
• Segurança — modelo de acesso e reforço de segurança