Nextcloud Talk（插件）

状态：通过插件支持（webhook 机器人）。支持私聊、房间、反应和 markdown 消息�?

需要插�?

Nextcloud Talk 作为插件提供，不随核心安装一起打包�?

通过 CLI 安装（npm 注册表）�?

openclaw plugins install @openclaw/nextcloud-talk

本地检出（�?git 仓库运行时）�?

openclaw plugins install ./extensions/nextcloud-talk

如果�?configure/onboarding 期间选择 Nextcloud Talk 并检测到 git 检出， OpenClaw 将自动提供本地安装路径�?

详情：Plugins

快速设置（入门�?

1. 安装 Nextcloud Talk 插件�?

2. 在你�?Nextcloud 服务器上，创建一个机器人�?

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

3. 在目标房间设置中启用机器人�?

4. 配置 OpenClaw�?

   • 配置：channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • 或环境变量：NEXTCLOUD_TALK_BOT_SECRET（仅默认账户�?

5. 重启网关（或完成入职）�?

最小配置：

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

注意事项

• 机器人无法发起私聊。用户必须先向机器人发送消息�?
• Webhook URL 必须可被网关访问；如果在代理后面，设�?webhookPublicUrl�?
• 机器�?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"�?

功能

配置参考（Nextcloud Talk�?

完整配置：配置

提供商选项�?

• channels.nextcloud-talk.enabled：启�?禁用频道启动�?
• channels.nextcloud-talk.baseUrl：Nextcloud 实例 URL�?
• channels.nextcloud-talk.botSecret：机器人共享密钥�?
• 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）�?