openclaw/docs/Nextcloud_Operator_Checklist.md

Nextcloud — операторский минимум (чеклист)

Короткий порядок действий при любой заявке по Nextcloud.

0) Перед началом

• Подтвердить, что используется поддерживаемый браузер (Chrome/Firefox/Safari/Edge).
• Проверить доступы:
  • NEXTCLOUD_URL
  • NEXTCLOUD_USER
  • NEXTCLOUD_TOKEN (app password)

1) Определить тип проблемы

• Файлы (не видно, не грузится, не скачивается, нет места)
• Календарь/события
• Задачи
• Контакты
• Доступ/авторизация

2) Базовая диагностика по типу

Файлы

1. Проверить наличие/путь:
   • files list --path "/..."
   • files search --query "..."
2. Если файл есть — проверить чтение:
   • files get --path "/..."
3. Если проблемы с загрузкой — тестовый upload в безопасный путь.
4. Если «нет места»:
   • проверить квоту
   • проверить Deleted files
   • проверить версии файлов

Календарь

1. Проверить список календарей:
   • calendars list --type events
2. Проверить окно дат:
   • calendar list --from "ISO" --to "ISO"
3. Для правок всегда использовать точный uid из свежего списка.

Задачи

1. Проверить список календарей задач:
   • calendars list --type tasks
2. Проверить список задач в нужном календаре:
   • tasks list --calendar "..."
3. Для правок/complete/delete — только по свежему uid.

Контакты

1. Проверить адресные книги:
   • addressbooks list
2. Поиск контакта:
   • contacts search --query "..."
3. Правки/удаление — только по свежему uid.

Доступ/авторизация

• 401/403: проверить пользователя и app password.
• 404: проверить точные имена календаря/адресной книги/пути.
• После ротации пароля пользователя — перевыпустить app password.

3) Правила безопасных изменений

1. Сначала list/get/search, потом edit/delete.
2. Не делать массовые изменения без теста на 1 объекте.
3. Для календаря всегда задавать явные --start и --end в ISO.
4. Фиксировать, что именно изменено: сущность, uid/id, время, результат.

4) Быстрый smoke-test после фикса

• Файлы: создать тестовый файл → прочитать → удалить.
• Календарь: создать короткое тест-событие → проверить в списке → удалить.
• Контакты: создать тест-контакт → найти → удалить.
• Задачи: создать тест-задачу → complete → удалить.

5) Команда запуска

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

Справка по разделам:

• docs/Nextcloud_Work_Instructions.md
• docs/Nextcloud_Manual_Extract.md