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

# OpenClaw Nextcloud Skill

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

```bash
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`