Uma integração poderosa para gerenciar programaticamente páginas do Notion, fontes de dados e uploads de mídia usando as especificações de API mais recentes.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install openclaw-notion-api
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o openclaw-notion-api usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é openclaw-notion-api?
O openclaw-notion-api é uma ferramenta especializada projetada para preencher a lacuna entre seu ambiente local e o ecossistema do Notion. Como um componente chave do Openclaw Skills, ele fornece uma interface robusta para criar e atualizar páginas, gerenciar bancos de dados complexos (agora chamados de fontes de dados) e lidar com conteúdo em nível de bloco.
Esta habilidade foi construída para suportar a versão mais recente da API (2025-09-03), garantindo que os desenvolvedores possam aproveitar recursos avançados, como uploads diretos de arquivos e o novo sistema de ID duplo para bancos de dados. Ao integrar esta habilidade ao seu fluxo de trabalho, você pode transformar o Notion de um aplicativo de notas passivo em um hub de dados dinâmico e automatizado.
Casos de uso do openclaw-notion-api
- Automatizar a criação de registros diários ou notas de reunião diretamente no Notion.
- Sincronizar registros de bancos de dados externos com fontes de dados do Notion para painéis em tempo real.
- Fazer upload em massa de imagens ou documentos de projeto para blocos de página específicos.
- Atualizar programaticamente status de tarefas e metadados de projetos em várias páginas.
- Pesquisar e recuperar conteúdo do espaço de trabalho para fins de arquivamento ou análise.
Como o openclaw-notion-api funciona
- A autenticação é estabelecida usando um token de integração interna seguro armazenado em sua configuração local.
- A habilidade visa páginas ou bancos de dados específicos que foram explicitamente compartilhados com a integração.
- As solicitações são enviadas com os cabeçalhos Notion-Version necessários para garantir a compatibilidade com a API 2025-09-03.
- As operações são realizadas usando database_id para criação ou data_source_id para consultas complexas.
- O gerenciamento de mídia segue um ciclo de vida especializado de três etapas: criar um objeto de upload, enviar o conteúdo do arquivo e, finalmente, inserir o bloco de arquivo em uma página.
Configuração do openclaw-notion-api
- Crie uma integração interna em notion.so/profile/integrations.
- Obtenha sua chave de API (ela começará com
ntn_ousecret_). - Salve sua chave no diretório de configuração local:
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
- Abra a página de destino do Notion, clique no menu de três pontos e use "Conectar a" para selecionar o nome da sua integração.
Esquema de Dados e Taxonomia de openclaw-notion-api
A habilidade openclaw-notion-api interage com uma ampla variedade de tipos de propriedades do Notion. Abaixo está um resumo das estruturas de dados suportadas:
| Tipo de Propriedade | Exemplo de Estrutura JSON |
|---|---|
| Título | {"title": [{"text": {"content": "..."}}]} |
| Seleção | {"select": {"name": "Opção"}} |
| Data | {"date": {"start": "2024-01-15"}} |
| Checkbox | {"checkbox": true} |
| Relação | {"relation": [{"id": "id_da_pagina"}]} |
| Rich Text | {"rich_text": [{"text": {"content": "..."}}]} |
Observe que na versão mais recente do Openclaw Skills para Notion, os bancos de dados utilizam um data_source_id para consultas e um database_id para referências de página pai.
Recursos avançados do openclaw-notion-api
- Ingestão Direta de Arquivos: Suporta uploads multipart/form-data para arquivos e imagens de até 20MB sem hospedagem externa.
- Consulta de Fonte de Dados: Recursos avançados de filtragem e classificação usando os novos endpoints
/data_sources/. - Inserção de Múltiplos Blocos: Adicione vários tipos de blocos (parágrafos, imagens, arquivos) em uma única solicitação PATCH.
- Otimização Específica de Versão: Suporte nativo para a API 2025-09-03, lidando com a transição de objetos de banco de dados legados para fontes de dados modernas.
- Tratamento de Limite de Taxa: Otimizado para um rendimento de API padrão de aproximadamente 3 solicitações por segundo.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Oráculo Diário
Um agente de segundo plano exclusivamente local que gera previsões de vida diária analisando seu calendário, mensagens e sinais sociais.
Publicador de Conteúdo do Zhihu
Uma ferramenta automatizada para publicar artigos e pensamentos no Zhihu usando o Chrome Browser Relay para controle contínuo do navegador.
Ferramenta Feishu IM
Uma ferramenta poderosa para agentes de IA interagirem com o Feishu IM, permitindo mensagens automatizadas e compartilhamento de mídia via API de Bot do Feishu.
Auto-Reflexão e Post-Mortem
Uma estrutura estruturada para agentes de IA avaliarem o desempenho do projeto, documentarem o crescimento técnico e analisarem os fluxos de trabalho de resolução de problemas.
Engenheiro de Prompt
Uma habilidade de engenharia avançada para projetar, otimizar e diagnosticar prompts de sistema para agentes autônomos e IA consultiva usando uma arquitetura de três camadas.
Captura de Conteúdo Web para Obsidian
Um utilitário perfeito para extrair conteúdo da web, realizar traduções de alta qualidade e importar arquivos Markdown formatados diretamente para um cofre do Obsidian.
Apresentou*
