Nextcloud Talk

​

बंडल किया गया Plugin

openclaw plugins install @openclaw/nextcloud-talk

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

​

त्वरित सेटअप (शुरुआती)

1. सुनिश्चित करें कि Nextcloud Talk Plugin उपलब्ध है।
   • वर्तमान पैकेज्ड OpenClaw रिलीज़ इसे पहले से बंडल करती हैं।
   • पुराने/कस्टम इंस्टॉल इसे ऊपर दिए गए कमांड से मैन्युअल रूप से जोड़ सकते हैं।
2. अपने Nextcloud सर्वर पर, एक bot बनाएँ:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
3. लक्ष्य कक्ष सेटिंग्स में bot सक्षम करें।
4. OpenClaw कॉन्फ़िगर करें:
   • Config: 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>"
   
   फ़ाइल-आधारित 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",
    },
  },
}

​

नोट्स

• Bots DMs शुरू नहीं कर सकते। उपयोगकर्ता को पहले bot को संदेश भेजना होगा।
• Webhook URL Gateway द्वारा पहुँच योग्य होना चाहिए; यदि proxy के पीछे है तो webhookPublicUrl सेट करें।
• Media uploads bot API द्वारा समर्थित नहीं हैं; media URLs के रूप में भेजा जाता है।
• Webhook payload DMs और कक्षों में अंतर नहीं करता; room-type lookups सक्षम करने के लिए apiUser + apiPassword सेट करें (अन्यथा DMs को कक्ष माना जाता है)।

​

पहुँच नियंत्रण (DMs)

• डिफ़ॉल्ट: channels.nextcloud-talk.dmPolicy = "pairing"। अज्ञात प्रेषकों को pairing code मिलता है।
• इसके माध्यम से स्वीकृत करें:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• सार्वजनिक DMs: channels.nextcloud-talk.dmPolicy="open" plus channels.nextcloud-talk.allowFrom=["*"].
• allowFrom केवल Nextcloud user IDs से मेल खाता है; display names अनदेखे किए जाते हैं।

​

कक्ष (समूह)

• डिफ़ॉल्ट: channels.nextcloud-talk.groupPolicy = "allowlist" (mention-gated)।
• channels.nextcloud-talk.rooms के साथ कक्षों को allowlist करें:

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

• कोई कक्ष अनुमति न देने के लिए, allowlist खाली रखें या channels.nextcloud-talk.groupPolicy="disabled" सेट करें।

​

क्षमताएँ

​

कॉन्फ़िगरेशन संदर्भ (Nextcloud Talk)

• channels.nextcloud-talk.enabled: channel startup सक्षम/अक्षम करें।
• channels.nextcloud-talk.baseUrl: Nextcloud instance URL।
• channels.nextcloud-talk.botSecret: bot shared secret।
• channels.nextcloud-talk.botSecretFile: regular-file secret path। Symlinks अस्वीकार किए जाते हैं।
• channels.nextcloud-talk.apiUser: room lookups (DM detection) के लिए API user।
• channels.nextcloud-talk.apiPassword: room lookups के लिए API/app password।
• channels.nextcloud-talk.apiPasswordFile: API password file path।
• channels.nextcloud-talk.webhookPort: webhook listener port (डिफ़ॉल्ट: 8788)।
• channels.nextcloud-talk.webhookHost: webhook host (डिफ़ॉल्ट: 0.0.0.0)।
• channels.nextcloud-talk.webhookPath: webhook path (डिफ़ॉल्ट: /nextcloud-talk-webhook)।
• channels.nextcloud-talk.webhookPublicUrl: बाहरी रूप से पहुँच योग्य webhook URL।
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled।
• channels.nextcloud-talk.allowFrom: DM allowlist (user IDs)। open के लिए "*" आवश्यक है।
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled।
• channels.nextcloud-talk.groupAllowFrom: group allowlist (user IDs)।
• channels.nextcloud-talk.rooms: प्रति-कक्ष settings और allowlist।
• Static sender access groups को allowFrom और groupAllowFrom से accessGroup:<name> के साथ संदर्भित किया जा सकता है।
• channels.nextcloud-talk.historyLimit: group history limit (0 अक्षम करता है)।
• channels.nextcloud-talk.dmHistoryLimit: DM history limit (0 अक्षम करता है)।
• channels.nextcloud-talk.dms: प्रति-DM overrides (historyLimit)।
• channels.nextcloud-talk.textChunkLimit: outbound text chunk size (chars)।
• channels.nextcloud-talk.chunkMode: लंबाई chunking से पहले रिक्त पंक्तियों (paragraph boundaries) पर विभाजित करने के लिए length (डिफ़ॉल्ट) या newline।
• channels.nextcloud-talk.blockStreaming: इस channel के लिए block streaming अक्षम करें।
• channels.nextcloud-talk.blockStreamingCoalesce: block streaming coalesce tuning।
• channels.nextcloud-talk.mediaMaxMb: inbound media cap (MB)।

​

संबंधित

• Channels Overview — सभी समर्थित channels
• Pairing — DM authentication और pairing flow
• Groups — group chat behavior और mention gating
• Channel Routing — messages के लिए session routing
• Security — access model और hardening