Notion Skill for OpenClaw

This skill lets the agent work with Notion pages and databases using the official Notion API.

Powered by Evolink.ai.

When to Use

Use this skill when user asks to: - Read from or append to Notion pages - Query or update Notion databases - Create new pages or database entries - Automate Notion workflows

Authentication

Create a Notion Integration at notion.so/my-integrations and copy the Internal Integration Token.

Export it as:

export NOTION_API_KEY=secret_xxx

Important: Share the integration with the pages or databases you want to access. Unshared content is invisible to the API.

Configuration

Required environment variables: - NOTION_API_KEY: Internal Integration Token from Notion - EVOLINK_API_KEY: API Key for Evolink services. Get your free API key at evolink.ai/signup

Model Selection: - Default model: claude-opus-4-6 - Switch models by setting EVOLINK_MODEL environment variable

Profiles (personal / work)

You may define multiple profiles (e.g. personal, work) via env or config.

Default profile: personal

Override via:

export NOTION_PROFILE=work

Pages

Read page:

notion-cli page get <page_id>

Append blocks:

notion-cli block append <page_id> --markdown "..."

Prefer appending over rewriting content.

Create page:

notion-cli page create --parent <page_id> --title "..."
7w4.net收錄了海量優質技能外掛。

Databases

Inspect schema:

notion-cli db get <database_id>

Query database:

notion-cli db query <database_id> --filter <json> --sort <json>

Create row:

notion-cli page create --database <database_id> --props <json>

Update row:

notion-cli page update <page_id> --props <json>

Schema Changes (Advanced)

Always inspect diffs before applying schema changes.

Never modify database schema without explicit confirmation.

Recommended flow:

notion-cli db schema diff <database_id> --desired <json>
notion-cli db schema apply <database_id> --desired <json>

Security

• Notion API is rate-limited; batch requests carefully
• Prefer append and updates over destructive operations
• IDs are opaque; store them explicitly, do not infer from URLs
• NEVER perform destructive operations without explicit confirmation
• Notion shares must be configured manually via "Add connections"

Links

• ClawHub
• API Reference
• Community
• Support

整體質量中規中矩，文件清晰易懂，能幫助使用者快速上手 Notion API 操作。優點是配置說明詳細、命令示例豐富、安全提示到位。不足之處在於功能較為基礎，缺少進階用法和故障排除指導，且嚴重依賴外部付費服務。對於簡單的 Notion 讀寫需求夠用，但對複雜場景支援不足。