Nextcloud Talk 频道

通过 webhook bot 接入 Nextcloud Talk。支持私信、房间、表情反应和 Markdown 消息。

安装

openclaw plugins install @openclaw/nextcloud-talk

配置步骤

1. 在 Nextcloud 服务器创建 bot：

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

2. 在目标房间设置中启用 bot

3. 配置 OpenClaw：

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

CLI 快速设置

openclaw channels add --channel nextcloud-talk \
  --url https://cloud.example.com \
  --token "<shared-secret>"

访问控制

DM：默认 pairing，通过 openclaw pairing approve nextcloud-talk <CODE> 审批

房间（群组）：

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

功能支持

功能	状态
私信	支持
房间	支持
线程	不支持
媒体	仅 URL
表情反应	支持
原生命令	不支持

注意事项

• Bot 无法主动发起私信，用户必须先发消息
• Webhook URL 必须从 Gateway 可达；代理后设置 webhookPublicUrl
• 媒体以 URL 形式发送，不支持上传
• 设置 apiUser + apiPassword 以区分私信和房间

主要配置项

• baseUrl：Nextcloud 实例 URL
• botSecret：bot 共享密钥
• webhookPublicUrl：外部可达的 webhook URL
• dmPolicy：pairing | allowlist | open | disabled
• groupPolicy：allowlist | open | disabled
• historyLimit：群组历史上下文条数

相关链接

• channel-pairing — DM 配对流程
• channel-routing — 消息路由机制