Nextcloud Talk (插件)

状态：通过插件（webhook 机器人）支持。支持直接消息、房间、反应和 Markdown 消息。

需要插件

Nextcloud Talk 作为插件提供，并不包含在核心安装中。

通过 CLI 安装（npm 仓库）：

openclaw plugins install @openclaw/nextcloud-talk

本地检出（从 git 仓库运行时）：

openclaw plugins install ./extensions/nextcloud-talk

如果您在配置/引导过程中选择 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）

完整配置：Configuration

提供商选项：

• 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）。