核心用法
OpenClaw Nextcloud Skill 是一个面向自托管云存储的集成工具，通过标准开放协议与Nextcloud实例交互。支持五大核心模块：
| 模块 | 协议 | 功能 |
|------|------|------|
| Notes | Notes API | 增删改查笔记，支持分类 |
| Tasks/Todos | CalDAV (VTODO) | 任务管理、优先级、截止日期、完成标记 |
| Calendar | CalDAV (VEVENT) | 事件日程管理 |
| Files | WebDAV | 文件上传下载、搜索、目录浏览 |
| Contacts | CardDAV | 联系人CRUD、多地址簿支持 |
认证方式：使用App Password（推荐）或用户密码，通过环境变量配置。
显著优点
1. 协议标准化：基于CalDAV/WebDAV/CardDAV等IETF标准协议，非私有API，可迁移性强
2. 数据主权：支持自托管Nextcloud，用户完全掌控数据存储位置
3. 离线优先设计：标准协议支持多端同步，不依赖单一服务商
4. 功能完备：覆盖个人生产力核心场景（笔记+任务+日历+文件+联系人）
5. Agent智能增强：内置默认日历/地址簿记忆机制，减少重复交互
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| 部署门槛 | 需要用户自建/维护Nextcloud实例，技术门槛高于SaaS方案 |
| 协议复杂度 | CalDAV日期格式（20260205T100000Z）非人类可读，需转换层 |
| 无实时同步 | 基于请求-响应模式，非WebSocket实时推送 |
| 依赖管理 | 需手动运行`npm install`，环境脆弱性 |
| 令牌安全 | App Password需妥善保管，泄露风险等同于账户权限 |
适合人群
- 隐私优先用户：拒绝商业云服务商数据收集
- 技术爱好者：已拥有或愿意维护Nextcloud/Owncloud实例
- 企业/团队：需合规内网部署的组织
- 去中心化倡导者：希望减少对Google/Microsoft生态依赖
常规风险
1. 凭证泄露：NEXTCLOUD_TOKEN环境变量若被注入日志或共享，可导致完整数据访问
2. 中间人攻击：若NEXTCLOUD_URL使用HTTP而非HTTPS，CalDAV/WebDAV传输暴露
3. 权限泛化：App Password通常拥有完整账户权限，无法细粒度限制（如只读日历）
4. 数据丢失：服务端无版本控制时，delete操作不可逆
5. 时区处理：CalDAV强制UTC格式，Agent需正确处理用户本地时区转换
使用建议
- 强制HTTPS端点
- 为Skill创建专用App Password（非主密码）
- 定期轮换令牌
- 生产环境建议配合Nextcloud的LDAP/SSO而非原生认证