nextcloud

What This Skill Does

The Nextcloud skill for OpenClaw provides a robust interface for interacting with Nextcloud instances via the WebDAV protocol. It acts as a bridge between your local environment and your cloud storage, enabling seamless file management, synchronization, and workflow automation. Whether you are managing document repositories, syncing project files for local RAG (Retrieval-Augmented Generation) indexing, or automating the collection of multimedia recordings, this tool simplifies complex WebDAV interactions into simple command-line and Python-based operations.

Installation

To integrate this skill into your OpenClaw ecosystem, execute the following command in your terminal: clawhub install openclaw/skills/skills/bshandley/nextcloud. Once installed, you must configure your instance credentials. This can be done either by running the nextcloud_helper.py setup command or by setting the environment variables NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_PASS, and NEXTCLOUD_RAG_PATH. Ensure you use a dedicated app password from your Nextcloud security settings rather than your primary login password for optimal security.

Use Cases

This skill is highly versatile and fits into several common operational patterns. Firstly, it is ideal for maintaining local mirrors of cloud-based documentation for offline or high-speed RAG indexing. By syncing specific folders to your local path, your AI agent can process large document sets without latency. Secondly, it is perfect for content creators who need to move recordings from local devices to cloud storage automatically. Finally, it serves as a reliable automation tool for system administrators managing file backups or data organization across shared cloud environments.

Example Prompts

1. "OpenClaw, please sync the contents of my 'Projects/Q4' folder from Nextcloud to my local RAG directory so I can query those documents."
2. "Find all MP3 files in the 'Recordings' folder uploaded within the last 24 hours and move them to the 'Processed' directory."
3. "Upload the report file in my documents folder to the 'Archive' folder on Nextcloud and confirm the transfer was successful."

Tips & Limitations

When dealing with large files, specifically those exceeding 50MB, always remember to utilize the --http11 flag to prevent protocol-related connection drops, which are a common limitation of HTTP/2 handling in certain network environments. If you encounter authentication issues, verify that your account has sufficient permissions to access the specified WebDAV path. For advanced automation, leverage the internal find_files_by_ext function to filter your cloud contents dynamically before initiating batch processing tasks, which saves bandwidth and processing time.