81 lines
3.7 KiB
Markdown
81 lines
3.7 KiB
Markdown
---
|
||
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`
|