OpenClaw + Notion

Prerequisites

• OpenClaw running (see our deployment guide)
• A Notion account (free or paid)
• Admin access to the workspace you want to connect

Step 1: Create a Notion Integration

1. Go to notion.so/my-integrations
2. Click + New integration
3. Fill in the details:
- Name: "OpenClaw" (or your preferred name) - Logo: Optional - Associated workspace: Select your workspace
4. Click Submit
5. Copy the Internal Integration Token (starts with secret_...)

Step 2: Share Pages with Your Integration

Notion requires explicit page sharing for API access:

1. Open Notion and navigate to a page or database you want OpenClaw to access
2. Click the ... menu (top right) → Add connections
3. Find your integration and click to connect it
4. Repeat for any other pages or databases you want to share

Important: Only shared pages are accessible via the API.

Configuration

Add the Notion channel to your OpenClaw config:

# In your openclaw config
channels:
  notion:
    enabled: true
    api_key: "secret_YOUR_INTEGRATION_TOKEN"

Or via environment variables in your docker-compose.yml:

environment:
  - NOTION_ENABLED=true
  - NOTION_API_KEY=secret_YOUR_INTEGRATION_TOKEN

Step 3: Restart OpenClaw

docker compose restart openclaw

Verification

Try asking OpenClaw to search your Notion workspace:

"Search my Notion for pages about 'project'"
"List my Notion databases"
"Create a new page in my Tasks database"

Check logs for API calls:

docker compose logs -f openclaw | grep -i notion

Common Issues

Page not found: Make sure you've shared the page with your integration. Go to the page → ... → Add connections → select your integration.

Permission denied: Notion API requires explicit page-level permissions. Even workspace admins must share each page individually.

Rate limits: Notion has rate limits (3 requests/second). OpenClaw handles this automatically, but very large operations may take time.

Database properties: When creating pages in databases, properties must match the database schema exactly. Check property names and types.