OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

消息平台

Nextcloud Talk

Nextcloud Talk 是一个可下载的渠道插件（@openclaw/nextcloud-talk），它通过 Talk webhook Bot 将 OpenClaw 连接到自托管的 Nextcloud 实例。支持私信、房间、表情回应和 Markdown 消息；媒体以 URL 形式发送。

安装

bash
openclaw plugins install @openclaw/nextcloud-talk

使用不带版本号的软件包说明符可跟随当前官方发布标签。仅当需要可复现安装时，才固定到确切版本。

从本地检出安装（开发工作流）：

bash
openclaw plugins install ./path/to/local/nextcloud-talk-plugin

安装后重启 Gateway 网关。详情：插件

快速设置（初学者）

  1. 安装插件（见上文）。

  2. 在你的 Nextcloud 服务器上创建一个 Bot：

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

    保留 --feature response：没有它，出站回复会失败并返回 401。使用 ./occ talk:bot:state --feature webhook --feature response --feature reaction <botId> 1 修复现有 Bot。

  3. 在目标房间设置中启用该 Bot。

  4. 配置 OpenClaw：

    • 配置：channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
    • 或使用环境变量：NEXTCLOUD_TALK_BOT_SECRET（仅适用于默认账户）

    CLI 设置（--url/--token 是显式字段的别名；nc-talk 和 nc 可用作渠道别名）：

    bash
    openclaw channels add --channel nextcloud-talk \  --url https://cloud.example.com \  --token "<shared-secret>"

    等效的显式字段：

    bash
    openclaw channels add --channel nextcloud-talk \  --base-url https://cloud.example.com \  --secret "<shared-secret>"

    基于文件的密钥：

    bash
    openclaw channels add --channel nextcloud-talk \  --base-url https://cloud.example.com \  --secret-file /path/to/nextcloud-talk-secret

  5. 重启 Gateway 网关（或完成设置）。

最小配置：

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

注意事项

  • Bot 无法主动发起私信。用户必须先向 Bot 发送消息。
  • Nextcloud 服务器必须能够访问 webhook URL；当 Gateway 网关位于代理之后时，请设置 webhookPublicUrl。Webhook 请求使用 Bot 密钥进行 HMAC-SHA256 签名；签名无效的请求会被拒绝并受到速率限制。
  • Bot API 不支持媒体上传；出站媒体会以 Attachment: <url> 行的形式附加。
  • Webhook 载荷不会区分私信和房间；设置 apiUser + apiPassword 可启用房间类型查询（缓存约 5 分钟）。若未设置，所有对话都会被视为房间。
  • 出站请求会经过 SSRF 防护。对于位于受信任的专用/内部网络中的 Nextcloud 主机，请通过 channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: true 明确启用。
  • 设置 apiUser/apiPassword 和 webhookPublicUrl 后，openclaw channels status 会探测 Bot，并在缺少 response 功能时发出警告。

访问控制（私信）

  • 默认值：channels.nextcloud-talk.dmPolicy = "pairing"。未知发送者会收到配对码。
  • 批准方式：
    • openclaw pairing list nextcloud-talk
    • openclaw pairing approve nextcloud-talk &lt;CODE&gt;
  • 公开私信：channels.nextcloud-talk.dmPolicy="open" 加上 channels.nextcloud-talk.allowFrom=["*"]。
  • allowFrom 仅匹配 Nextcloud 用户 ID（转换为小写）；显示名称会被忽略。

房间（群组）

  • 默认值：channels.nextcloud-talk.groupPolicy = "allowlist"（需要提及）。
  • 使用 channels.nextcloud-talk.rooms 设置房间允许列表，以房间令牌为键；"*" 设置通配符默认值：
json5
{  channels: {    "nextcloud-talk": {      rooms: {        "room-token": { requireMention: true },      },    },  },}
  • 每个房间的键：requireMention（默认为 true）、enabled（false 会禁用该房间）、allowFrom（每个房间的发送者允许列表）、tools（允许/拒绝工具覆盖）、skills（限制加载的 Skills）、systemPrompt。
  • 若不允许任何房间，请保持允许列表为空或设置 channels.nextcloud-talk.groupPolicy="disabled"。

能力

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

配置参考（Nextcloud Talk）

完整配置：配置

提供商选项：

  • 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（默认值：pairing）。open 需要 allowFrom=["*"]。
  • channels.nextcloud-talk.allowFrom：私信允许列表（用户 ID）。
  • channels.nextcloud-talk.groupPolicy：allowlist | open | disabled（默认值：allowlist）。
  • channels.nextcloud-talk.groupAllowFrom：房间发送者允许列表（用户 ID）；未设置时回退到 allowFrom。
  • channels.nextcloud-talk.rooms：每个房间的设置和允许列表（见上文）。
  • 可以使用 accessGroup:<name>，从 allowFrom 和 groupAllowFrom 引用静态发送者访问组。
  • channels.nextcloud-talk.historyLimit：群组历史记录限制（0 表示禁用）。
  • channels.nextcloud-talk.dmHistoryLimit：私信历史记录限制（0 表示禁用）。
  • channels.nextcloud-talk.dms：按用户 ID 设置的每私信覆盖项（historyLimit）。
  • channels.nextcloud-talk.textChunkLimit：出站文本分块字符数（默认值：4000）。
  • channels.nextcloud-talk.streaming.chunkMode：length（默认值），或使用 newline 在按长度分块之前按空行（段落边界）拆分。
  • channels.nextcloud-talk.streaming.block.enabled：为此渠道启用或禁用分块流式传输。
  • channels.nextcloud-talk.streaming.block.coalesce：分块流式传输合并调优。
  • channels.nextcloud-talk.responsePrefix：出站回复前缀。
  • channels.nextcloud-talk.markdown.tables：Markdown 表格渲染模式（off | bullets | code | block）。
  • channels.nextcloud-talk.mediaMaxMb：入站媒体上限（MB）。
  • channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork：允许专用/内部 Nextcloud 主机通过 SSRF 防护。
  • channels.nextcloud-talk.accounts.<id>：每账户覆盖项（相同键）；defaultAccount 用于选择默认账户。环境变量 NEXTCLOUD_TALK_BOT_SECRET / NEXTCLOUD_TALK_API_PASSWORD 仅适用于默认账户。

相关内容

Was this useful?
On this page

On this page