openclaw/skills/openclaw-nextcloud/SKILL.md

name, description

name	description
openclaw-nextcloud	Управляй Notes, Tasks (VTODO), Calendar (VEVENT), Files и Contacts в Nextcloud через Notes API, CalDAV, WebDAV и CardDAV. Используй, когда нужно создать/изменить заметки, задачи, события, файлы или контакты в Nextcloud из OpenClaw.

OpenClaw Nextcloud Skill

Используй CLI-скрипт:

node skills/openclaw-nextcloud/scripts/nextcloud.js <section> <command> [options]

Обязательная конфигурация

• NEXTCLOUD_URL
• NEXTCLOUD_USER
• NEXTCLOUD_TOKEN

Если переменные не заданы — остановись и запроси корректные значения.

Разделы и команды

Notes

• notes list
• notes get --id <id>
• notes create --title <t> --content <c> [--category <cat>]
• notes edit --id <id> [--title <t>] [--content <c>] [--category <cat>]
• notes delete --id <id>

Tasks (VTODO)

• tasks list [--calendar <c>]
• tasks create --title <t> [--calendar <c>] [--due <iso>] [--priority <p>] [--description <d>]
• tasks edit --uid <u> [--calendar <c>] [--title <t>] [--due <iso>] [--priority <p>] [--description <d>]
• tasks complete --uid <u> [--calendar <c>]
• tasks delete --uid <u> [--calendar <c>]

Calendar (VEVENT)

• calendar list [--from <iso>] [--to <iso>]
• calendar create --summary <s> --start <iso> --end <iso> [--calendar <c>] [--description <d>]
• calendar edit --uid <u> [--calendar <c>] [--summary <s>] [--start <iso>] [--end <iso>] [--description <d>]
• calendar delete --uid <u> [--calendar <c>]
• calendars list [--type <tasks|events>]

Files

• files list [--path <path>]
• files search --query <q>
• files get --path <path>
• files upload --path <path> --content <content>
• files delete --path <path>

Contacts

• contacts list [--addressbook <ab>]
• contacts get --uid <u> [--addressbook <ab>]
• contacts search --query <q> [--addressbook <ab>]
• contacts create --name <n> [--addressbook <ab>] [--email <e>] [--phone <p>] [--organization <o>] [--title <t>] [--note <n>]
• contacts edit --uid <u> [--addressbook <ab>] [--name <n>] [--email <e>] [--phone <p>] [--organization <o>] [--title <t>] [--note <n>]
• contacts delete --uid <u> [--addressbook <ab>]
• addressbooks list

Процедурные правила

1. Перед edit/delete делай list/get/search и проверяй точный id/uid.
2. Для событий всегда задавай --start и --end в ISO.
3. Для задач: priority 0..9 (0 — не задан).
4. Если календарь/адресная книга не указаны, сначала получай список (calendars list/addressbooks list) и уточняй выбор.
5. Все ответы интерпретируй как JSON:
   • успех: status=success
   • ошибка: status=error + message

Формат вывода пользователю

• Делай человекочитаемое резюме без markdown-таблиц.
• Технические детали (uid, путь, ISO-время) показывай только когда это нужно для следующего шага.

Операционная справка

• Практический регламент и примеры команд: docs/Nextcloud_Work_Instructions.md
• Выжимка и покрытие по официальному мануалу PDF: docs/Nextcloud_Manual_Extract.md
• Операторский чеклист (быстрая диагностика): docs/Nextcloud_Operator_Checklist.md