Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Этот навык позволяет агенту работать со страницами и базами данных Notion через официальный API. Подход декларативный: он описывает безопасные и рекомендуемые операции, а реальные API-вызовы выполняются через локальный CLI-инструмент (notion-cli).
Аутентификация
Создайте интеграцию в Notion:
https://www.notion.so/my-integrations
Скопируйте Internal Integration Token и экспортируйте его как переменную окружения:
export NOTION_API_KEY=secret_xxxПосле этого обязательно предоставьте интеграции доступ к нужным страницам или базам данных — без этого API не увидит контент.
Профили (личный / рабочий)
Вы можете использовать несколько профилей (например, personal и work) через переменные окружения или конфигурацию.
Профиль по умолчанию:
personalДля переключения:
export NOTION_PROFILE=workСтраницы
- Получить страницу:
notion-cli page get - Добавить блоки:
notion-cli block append--markdown "..." - Создать страницу:
notion-cli page create --parent--title "..."
Рекомендуется добавлять контент (append), а не переписывать его полностью.
Базы данных
- Посмотреть схему:
notion-cli db get - Выполнить запрос:
notion-cli db query--filter --sort - Создать запись:
notion-cli page create --database--props - Обновить запись:
notion-cli page update--props
Изменение схемы (продвинутый уровень)
Перед внесением изменений всегда проверяйте различия (diff). Никогда не меняйте структуру базы данных без явного подтверждения.
Рекомендуемый процесс:
notion-cli db schema diff --desired
notion-cli db schema apply --desired Замечания по безопасности
- API Notion имеет ограничения по частоте запросов — группируйте операции.
- Предпочитайте добавление и обновление данных вместо разрушительных действий.
- ID объектов непрозрачны — храните их явно, не извлекайте из URL.
- Используйте токен с минимально необходимыми правами доступа.
- Давайте доступ интеграции только к нужным страницам и базам.
- Периодически обновляйте токены и удаляйте неиспользуемые интеграции.
Сам навык представляет собой обёртку-документацию: он не выполняет код напрямую, а предполагает использование локального CLI для взаимодействия с API Notion. :
Файл из источника