openclaw 文档

简体中文

English

简体中文

English

Appearance

Nextcloud Talk (插件) ​

状态：通过插件支持 (webhook 机器人)。支持私聊、群聊、表情回复和 Markdown 消息。

需要插件 ​

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

通过 CLI 安装 (npm 注册表):

bash
openclaw plugins install @openclaw/nextcloud-talk

本地检出 (从 git 仓库运行时):

bash
openclaw plugins install ./extensions/nextcloud-talk

如果在配置/引导过程中选择 Nextcloud Talk 并检测到 git 检出， openclaw 会自动提供本地安装路径。

详情: 插件

快速设置 (初学者) ​

  1. 安装 Nextcloud Talk 插件。
  2. 在您的 Nextcloud 服务器上创建机器人:
    bash
    ./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. 重启网关 (或完成引导)。

最小配置:

json5
{
  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=["*"]。

房间 (群组) ​

  • 默认: channels.nextcloud-talk.groupPolicy = "allowlist" (提及门控)。
  • 使用 channels.nextcloud-talk.rooms 设置允许列表:
json5
{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true }
      }
    }
  }
}
  • 要禁止所有房间，保持允许列表为空或设置 channels.nextcloud-talk.groupPolicy="disabled"。

功能特性 ​

功能状态
私聊支持
群聊支持
线程不支持
媒体仅限 URL
表情回复支持
原生命令不支持

配置参考 (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)。