Nextcloud

Nextcloud Skill

Full Nextcloud client: WebDAV (files/folders) + OCS (sharing, tags, user info). Credentials: ~/.openclaw/secrets/nextcloud_creds · Config: config.json in skill dir.

Trigger phrases

Load this skill immediately when the user says anything like:

• "upload / save / write this file on Nextcloud / NC / cloud"
• "create a folder on Nextcloud", "mkdir in NC"
• "share this / create a share link / get a public link for [file or folder]"
• "list / browse / show what's in [folder] on Nextcloud"
• "search for [file] in NC", "find [file] on Nextcloud"
• "read / get / download [file] from Nextcloud"
• "rename / move / copy [file] on Nextcloud"
• "check my storage quota", "how much space on NC"
• "tag this file", "mark as favorite on Nextcloud"

Quick Start

python3 scripts/nextcloud.py config    # verify credentials + active config
python3 scripts/nextcloud.py quota     # test connection + show storage
python3 scripts/nextcloud.py ls /      # list root directory

Setup

pip install requests           # install dependency first (setup.py does not run pip)
python3 scripts/setup.py       # interactive: credentials + permissions + connection test
python3 scripts/init.py        # validate all configured permissions against live instance

init.py only runs write/delete tests when both allow_write=true and allow_delete=true. When allow_delete=false, write tests are skipped — no test artifacts are created or left behind.

Manual — ~/.openclaw/secrets/nextcloud_creds (chmod 600):

NC_URL=https://cloud.example.com
NC_USER=username
NC_PASS=app-password

App password: Nextcloud → Settings → Security → App passwords.

config.json — behavior restrictions:

Safe defaults: allow_delete is false by default — enable explicitly only when needed. Combine with a restricted base_path (e.g. "/Jarvis") to limit the agent's scope.

Module usage

from scripts.nextcloud import NextcloudClient
nc = NextcloudClient()
nc.write_file("/Jarvis/notes.md", "# Notes\n...")
nc.mkdir("/Jarvis/Articles")
link = nc.create_share_link("/Jarvis/report.pdf")
print(link["url"])

CLI reference

# Files & folders
python3 scripts/nextcloud.py mkdir /path/folder
python3 scripts/nextcloud.py write /path/file.md --content "# Title"
python3 scripts/nextcloud.py write /path/file.md --file local.md
python3 scripts/nextcloud.py read  /path/file.md
python3 scripts/nextcloud.py rename /old /new
python3 scripts/nextcloud.py copy   /src /dst
python3 scripts/nextcloud.py delete /path
python3 scripts/nextcloud.py exists /path          # exit 0/1

# Listing & search
python3 scripts/nextcloud.py ls /path --depth 2 --json
python3 scripts/nextcloud.py search "keyword" --path /folder --limit 20

# Favorites & tags
python3 scripts/nextcloud.py favorite /path/file.md
python3 scripts/nextcloud.py tags
python3 scripts/nextcloud.py tag-create "research"
python3 scripts/nextcloud.py tag-assign <file_id> <tag_id>

# Sharing
python3 scripts/nextcloud.py share /path                     # read-only public link
python3 scripts/nextcloud.py share /path --permissions 31 --expire 2025-12-31
python3 scripts/nextcloud.py share /path --password secret --no-download
python3 scripts/nextcloud.py shares /path                    # list existing shares
python3 scripts/nextcloud.py share-delete <share_id>

# Account
python3 scripts/nextcloud.py quota
python3 scripts/nextcloud.py config

Templates

Save a report and share it

nc = NextcloudClient()
nc.mkdir("/Reports/2025")
nc.write_file("/Reports/2025/summary.md", report_content)
link = nc.create_share_link("/Reports/2025/summary.md", permissions=1)
# → return link["url"] to the user

Structured workspace setup

python3 scripts/nc_setup.py --root Jarvis --folders Articles,LinkedIn,Recherche,Veille

Append to a running log

nc.append_to_file("/Jarvis/log.md", f"\n## {today}\n{entry}\n")

Read and update a JSON list

items = nc.read_json("/Jarvis/Veille/articles.json")
items["articles"].append(new_article)
nc.write_json("/Jarvis/Veille/articles.json", items)

Tag a file after creation

ls = nc.list_dir("/Jarvis/Articles", depth=1)
file_id = next(f["file_id"] for f in ls if f["name"] == "article.md")
tags = nc.get_tags()
tag_id = next(t["id"] for t in tags if t["name"] == "published")
nc.assign_tag(file_id, tag_id)

Ideas

• Sandbox the agent with base_path: "/Jarvis" — it can't touch anything else
• Store agent-produced Markdown files and auto-share a read-only link in the reply
• Use append_to_file for rolling logs or changelogs
• Use write_json + read_json for persistent state between sessions
• Auto-tag files by category (research / draft / published)

Share permissions

1=Read · 2=Update · 4=Create · 8=Delete · 16=Share · 31=All

Combine with

API reference

See references/api.md for WebDAV/OCS endpoint details, PROPFIND properties, and error codes.

Troubleshooting

See references/troubleshooting.md for common errors and fixes.