Nextcloud 是全球最流行的自托管云平台, Nextcloud Talk 是其内置的视频会议和即时聊天模块。 OpenClaw 接入后,AI 助手可以直接在你的 Nextcloud 环境里工作。
Nextcloud Talk 的特点
自托管:
服务器在你自己手里,数据不出内网
适合对数据主权有要求的企业和个人
功能集成:
聊天 + 视频会议 + 文件协作 = 一体化平台
AI 可以访问 Nextcloud 文件、日历、联系人
安装插件
bash
openclaw plugins install @openclaw/nextcloud-talk在 Nextcloud 创建 Bot
需要通过 Nextcloud 服务器的 occ CLI(命令行工具)创建 Bot:
bash
# SSH 到 Nextcloud 服务器
ssh user@your-nextcloud-server
# 安装 Bot(替换占位符)
sudo -u www-data php /var/www/nextcloud/occ talk:bot:install "OpenClaw AI" "your-shared-secret-here" "https://your-gateway.com/api/channels/nextcloud-talk/webhook" --feature reaction参数说明:
"OpenClaw AI":Bot 显示名称"your-shared-secret":用于请求签名验证的密钥(自定义,保存好)- Webhook URL:OpenClaw Gateway 的接收地址
--feature reaction:启用表情反应功能
在 Talk 房间中启用 Bot:
打开 Nextcloud Talk → 进入目标房间
右上角设置 → 聊天机器人 → 启用 OpenClaw AI
配置 OpenClaw
json
{
"channels": {
"nextcloudtalk": {
"enabled": true,
"serverUrl": "https://your-nextcloud.com",
"username": "openclaw-bot",
"appPassword": "xxxx-xxxx-xxxx-xxxx",
"sharedSecret": "your-shared-secret",
"dmPolicy": "pairing"
}
}
}appPassword 获取方式:
Nextcloud → 右上角用户头像 → 设置 → 安全
→ 应用密码 → 创建新密码(名称:OpenClaw)
→ 复制生成的密码(仅显示一次)
内网部署注意事项
局域网场景(Nextcloud 和 Gateway 在同一内网):
Webhook URL 用内网 IP:
http://192.168.1.200:18789/api/channels/nextcloud-talk/webhook
外网访问场景:
Nextcloud 必须能访问 Gateway 的 Webhook URL
建议用 Tailscale 或 Cloudflare Tunnel 打通
避免直接暴露 Gateway 端口到公网
DM 与房间访问控制
json
{
"nextcloudtalk": {
"dmPolicy": "allowlist",
"allowedUsers": ["alice", "bob"],
"rooms": {
"default": {
"requireMention": true
},
"engineering-room-token": {
"requireMention": false,
"allowedUsers": ["dev-team"]
}
}
}
}支持的功能
| 功能 | 支持 |
|---|---|
| 文字消息 | ✅ |
| Markdown 格式 | ✅ |
| 表情反应(Reactions) | ✅(需 --feature reaction) |
| 图片/文件消息 | ✅ 接收 |
| 语音消息 | ✅ 接收/分析 |
| 回复(Reply to) | ✅ |
典型 AI 使用场景
会议摘要
会议结束后在 Talk 频道发:
@ai 帮我总结一下刚才讨论的决策要点
AI:刚才会议讨论了以下内容:
1. Q2 发布计划推迟到 5 月 15 日
2. 移动端优先于 Web 端
3. 下次会议:周五 14:00
Nextcloud 文件问答
@ai /files/报告/2026Q1财务报告.xlsx 里面
净利润同比变化是多少?
AI:[读取文件] Q1 净利润 230 万元,
同比增长 18.5%(去年 Q1 为 194 万元)
任务分派
@ai 把刚才讨论的 3 个 Action Items 创建成 Nextcloud Tasks
AI:已创建 3 个任务:
✅ 更新 API 文档(负责人:张三,截止:4/1)
✅ 修复移动端 Bug #234(负责人:李四,截止:3/28)
✅ 准备 Q2 计划 PPT(负责人:王五,截止:4/5)
来源:OpenClaw 官方文档 - docs.openclaw.ai/channels/nextcloud-talk