Nextcloud Talk（插件）

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

安装插件

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

通过 CLI 安装（npm 仓库）：

openclaw plugins install @openclaw/nextcloud-talk

本地代码仓库（从 git 仓库运行时）：

openclaw plugins install ./extensions/nextcloud-talk

在设置时选择 Nextcloud Talk 且检测到 git 代码仓库时，OpenClaw 会自动提示使用本地安装路径。

详见：插件说明

快速配置（初学者）

1. 安装 Nextcloud Talk 插件。

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 无法主动发起私信，必须由用户先联系 Bot。
• Webhook URL 必须可从 Gateway 访问；如果位于代理后面，设置 webhookPublicUrl。
• Bot API 不支持媒体上传，媒体以 URL 形式发送。
• Webhook 载荷无法区分私信和房间；设置 apiUser + apiPassword 以启用房间类型查询（否则私信会被当作房间处理）。

访问控制（私信）

• 默认：channels.nextcloud-talk.dmPolicy = "pairing"。未知发送者收到配对码。
• 审批方式：
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• 开放私信：channels.nextcloud-talk.dmPolicy="open" 加上 channels.nextcloud-talk.allowFrom=["*"]。
• allowFrom 仅匹配 Nextcloud 用户 ID，不匹配显示名称。

房间（群组）

• 默认：channels.nextcloud-talk.groupPolicy = "allowlist"（需 @提及）。
• 通过 channels.nextcloud-talk.rooms 配置允许的房间白名单：

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

• 如需禁止所有房间，保持白名单为空或设置 channels.nextcloud-talk.groupPolicy="disabled"。

功能支持

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

配置参考

完整配置：配置说明

配置选项：

• channels.nextcloud-talk.enabled：启用/禁用渠道启动。
• channels.nextcloud-talk.baseUrl：Nextcloud 实例 URL。
• channels.nextcloud-talk.botSecret：Bot 共享密钥。
• channels.nextcloud-talk.botSecretFile：密钥文件路径（普通文件）。不接受符号链接。
• channels.nextcloud-talk.apiUser：房间查询（私信检测）的 API 用户。
• 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：私信白名单（用户 ID）。open 需要设置 "*"。
• channels.nextcloud-talk.groupPolicy：allowlist | open | disabled。
• channels.nextcloud-talk.groupAllowFrom：群组白名单（用户 ID）。
• channels.nextcloud-talk.rooms：每房间设置和白名单。
• channels.nextcloud-talk.historyLimit：群组历史限制（0 禁用）。
• channels.nextcloud-talk.dmHistoryLimit：私信历史限制（0 禁用）。
• channels.nextcloud-talk.dms：每私信覆盖（historyLimit）。
• channels.nextcloud-talk.textChunkLimit：出站文本分块大小（字符）。
• channels.nextcloud-talk.chunkMode：length（默认）或 newline（在空行处分割）。
• channels.nextcloud-talk.blockStreaming：为该渠道禁用块流。
• channels.nextcloud-talk.blockStreamingCoalesce：块流合并调优。
• channels.nextcloud-talk.mediaMaxMb：入站媒体上限（MB）。