Nextcloud Talk（插件）

状态：通过插件支持（webhook 机器人）。支持直接消息（direct messages）、房间（rooms）、反应（reactions）和 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. 重启网关（gateway）（或完成入门流程）。

最小配置：

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

注意事项

  • 机器人无法发起直接消息（DMs）。用户必须先向机器人发送消息。
  • Webhook URL 必须可被网关（Gateway）访问；如果在代理后面，请设置 webhookPublicUrl。
  • 机器人 API 不支持媒体上传；媒体作为 URL 发送。
  • Webhook 有效负载不区分直接消息（DMs）与房间；设置 apiUser + apiPassword 以启用房间类型查找（否则直接消息被视为房间）。

访问控制（DMs）

  • 默认：channels.nextcloud-talk.dmPolicy = "pairing"。未知发送者获得配对码（pairing code）。
  • 批准方式：
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk <CODE>
  • 公开直接消息（DMs）：channels.nextcloud-talk.dmPolicy="open" 加上 channels.nextcloud-talk.allowFrom=["*"]。

房间（群组）

  • 默认：channels.nextcloud-talk.groupPolicy = "allowlist"（需要提及）。
  • 使用 channels.nextcloud-talk.rooms 将房间加入允许列表：
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true }
      }
    }
  }
}
  • 要不允许任何房间，保持允许列表为空或设置 channels.nextcloud-talk.groupPolicy="disabled"。

功能

功能状态
直接消息（Direct messages）支持
房间（Rooms）支持
线程（Threads）不支持
媒体（Media）仅 URL
反应（Reactions）支持
原生命令（Native commands）不支持

配置参考（Nextcloud Talk）

完整配置：配置（Configuration）

提供商选项（Provider options）：

  • channels.nextcloud-talk.enabled：启用/禁用频道启动。
  • channels.nextcloud-talk.baseUrl：Nextcloud 实例 URL。
  • channels.nextcloud-talk.botSecret：机器人共享密钥（shared secret）。
  • 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：直接消息（DM）允许列表（用户 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：直接消息（DM）历史限制（0 禁用）。
  • channels.nextcloud-talk.dms：每个直接消息覆盖（historyLimit）。
  • channels.nextcloud-talk.textChunkLimit：出站文本块大小（字符）。
  • channels.nextcloud-talk.chunkMode：length（默认）或 newline 在长度分块前按空白行（段落边界）拆分。
  • channels.nextcloud-talk.blockStreaming：禁用此频道的块流式传输（block streaming）。
  • channels.nextcloud-talk.blockStreamingCoalesce：块流式传输合并调优。
  • channels.nextcloud-talk.mediaMaxMb：入站媒体上限（MB）。
← 返回文档首页