ContextQMD
Back to Eliza

Nextcloud Talk Plugin

packages/docs/plugin-registry/platform/nextcloud-talk.md

2.0.11.8 KB
Original Source

The Nextcloud Talk plugin connects Eliza agents to Nextcloud Talk, enabling message handling in Nextcloud Talk conversations on self-hosted Nextcloud instances.

Package: @elizaos/plugin-nextcloud-talk

Installation

bash
eliza plugins install @elizaos/plugin-nextcloud-talk

Setup

1. Configure Your Nextcloud Instance

  1. Ensure Nextcloud Talk is installed and enabled on your Nextcloud instance
  2. Create a bot user or use an existing account for the agent
  3. Note the Nextcloud server URL and bot credentials

2. Configure Eliza

json
{
  "connectors": {
    "nextcloud-talk": {
      "enabled": true
    }
  }
}

Set credentials via environment variables:

bash
export NEXTCLOUD_URL=https://your-nextcloud-instance.example.com
export NEXTCLOUD_BOT_SECRET=YOUR_BOT_SECRET

Configuration

FieldRequiredDescription
enabledNoSet false to disable (default: true)

Environment Variables

VariableRequiredDescription
NEXTCLOUD_URLYesNextcloud server URL
NEXTCLOUD_BOT_SECRETYesBot secret for authentication
NEXTCLOUD_WEBHOOK_HOSTNoHost address for webhook listener
NEXTCLOUD_WEBHOOK_PORTNoPort for webhook listener
NEXTCLOUD_WEBHOOK_PATHNoWebhook endpoint path
NEXTCLOUD_WEBHOOK_PUBLIC_URLNoPublic-facing webhook URL
NEXTCLOUD_ALLOWED_ROOMSNoComma-separated list of allowed room IDs

Features

  • Room-based messaging
  • DM and group conversation support
  • Self-hosted collaboration platform integration
  • Webhook-based message delivery