Nextcloud Talk (plugin)

状态：通过 Plugin 支持（Webhook bot）。支持私信、房间、表情回应和 Markdown 消息。

需要安装 Plugin

Nextcloud Talk 以 Plugin 形式提供，不包含在核心安装中。

通过 CLI 安装（npm registry）：

openclaw plugins install @openclaw/nextcloud-talk

本地安装（从 git 仓库运行时）：

openclaw plugins install ./extensions/nextcloud-talk

如果你在配置/引导过程中选择 Nextcloud Talk，并且检测到 git 仓库，OpenClaw 会自动提供本地安装路径。

详情：Plugins

快速设置（新手向）

  1. 安装 Nextcloud Talk Plugin。
  2. 在你的 Nextcloud 服务器上创建 bot： 
    ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction
  3. 在目标房间设置中启用 bot。
  4. 配置 OpenClaw：
    • 配置项：channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • 或环境变量：NEXTCLOUD_TALK_BOT_SECRET（仅默认账户）
  5. 重启 Gateway（或完成引导）。

最小配置：

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

注意事项

  • Bot 无法主动发起 DM。用户必须先给 bot 发消息。
  • Webhook URL 必须能被 Gateway 访问；如果在代理后面，需要设置 webhookPublicUrl。
  • Bot API 不支持媒体上传；媒体会以 URL 形式发送。
  • Webhook 负载无法区分 DM 和房间；设置 apiUser + apiPassword 可启用房间类型查询（否则 DM 会被当作房间处理）。

访问控制（DM）

  • 默认：channels.nextcloud-talk.dmPolicy = "pairing"。未知发送者会收到 Pairing 码。
  • 批准方式：
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk <CODE>
  • 公开 DM：channels.nextcloud-talk.dmPolicy="open" 加上 channels.nextcloud-talk.allowFrom=["*"]。

房间（群组）

  • 默认：channels.nextcloud-talk.groupPolicy = "allowlist"（需要 @提及）。
  • 通过 channels.nextcloud-talk.rooms 添加房间到 Allowlist：
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}
  • 要禁止所有房间，保持 Allowlist 为空或设置 channels.nextcloud-talk.groupPolicy="disabled"。

功能支持

功能状态
私信支持
房间支持
话题串不支持
媒体仅 URL
表情回应支持
原生命令不支持

配置参考（Nextcloud Talk）

完整配置：Configuration

Provider 选项：

  • channels.nextcloud-talk.enabled：启用/禁用 Channel 启动。
  • channels.nextcloud-talk.baseUrl：Nextcloud 实例 URL。
  • channels.nextcloud-talk.botSecret：bot 共享密钥。
  • channels.nextcloud-talk.botSecretFile：密钥文件路径。
  • channels.nextcloud-talk.apiUser：用于房间查询的 API 用户（DM 检测）。
  • channels.nextcloud-talk.apiPassword：用于房间查询的 API/应用密码。
  • channels.nextcloud-talk.apiPasswordFile：API 密码文件路径。
  • channels.nextcloud-talk.webhookPort：Webhook 监听端口（默认：8788）。
  • channels.nextcloud-talk.webhookHost：Webhook 主机（默认：0.0.0.0）。
  • channels.nextcloud-talk.webhookPath：Webhook 路径（默认：/nextcloud-talk-webhook）。
  • channels.nextcloud-talk.webhookPublicUrl：外部可访问的 Webhook URL。
  • channels.nextcloud-talk.dmPolicy：pairing | allowlist | open | disabled。
  • channels.nextcloud-talk.allowFrom：DM Allowlist（用户 ID）。open 需要 "*"。
  • channels.nextcloud-talk.groupPolicy：allowlist | open | disabled。
  • channels.nextcloud-talk.groupAllowFrom：群组 Allowlist（用户 ID）。
  • channels.nextcloud-talk.rooms：每个房间的设置和 Allowlist。
  • channels.nextcloud-talk.historyLimit：群组历史记录限制（0 禁用）。
  • channels.nextcloud-talk.dmHistoryLimit：DM 历史记录限制（0 禁用）。
  • channels.nextcloud-talk.dms：每个 DM 的覆盖设置（historyLimit）。
  • channels.nextcloud-talk.textChunkLimit：出站文本分块大小（字符数）。
  • channels.nextcloud-talk.chunkMode：length（默认）或 newline，在长度分块前按空行（段落边界）拆分。
  • channels.nextcloud-talk.blockStreaming：禁用此 Channel 的块 Streaming。
  • channels.nextcloud-talk.blockStreamingCoalesce：块 Streaming 合并调优。
  • channels.nextcloud-talk.mediaMaxMb：入站媒体上限（MB）。