openclaw-nextcloud

What This Skill Does

The OpenClaw Nextcloud skill provides a powerful interface to manage your Nextcloud instance directly through the OpenClaw AI agent. It allows you to seamlessly interact with various Nextcloud features, including Notes, Tasks (Todos), Calendar events, Files, and Contacts. Leveraging Nextcloud's robust APIs such as CalDAV, WebDAV, and CardDAV, this skill enables you to perform a wide range of actions without needing to access the Nextcloud web interface or client applications directly.

Key functionalities include creating, reading, updating, and deleting notes, managing your to-do lists and calendar appointments, uploading, downloading, searching, and deleting files within your Nextcloud storage, and handling your contact information. The skill supports both read and write operations for all these features, making it a comprehensive tool for users who rely on Nextcloud for their personal and professional organization.

Installation

To install the OpenClaw Nextcloud skill, you will need to configure your Nextcloud instance with the necessary credentials. The skill requires the following environment variables to be set:

• NEXTCLOUD_URL: The base URL of your Nextcloud instance (e.g., https://cloud.example.com).
• NEXTCLOUD_USER: Your Nextcloud username.
• NEXTCLOUD_TOKEN: It is highly recommended to use an App Password generated from your Nextcloud security settings. Alternatively, you can use your login password, but this is less secure.

Once the environment variables are configured, you can install the skill using the following command:

clawhub install openclaw/skills/skills/keithvassallomt/openclaw-nextcloud

Use Cases

This skill is ideal for users who want to integrate their Nextcloud data into their AI workflows. Some common use cases include:

• Quick Note Taking: Create and save notes on the go without opening your browser.
• Task Management: Add new tasks to your Nextcloud todo list, set due dates, and priorities, or mark tasks as complete.
• Calendar Coordination: Schedule new events, view upcoming appointments, or modify existing entries in your Nextcloud calendar.
• File Management: Upload important documents to your Nextcloud storage, download files for offline access, or quickly find specific files.
• Contact Organization: Add new contacts, update existing ones, or search your address book for contact details.

Example Prompts

• "Create a new note in Nextcloud titled 'Meeting Summary' with the content 'Discussed Q3 roadmap and budget.'"
• "Add a task to my Nextcloud calendar called 'Prepare presentation' due next Friday with high priority."
• "List all files in my 'Documents/Projects' folder in Nextcloud and upload the file named 'invoice.pdf' from my local downloads folder to the same directory."

Tips & Limitations

• App Passwords: For enhanced security, always use Nextcloud App Passwords instead of your main login password. You can generate these in your Nextcloud account settings under Security.
• Date Formats: When specifying dates for tasks or calendar events, use the ISO 8601 format (e.g., YYYY-MM-DDTHH:MM:SSZ).
• Error Handling: The skill provides JSON output for all operations. Review the output carefully for any errors or confirmation messages.
• API Limits: Be mindful of any rate limits imposed by your Nextcloud server, especially when performing bulk operations.
• Complex Queries: While the skill supports searching for files and contacts, very complex or ambiguous search queries might require refinement.
• Permissions: Ensure the user account or App Password used has the necessary permissions to access and modify the specific Nextcloud data (notes, calendar, files, etc.).