核心用法
OpenClaw Nextcloud Skill 是一款面向 Nextcloud 自托管用户的全能型集成工具，通过标准化的 CalDAV、WebDAV 及 Notes API 提供五大核心模块的读写能力：
- 笔记管理：完整的增删改查，支持分类标签
- 任务/待办：基于 CalDAV VTODO 的优先级管理、截止日期追踪与完成状态切换
- 日历事件：基于 CalDAV VEVENT 的日程创建与编辑，支持地点与描述
- 文件操作：WebDAV 驱动的上传下载、搜索、目录浏览，自动生成可分享的内链
- 联系人管理：CardDAV 支持的 vCard 标准操作，含多邮箱/电话字段
技能采用命令行交互模式，所有输出均为结构化 JSON，便于程序解析。运行时仅需配置三个环境变量（URL、用户名、应用密码），网络出口严格限定于目标 Nextcloud 实例。
显著优点
1. 协议标准化：基于行业通用的 DAV 协议族，不依赖 Nextcloud 特定插件，兼容性好
2. 安全设计：强制 HTTPS（可本地覆盖）、使用可撤销的应用密码而非主凭证、最小网络权限原则
3. 智能交互：内置"默认日历/地址簿"记忆机制，减少重复选择，首次使用后自动记住用户偏好
4. 输出友好：专为消息平台优化的纯文本+emoji 格式，自动转换技术日期为人可读形式
5. 功能完整：覆盖分享链接创建（含密码保护与过期设置）、文件 ID 内链生成等进阶场景
潜在局限
- 环境依赖：要求 Node.js 20+，对轻量级部署环境可能构成门槛
- 无实时同步：基于请求-响应模式，不具备 WebSocket 或推送通知能力
- 单实例限制：当前设计仅支持单一 Nextcloud 实例，多账户切换需重新配置环境变量
- 错误粒度：DAV 协议的错误信息可能较为底层，需用户具备一定排障能力
适合人群
- 已部署 Nextcloud 的个人或小型团队用户
- 需要在 CLI/自动化场景中集成云存储、日程与联系人管理的技术用户
- 重视数据主权、倾向自托管而非公有云服务的隐私敏感群体
常规风险
| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| 凭证泄露 | NEXTCLOUD_TOKEN 如泄露可导致账户被滥用 | 使用应用密码、定期轮换、配置为 secret-env |
| 中间人攻击 | 自签证书或配置不当的 TLS | 强制证书验证，避免生产环境使用 OPENCLAW_ALLOW_HTTP |
| 误操作数据丢失 | 删除操作不可逆 | 依赖 Nextcloud 服务端版本控制与回收站机制 |
| 权限过度 | 应用密码权限等同于用户权限 | 建议创建最小权限专用账户 |
整体而言，该技能在功能完整性、安全设计与用户体验之间取得了良好平衡，是 Nextcloud 生态中较为成熟的 CLI 集成方案。