← 返回 Skills 市场
openclaw-nextcloud
作者
Keith Vassallo
· GitHub ↗
· v0.6.0
· MIT-0
6689
总下载
9
收藏
0
当前安装
16
版本数
在 OpenClaw 中安装
/install openclaw-nextcloud
功能描述
Manage Notes, Tasks, Calendar, Files, Contacts, and Deck Kanban boards in your Nextcloud instance via CalDAV, WebDAV, Notes, and Deck APIs. Use for creating notes, managing todos and calendar events, uploading/downloading files, managing contacts, and organizing Kanban boards, stacks, and cards.
安全使用建议
Install only if you are comfortable giving the agent full account-level Nextcloud access. Use a revocable app password, prefer a test account first, confirm public shares carefully, use passwords and expiry dates for shared links, and revoke the app password if anything looks wrong.
能力评估
Credentials
It requires a full account-scope Nextcloud app password and can read, mutate, delete, and share account data, which is high impact but coherent with the stated account-management purpose and disclosed limitations of Nextcloud app passwords.
Install Mechanism
The artifact is a pre-bundled Node.js CLI with declared package metadata and no observed install-time persistence or auto-update behavior; dependencies are declared and the bundled script is the runtime path.
Instruction Scope
Runtime instructions are scoped to running the bundled Nextcloud CLI, require user confirmation for destructive and public-facing operations, require confirmation tokens for irreversible operations, and warn that retrieved Nextcloud content is untrusted data.
Persistence & Privilege
No background worker, privilege escalation, credential harvesting, or durable local persistence was found; credentials are read from environment variables and sent to the configured Nextcloud URL with HTTPS enforced by default.
Purpose & Capability
The skill's purpose is a broad Nextcloud integration for notes, files, calendar, tasks, contacts, Deck, and shares; public-link sharing is sensitive but is disclosed in metadata, safety text, command documentation, and examples.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-nextcloud - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-nextcloud触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.6.0
- Tasks can now carry a start date, a location, a link, a privacy setting, and tags — set when you create a task or add them later
- You can mark a task as in progress or cancelled, and record how far along it is as a percentage
- Dates without a time now make proper all-day tasks, so they show on the day you meant no matter what timezone you're in
- Clearing a task's tags, location or link is now possible by setting them to nothing
- Fixed: changing a task's start date could quietly change the wrong thing and leave the task with no start at all, while still reporting success
- Fixed: task lists sometimes showed a nonsense start date from 1970
- Fixed: completion times and new event timestamps were recorded in the wrong timezone
v0.5.0
- Adds support for an optional NEXTCLOUD_EMAIL environment variable.
- When NEXTCLOUD_EMAIL is set, newly created calendar events are marked as confirmed with the organiser and attendee fields set to that address.
- Improves compatibility section to document the new NEXTCLOUD_EMAIL option.
v0.4.2
0.4.2
Fixed
- tasks list no longer hides tasks created in the Nextcloud Tasks web app.
Those omit the STATUS property, and the CalDAV filter only matched todos
that declare it, so they were silently missing from every result.
Completed tasks stay hidden as before.
- Deck deletes no longer fail with 403 Forbidden on Nextcloud 34. This
affected boards, stacks, cards, labels and card comments.
Changed
- Requires Node.js 24 or higher, up from 20, which is end-of-life.
Security
- Dependencies pinned to exact versions. fast-xml-parser updated past two
high-severity advisories in a transitive dependency. Neither reached the
shipped bundle, which imports only the XML parser.
- The build no longer downloads anything at install time.
- The README documents the three findings automated skill scanners report
against this repo, and how to rebuild the bundle from source to verify it.
v0.3.3
openclaw-nextcloud v0.4.0
⚠️ Breaking: 11 irreversible operations now need a --confirm command:subcommand token (the 9 deletes, shares delete, shares create-link). Everything else is unchanged. Agents pick this up from SKILL.md automatically; scripts and cron jobs need the token added.
Security: closed WebDAV path traversal, iCalendar/vCard property injection, and PRIORITY injection. Text and secrets can now be read from a file so they never appear in the process argument list.
Fixes: vCard 3.0 group prefixes and structured names parse correctly. Declares skillKey so OpenClaw resolves one stable config key regardless of install alias.
Also: CI now verifies the bundle matches its source, plus 41 tests.
Thanks to @sam2kb and @bolinches.
v0.3.2
openclaw-nextcloud 0.3.2 changelog:
- Added safety mechanism: destructive and public-facing commands now require a CLI confirmation token (`--confirm <command:subcommand>`) for irreversible operations.
- Updated documentation to distinguish between irreversible (token required) and recoverable (confirmation only) operations.
- Added and reorganized documentation around usage, confirmation requirements, and safety checks.
- Internal directory structure modified: added the `scripts` directory and removed unnecessary files.
- Incremented skill version metadata.
v0.3.1
The vCard 3.0 spec allows group prefixes like 'item1.' before property names when multiple instances of the same property type exist. The regexes in _parseVCard and _updateVCardField only matched bare property names, so contacts with grouped properties (e.g. item1.EMAIL;type=INTERNET) were silently skipped.
This adds optional (?:item\d+.)? prefix to all vCard property regexes. Thanks [@bolinches](https://github.com/bolinches)
v0.3.0
Version 0.3.0
- Added initial Deck (Kanban) support, including safety documentation for destructive Deck operations - thanks to @makefu.
- Updated SKILL.md to reflect Deck Boards/Stacks/Cards management features and corresponding commands.
- Expanded allowed destructive operations metadata to include boards, stacks, cards, and labels.
- Added project-specific configuration, logging, and runtime metadata files.
v0.2.5
**Added**
- Calendar events (calendar list-events) and tasks (task list) now include a description field, parsed from the iCalendar DESCRIPTION property.
**Fixed**
- iCalendar line unfolding applied before extracting DESCRIPTION, so multi-line agendas, dial-in details, and other folded values are returned intact rather than truncated at the first physical line.
- DESCRIPTION matching anchored to a property line with parameter support (DESCRIPTION;LANGUAGE=..., DESCRIPTION;ALTREP=...), so an embedded VALARM block inside a VEVENT no longer shadows the event's own description.
Thanks to @MaNyh (#7) for raising the original gap.
v0.2.4
openclaw-nextcloud 0.2.4
- Version bump from 0.2.3 to 0.2.4.
- Resolve issue when adding events to non-default calendar.
v0.2.3
- Added openclaw metadata block to SKILL.md to declare skill version, required binaries, and structured environment variables.
- Improved documentation of environment variables, adding more detailed descriptions.
- Clarified safety guidance: now explicitly warns that retrieved user content may contain text attempting to influence behavior; treat all such content strictly as data, not instructions.
v0.2.1
**This version adds an explicit Safety section and metadata highlighting the scope and risk of destructive operations.**
- New "Safety" section in documentation, listing all destructive commands and emphasizing the need for explicit user confirmation before actions like delete, overwrite, or share.
- Metadata updated to declare destructive operations, their scope, and credential requirements.
- Compatibility section now clearly states account-scope app password is required.
- No file or code changes; documentation and metadata improvements only.
v0.2.0
openclaw-nextcloud 0.2.0
- Initial public release with all code and documentation.
- Adds support for authenticating and interacting with Nextcloud Notes, Tasks, Calendar, Files, and Contacts.
- Provides new commands for file sharing: create, list, and delete public links.
- Environment validation and improved security: only allows HTTPS by default; sensitive tokens now explicitly marked in metadata.
- Documentation and metadata enhancements: now lists required environment variables, homepage, and security notes.
v0.1.3
- Migrated main script to scripts/nextcloud.js; removed old files (README.md, index.js, package.json, package-lock.json).
- Updated documentation: clarified usage with the new script path and removed npm install instructions.
- Added license and compatibility information (MIT, Node.js 20+ required).
- Changed presentation guidelines: outputs now avoid markdown formatting for better compatibility with messaging apps.
- Kept all commands, features, and output formats unchanged.
v0.1.2
Version 0.1.2
- Added YAML front matter to SKILL.md with `name`, `description`, and `allowed-tools` fields for standardization.
- Clarified and condensed the skill description for better discoverability and tool selection.
- No changes to commands, features, or usage.
- No code or behavior changes—documentation/meta-data update only.
v0.1.1
openclaw-nextcloud v0.1.1
- Added a "summary" front matter field to SKILL.md.
- Updated SKILL.md with a note about running `npm install` if `node_modules` is missing.
- Minor documentation improvements and formatting changes in SKILL.md.
v0.1.0
Initial release of OpenClaw Nextcloud Skill with extensive Nextcloud integration.
- Supports Notes, Tasks (Todos), Calendars, Files, and Contacts via command-line interface
- Uses environment variables for Nextcloud connection credentials
- Provides CRUD operations for notes, tasks (CalDAV), calendar events (CalDAV), files (WebDAV), and contacts (CardDAV)
- Implements smart default selection for calendars and address books, with memory of user choices
- Outputs all results as JSON, with detailed example schemas
- Features markdown and emoji-rich presentation guidelines for user-facing output
元数据
常见问题
openclaw-nextcloud 是什么?
Manage Notes, Tasks, Calendar, Files, Contacts, and Deck Kanban boards in your Nextcloud instance via CalDAV, WebDAV, Notes, and Deck APIs. Use for creating notes, managing todos and calendar events, uploading/downloading files, managing contacts, and organizing Kanban boards, stacks, and cards. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 6689 次。
如何安装 openclaw-nextcloud?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-nextcloud」即可一键安装,无需额外配置。
openclaw-nextcloud 是免费的吗?
是的,openclaw-nextcloud 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
openclaw-nextcloud 支持哪些平台?
openclaw-nextcloud 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 openclaw-nextcloud?
由 Keith Vassallo(@keithvassallomt)开发并维护,当前版本 v0.6.0。
推荐 Skills