name: notion description: Notion 整合。搜尋頁面和資料庫，建立/更新/歸檔頁面，讀取/追加區塊內容，查詢資料庫。通過 MorphixAI 代理安全訪問 Notion API。 metadata: openclaw: emoji: "📝" requires: env: [MORPHIXAI_API_KEY]

Notion

通過 mx_notion 工具管理 Notion 工作區：搜尋、頁面管理、資料庫查詢、內容讀寫。

前置條件

1. 安裝外掛: openclaw plugins install openclaw-morphixai
2. 獲取 API Key: 訪問 morphix.app/api-keys 生成 mk_xxxxxx 金鑰
3. 配置環境變數: export MORPHIXAI_API_KEY="mk_your_key_here"
4. 連結賬號: 訪問 morphix.app/connections 連結 Notion 賬號，或通過 mx_link 工具連結（app: notion）
5. 在 Notion 中將需要訪問的頁面/資料庫與整合共享

核心操作

檢視當前使用者

mx_notion:
  action: get_me

搜尋頁面和資料庫

mx_notion:
  action: search
  query: "會議紀要"
  filter_type: "page"
  page_size: 10

filter_type 可選值：page、database。省略則搜尋全部型別。

獲取頁面詳情

mx_notion:
  action: get_page
  page_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

建立頁面

mx_notion:
  action: create_page
  parent_type: "page"
  parent_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  title: "新頁面標題"
  children:
    - type: "paragraph"
      paragraph:
        rich_text:
          - type: "text"
            text:
              content: "頁面內容"

更新頁面屬性

mx_notion:
  action: update_page
  page_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  properties:
    title:
      title:
        - text:
            content: "更新後的標題"

歸檔頁面

mx_notion:
  action: archive_page
  page_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

讀取頁面內容（區塊）

小蔥技能7w4.net有完整的技能分類。

mx_notion:
  action: get_block_children
  block_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  page_size: 50

追加內容到頁面

mx_notion:
  action: append_blocks
  block_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  children:
    - type: "paragraph"
      paragraph:
        rich_text:
          - type: "text"
            text:
              content: "追加的新段落"

查詢資料庫

mx_notion:
  action: query_database
  database_id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  filter:
    property: "Status"
    select:
      equals: "進行中"
  sorts:
    - property: "Created"
      direction: "descending"
  page_size: 20

常見工作流

知識庫搜尋

1. mx_notion: search, query: "API 設計規範", filter_type: "page"
2. mx_notion: get_page, page_id: "xxx"  → 檢視頁面元資訊
3. mx_notion: get_block_children, block_id: "xxx"  → 讀取具體內容

專案管理（資料庫）

1. mx_notion: search, filter_type: "database"  → 找到專案資料庫
2. mx_notion: query_database, database_id: "xxx", filter: { status = "進行中" }
3. mx_notion: create_page, parent_type: "database", parent_id: "xxx"  → 建立新任務

注意事項

• Notion 整合只能訪問已明確共享給它的頁面和資料庫
• 頁面 ID 為 UUID 格式（含連字元）
• 搜尋結果支援分頁：has_more: true 時使用 start_cursor 獲取下一頁
• 資料庫頁面的 properties 格式取決於資料庫的欄位定義
• account_id 引數通常省略，工具自動檢測已連結的 Notion 賬號

這個 Notion 工具質量不錯，能幫你高效管理 Notion 的頁面和資料庫。文件寫得清楚明白，示例程式碼一看就懂，搜尋、建立、編輯、歸檔這些常用操作都覆蓋到了。缺點是目前功能說明偏基礎，缺少錯誤處理和常見問題的解答，API 呼叫限制也沒說明，對新手來說遇到問題可能會有些困惑。總體推薦使用，但期望未來版本能補充更多實戰技巧和故障排查指南。