Una potente integración para gestionar programáticamente páginas, fuentes de datos y cargas de archivos multimedia de Notion utilizando las últimas especificaciones de la API.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install openclaw-notion-api
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar openclaw-notion-api usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es openclaw-notion-api?
El openclaw-notion-api es una herramienta especializada diseñada para cerrar la brecha entre su entorno local y el ecosistema de Notion. Como componente clave de Openclaw Skills, proporciona una interfaz robusta para crear y actualizar páginas, gestionar bases de datos complejas (ahora denominadas fuentes de datos) y manejar contenido a nivel de bloque.
Esta habilidad está diseñada para ser compatible con la versión más reciente de la API (2025-09-03), lo que garantiza que los desarrolladores puedan aprovechar funciones avanzadas como la carga directa de archivos y el nuevo sistema de ID dual para bases de datos. Al integrar esta habilidad en su flujo de trabajo, puede transformar Notion de una aplicación de notas pasiva en un centro de datos dinámico y automatizado.
Casos de uso de openclaw-notion-api
- Automatización de la creación de registros diarios o notas de reuniones directamente en Notion.
- Sincronización de registros de bases de datos externas con fuentes de datos de Notion para paneles en tiempo real.
- Carga masiva de imágenes o documentos de proyectos en bloques de páginas específicos.
- Actualización programática de estados de tareas y metadatos de proyectos en múltiples páginas.
- Búsqueda y recuperación de contenido del espacio de trabajo con fines de archivo o análisis.
Cómo funciona openclaw-notion-api
- La autenticación se establece mediante un token de integración interna seguro almacenado en su configuración local.
- La habilidad se dirige a páginas o bases de datos específicas que se han compartido explícitamente con la integración.
- Las solicitudes se envían con los encabezados Notion-Version necesarios para garantizar la compatibilidad con la API 2025-09-03.
- Las operaciones se realizan utilizando database_id para la creación o data_source_id para consultas complejas.
- La gestión de archivos multimedia sigue un ciclo de vida especializado de tres pasos: creación de un objeto de carga, envío del contenido del archivo y, finalmente, inserción del bloque de archivo en una página.
Configuración de openclaw-notion-api
- Crea una integración interna en notion.so/profile/integrations.
- Obtén tu clave de API (comenzará con
ntn_osecret_). - Guarda tu clave en el directorio de configuración local:
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
- Abre la página de Notion de destino, haz clic en el menú de tres puntos y usa "Conectar a" para seleccionar el nombre de tu integración.
Esquema de datos y taxonomía de openclaw-notion-api
La habilidad openclaw-notion-api interactúa con una amplia variedad de tipos de propiedades de Notion. A continuación se presenta un resumen de las estructuras de datos compatibles:
| Tipo de propiedad | Ejemplo de estructura JSON |
|---|---|
| Título | {"title": [{"text": {"content": "..."}}]} |
| Selección | {"select": {"name": "Opción"}} |
| Fecha | {"date": {"start": "2024-01-15"}} |
| Casilla de verificación | {"checkbox": true} |
| Relación | {"relation": [{"id": "id_de_pagina"}]} |
| Texto enriquecido | {"rich_text": [{"text": {"content": "..."}}]} |
Ten en cuenta que en la última versión de Openclaw Skills para Notion, las bases de datos utilizan un data_source_id para las consultas y un database_id para las referencias de página principal.
Funciones avanzadas de openclaw-notion-api
- Ingesta directa de archivos: Admite cargas multipart/form-data para archivos e imágenes de hasta 20 MB sin alojamiento externo.
- Consulta de fuentes de datos: Capacidades avanzadas de filtrado y clasificación mediante los nuevos puntos de conexión
/data_sources/. - Inserción de bloques múltiples: Agrega múltiples tipos de bloques (párrafos, imágenes, archivos) en una sola solicitud PATCH.
- Optimización específica de la versión: Soporte nativo para la API 2025-09-03, que gestiona la transición de objetos de bases de datos heredados a fuentes de datos modernas.
- Gestión del límite de velocidad: Optimizado para un rendimiento de API estándar de aproximadamente 3 solicitudes por segundo.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Oráculo Diario
Un agente de segundo plano exclusivamente local que genera predicciones de vida diaria analizando tu calendario, mensajes y señales sociales.
Publicador de Contenido de Zhihu
Una herramienta automatizada para publicar artículos y pensamientos en Zhihu utilizando Chrome Browser Relay para un control fluido del navegador.
Herramienta Feishu IM
Una potente herramienta para que los agentes de IA interactúen con Feishu IM, permitiendo la mensajería automatizada y el intercambio de archivos multimedia a través de la API de Feishu Bot.
Autorreflexión y Post-Mortem
Un marco estructurado para que los agentes de IA evalúen el rendimiento del proyecto, documenten el crecimiento técnico y analicen los flujos de trabajo de resolución de problemas.
Ingeniero de Prompts
Una habilidad de ingeniería avanzada para diseñar, optimizar y diagnosticar prompts de sistema para agentes autónomos e IA consultiva utilizando una arquitectura de tres capas.
Captura de Contenido Web a Obsidian
Una utilidad perfecta para extraer contenido web, realizar traducciones de alta calidad e importar archivos Markdown formateados directamente en una bóveda de Obsidian.
METADATA
Presentado*
