Openclaw Nextcloud

Calendar / Address Book Names

--calendar and --addressbook accept any of: the exact display name, a case-insensitive display name, the URL slug (last path segment of the collection URL), or the full href / URL. If no match is found, the error message lists the available names.

Output Format

All outputs are JSON formatted.

Tasks List Output

{
  "status": "success",
  "data": [
    {
      "uid": "unique-task-id",
      "calendar": "Calendar Name",
      "summary": "Task title",
      "status": "NEEDS-ACTION",
      "due": "20260201T153000Z",
      "priority": 0
    }
  ]
}

Date inputs (--due, --start, --end, --from, --to) accept either ISO 8601 (2026-02-01T15:30:00Z) or the same compact CalDAV form shown in output (20260201T153000Z).

Calendar Events List Output

{
  "status": "success",
  "data": [
    {
      "uid": "unique-event-id",
      "calendar": "Calendar Name",
      "summary": "Event title",
      "start": "20260205T100000Z",
      "end": "20260205T110000Z",
      "location": "Conference Room B"
    }
  ]
}

Shares Output

{
  "status": "success",
  "data": {
    "id": "29",
    "path": "/Documents/Reports",
    "shareType": 3,
    "shareWith": null,
    "permissions": 1,
    "token": "K8XafX9fgk4n3LD",
    "url": "https://cloud.example.com/index.php/s/K8XafX9fgk4n3LD",
    "expireDate": null,
    "passwordProtected": false
  }
}

Contacts List Output

{
  "status": "success",
  "data": [
    {
      "uid": "unique-contact-id",
      "addressBook": "Address Book Name",
      "fullName": "John Doe",
      "name": "Doe;John;;;",
      "phones": ["+1234567890"],
      "emails": ["john@example.com"],
      "organization": "ACME Inc",
      "title": "Developer",
      "note": "Met at conference"
    }
  ]
}

General Format

{
  "status": "success",
  "data": [ ... ]
}

or

{
  "status": "error",
  "message": "Error description"
}

Agent Behavior: Default Calendar Selection

When creating tasks or calendar events, if the user does not specify a calendar:

1. First time (no default set): - Run calendars list --type tasks (for tasks) or calendars list --type events (for events) - Ask the user which calendar to use from the list - Ask if they want to set it as the default for future operations - Remember their choice in memory

2. If user sets a default: - Remember default_task_calendar and/or default_event_calendar - Use automatically for subsequent operations without asking

3. If user declines to set a default: - Ask again next time they create a task/event without specifying a calendar

4. User can always override: - Explicitly specifying --calendar always takes precedence over the default

Memory Keys

Agent Behavior: Default Address Book Selection

When creating contacts, if the user does not specify an address book:

1. First time (no default set): - Run addressbooks list - Ask the user which address book to use from the list - Ask if they want to set it as the default for future operations - Remember their choice in memory

2. If user sets a default: - Remember default_addressbook - Use automatically for subsequent operations without asking

3. If user declines to set a default: - Ask again next time they create a contact without specifying an address book

4. User can always override: - Explicitly specifying --addressbook always takes precedence over the default

Memory Keys

Agent Behavior: Presenting Information

When 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.

General Guidelines

Emoji Reference

Example Presentations

Tasks:

📋 Your Tasks
⬜ 🔴 Buy groceries — Due: Tomorrow 3:30 PM
⬜ 🟡 Review PR #42 — Due: Feb 5
✅ Send email to client

Calendar Events:

📅 Upcoming Events
🗓️ Team Standup
   ⏰ Mon, Feb 3 • 10:00 AM - 10:30 AM
   📍 Zoom
🗓️ Project Review
   ⏰ Wed, Feb 5 • 2:00 PM - 3:00 PM

Contacts:

👤 John Doe
   📧 john@example.com
   📱 +1 234 567 890
   🏢 ACME Inc — Developer

Files:

📂 Documents/
   📄 report.pdf (2.3 MB)
   📄 notes.txt (4 KB)
   📂 Archive/

Date/Time Formatting