] [--priority ] [--description ]`\n- `tasks edit --uid [--calendar ] [--title ] [--due ] [--priority ] [--description ]`\n- `tasks delete --uid [--calendar ]`\n- `tasks complete --uid [--calendar ]`\n\n### Calendar Events\n- `calendar list [--from ] [--to ]` (Defaults to next 7 days)\n- `calendar create --summary --start --end [--calendar ] [--description ]`\n- `calendar edit --uid [--calendar ] [--summary ] [--start ] [--end ] [--description ]`\n- `calendar delete --uid [--calendar ]`\n\n### Calendars (list available calendars)\n- `calendars list [--type ]`\n\n### Files\n- `files list [--path ]`\n- `files search --query `\n- `files get --path ` (download file content)\n- `files upload --path --content `\n- `files delete --path `\n\n### Contacts\n- `contacts list [--addressbook ]`\n- `contacts get --uid [--addressbook ]`\n- `contacts search --query [--addressbook ]`\n- `contacts create --name [--addressbook ] [--email ] [--phone ] [--organization ] [--title ] [--note ]`\n- `contacts edit --uid [--addressbook ] [--name ] [--email ] [--phone ] [--organization ] [--title ] [--note ]`\n- `contacts delete --uid [--addressbook ]`\n\n### Address Books (list available address books)\n- `addressbooks list`\n\n## Output Format\n\nAll outputs are JSON formatted.\n\n### Tasks List Output\n```json\n{\n \"status\": \"success\",\n \"data\": [\n {\n \"uid\": \"unique-task-id\",\n \"calendar\": \"Calendar Name\",\n \"summary\": \"Task title\",\n \"status\": \"NEEDS-ACTION\",\n \"due\": \"20260201T153000Z\",\n \"priority\": 0\n }\n ]\n}\n```\n- `due`: CalDAV format date (YYYYMMDDTHHmmssZ) or null\n- `priority`: 0-9 (0 = undefined, 1 = highest, 9 = lowest) or null\n\n### Calendar Events List Output\n```json\n{\n \"status\": \"success\",\n \"data\": [\n {\n \"uid\": \"unique-event-id\",\n \"calendar\": \"Calendar Name\",\n \"summary\": \"Event title\",\n \"start\": \"20260205T100000Z\",\n \"end\": \"20260205T110000Z\"\n }\n ]\n}\n```\n\n### Contacts List Output\n```json\n{\n \"status\": \"success\",\n \"data\": [\n {\n \"uid\": \"unique-contact-id\",\n \"addressBook\": \"Address Book Name\",\n \"fullName\": \"John Doe\",\n \"name\": \"Doe;John;;;\",\n \"phones\": [\"+1234567890\"],\n \"emails\": [\"john@example.com\"],\n \"organization\": \"ACME Inc\",\n \"title\": \"Developer\",\n \"note\": \"Met at conference\"\n }\n ]\n}\n```\n- `phones`: Array of phone numbers or null\n- `emails`: Array of email addresses or null\n- `name`: Structured name in vCard format (Last;First;Middle;Prefix;Suffix)\n\n### General Format\n```json\n{\n \"status\": \"success\",\n \"data\": [ ... ]\n}\n```\n\nor\n\n```json\n{\n \"status\": \"error\",\n \"message\": \"Error description\"\n}\n```\n\n## Agent Behavior: Default Calendar Selection\n\nWhen creating tasks or calendar events, if the user does not specify a calendar:\n\n1. **First time (no default set):**\n - Run `calendars list --type tasks` (for tasks) or `calendars list --type events` (for events)\n - Ask the user which calendar to use from the list\n - Ask if they want to set it as the default for future operations\n - Remember their choice in memory\n\n2. **If user sets a default:**\n - Remember `default_task_calendar` and/or `default_event_calendar`\n - Use automatically for subsequent operations without asking\n\n3. **If user declines to set a default:**\n - Ask again next time they create a task/event without specifying a calendar\n\n4. **User can always override:**\n - Explicitly specifying `--calendar` always takes precedence over the default\n\n### Memory Keys\n- `default_task_calendar`: Default calendar name for tasks (VTODO)\n- `default_event_calendar`: Default calendar name for events (VEVENT)\n\n## Agent Behavior: Default Address Book Selection\n\nWhen creating contacts, if the user does not specify an address book:\n\n1. **First time (no default set):**\n - Run `addressbooks list`\n - Ask the user which address book to use from the list\n - Ask if they want to set it as the default for future operations\n - Remember their choice in memory\n\n2. **If user sets a default:**\n - Remember `default_addressbook`\n - Use automatically for subsequent operations without asking\n\n3. **If user declines to set a default:**\n - Ask again next time they create a contact without specifying an address book\n\n4. **User can always override:**\n - Explicitly specifying `--addressbook` always takes precedence over the default\n\n### Memory Keys\n- `default_addressbook`: Default address book name for contacts\n\n## Agent Behavior: Presenting Information\n\nWhen displaying data to the user, format it in a readable way. Output may be sent to messaging platforms (Telegram, WhatsApp, etc.) where markdown does not render, so avoid markdown formatting.\n\n### General Guidelines\n- Use emojis to make output scannable and friendly\n- Do NOT use markdown formatting (no **bold**, *italic*, `code`, tables, or lists with - or *)\n- Use plain text with line breaks for structure\n- Convert technical formats (like CalDAV dates) to human-readable formats\n- Group related items logically\n\n### Emoji Reference\nTasks: â
(completed), ⏠(pending), đŽ (high priority), đĄ (medium), đą (low)\nCalendar: đ
(event), â° (time), đ (location)\nNotes: đ (note), đ (category)\nFiles: đ (file), đ (folder), đŸ (size)\nContacts: đ€ (person), đ§ (email), đ± (phone), đą (organization)\nStatus: âš (created), âïž (updated), đïž (deleted), â (error)\n\n### Example Presentations\n\nTasks:\n```\nđ Your Tasks\n\n⏠đŽ Buy groceries â Due: Tomorrow 3:30 PM\n⏠đĄ Review PR #42 â Due: Feb 5\nâ
Send email to client\n```\n\nCalendar Events:\n```\nđ
Upcoming Events\n\nđïž Team Standup\n â° Mon, Feb 3 âą 10:00 AM - 10:30 AM\n đ Zoom\n\nđïž Project Review\n â° Wed, Feb 5 âą 2:00 PM - 3:00 PM\n```\n\nContacts:\n```\nđ€ John Doe\n đ§ john@example.com\n đ± +1 234 567 890\n đą ACME Inc â Developer\n```\n\nFiles:\n```\nđ Documents/\n đ report.pdf (2.3 MB)\n đ notes.txt (4 KB)\n đ Archive/\n```\n\n### Date/Time Formatting\nConvert CalDAV format 20260205T100000Z to readable format like Wed, Feb 5 âą 10:00 AM\nShow relative dates when helpful: \"Tomorrow\", \"Next Monday\", \"In 3 days\"\nUse the user's local timezone when possible"}],"details":{"status":"completed","exitCode":0,"durationMs":8,"aggregated":"---\nname: openclaw-nextcloud\ndescription: Manage Notes, Tasks, Calendar, Files, and Contacts in your Nextcloud instance via CalDAV, WebDAV, and Notes API. Use for creating notes, managing todos and calendar events, uploading/downloading files, and managing contacts.\nlicense: MIT\ncompatibility: Requires Node.js 20+. Needs network access to Nextcloud instance.\nallowed-tools: Bash Read\n---\n\n# OpenClaw Nextcloud Skill\n\nThis skill provides integration with a Nextcloud instance. It supports access to Notes, Tasks (Todos), Calendars, Files, and Contacts.\n\n## Configuration\n\nThe skill requires the following environment variables:\n\n- `NEXTCLOUD_URL`: The base URL of your Nextcloud instance (e.g., `https://cloud.example.com`).\n- `NEXTCLOUD_USER`: Your Nextcloud username.\n- `NEXTCLOUD_TOKEN`: An App Password (recommended) or your login password.\n\n## Features\n\n### 1. Notes (Read/Write)\n- List, get, create, update, and delete notes.\n- API: `index.php/apps/notes/api/v1/notes`\n\n### 2. Tasks / Todos (Read/Write)\n- List, create, update, delete, and complete tasks.\n- API: CalDAV (VTODO).\n\n### 3. Calendar (Read/Write)\n- List, create, update, and delete events.\n- API: CalDAV (VEVENT).\n\n### 4. Files (Read/Write)\n- List, search, upload, download, and delete files.\n- API: WebDAV.\n\n### 5. Contacts (Read/Write)\n- List, get, create, update, delete, and search contacts.\n- API: CardDAV.\n\n## Usage\n\nRun the skill via the bundled script.\n\n```bash\nnode scripts/nextcloud.js [options]\n```\n\n## Commands\n\n### Notes\n- `notes list`\n- `notes get --id `\n- `notes create --title --content [--category ]`\n- `notes edit --id [--title