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