$ ~/registry/skill/openclaw-notion

SKILL

notion

Name: notion
Author: openclaw

通过 Notion 的 CLI 与 API 批量管理页面、内容、数据与协作流程。

星标

★ 383,594

来源

GitHub

更新于

2026-07-20

// 安全评估需留意

仅提示词，不执行代码
开源可审计
社区验证· 377.5k

总评

该技能本身被判定为 prompt-only，且来源为高社区信任的开源 GitHub 仓库，因此整体风险偏低。需注意其文档实际描述了使用 Notion 官方 CLI/API、登录态与 API Token，以及访问官方 Notion 接口；这些若在外部落地执行，应按常规最小权限管理。

凭证密钥需留意

材料中的 README 明确提到 `ntn login` 与 `NOTION_API_TOKEN`，说明相关外部工具在实际使用时可能涉及 Notion 访问令牌；虽然该技能本身被标记为 prompt-only、元数据称“无密钥”，但文档与元数据不一致，建议将令牌视为敏感凭证并最小化授权范围。

网络外发需留意

文档展示了对 `https://api.notion.com/v1/...` 的官方 Notion API 调用，以及文件、搜索、评论、Workers 等远程操作示例。作为 prompt-only 技能本身不会自动外发数据，但若用户照文档在外部执行，相关页面内容、查询条件、文件等数据会发送至 Notion 官方端点。

代码执行低风险

系统客观检查项已标明该技能为 `prompt-only`，因此技能自身不具备本机起进程、执行脚本或直接调用系统能力的权限。README 中的 `npm install -g ntn`、`curl` 等仅是第三方说明文字，不应视为该技能自动执行这些操作。

数据访问低风险

从系统检查项看，该技能本身不直接读写本地文件或账户数据。文档虽描述了页面、数据源、文件上传、评论、搜索等 Notion 资源操作能力，但这些属于外部 CLI/API 的声明功能，不代表此 prompt-only 技能已经获得实际数据访问权限。

来源供应链低风险

来源为 GitHub 开源仓库，且社区采用度极高（约 377k stars），这显著降低了供应链风险并提升了可审计性。需留意许可证未声明、维护状态未知，以及仓库名 `openclaw/openclaw` 与“notion”技能名不完全一致，建议上线前再做一次仓库内容与发布物对应性核验。

安全建议

若实际接入外部 Notion CLI/API，请仅使用最小权限的集成令牌，并避免复用个人长期凭证。
核实该技能与 `openclaw/openclaw` 仓库、发布物及版本的一致性，确认不存在名称混淆或替换。
在执行 README 命令前，明确哪些数据会发送到 `api.notion.com`，尤其是页面内容、文件与搜索结果。
优先固定依赖版本并在隔离环境中测试 `ntn`/相关脚本，再用于生产工作区。

审计模型: gpt-5.4 · 2026-06-16

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "notion" 技能：
1. 下载 https://raw.githubusercontent.com/openclaw/openclaw/main/skills/notion/SKILL.md
2. 保存为 ~/.claude/skills/notion/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

批量创建项目文档

输入

请用 Notion API 在“产品需求”数据库中为以下项目批量创建页面：项目A、项目B、项目C。每个页面包含标题、负责人、截止日期和 Markdown 格式的需求概述。

预期产出

自动创建多条 Notion 页面记录，并按要求写入结构化字段与正文内容。

搜索并汇总知识库

输入

搜索 Notion 工作区中与“季度复盘”相关的页面、评论和附件，提取关键结论，并整理成一页中文总结。

预期产出

返回相关内容列表，并生成一页可读的总结文档，便于快速复盘。

自动同步表单数据

输入

把外部表单提交的数据同步到 Notion 数据库：如果记录不存在则创建，如果已存在则更新状态、备注和上传文件链接，并在页面下添加处理评论。

预期产出

实现表单到 Notion 的自动化入库与更新，并保留处理过程的协作备注。

// 文档

Notion

Prefer official ntn CLI. Use curl only when ntn is unavailable or a raw request is clearer.

Setup

npm install -g ntn
ntn --version
ntn login

Script/headless auth:

export NOTION_API_TOKEN=secret_or_ntn_token
export NOTION_API_VERSION=2026-03-11

ntn api sets Authorization and Notion-Version automatically. It uses CLI login by default, or NOTION_API_TOKEN when set.

Inspect

ntn doctor
ntn api ls
ntn api ls --json
ntn api v1/comments --help
ntn api v1/comments --spec -X POST
ntn api v1/comments --docs -X POST

Pages

Markdown-first helpers:

ntn pages get <page-id>
ntn pages get <page-id> --json
ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
ntn pages create --parent data-source:<data-source-id> < page.md
ntn pages update <page-id> --content '# Updated'
ntn pages update <page-id> < page.md
ntn pages trash <page-id> --yes

Notes:

pages get prints Markdown with page properties as frontmatter.
Content input: --content, stdin, or editor in a TTY.
Parent refs: page:<id>, database:<id>, data-source:<id>.
For properties/templates/full Pages API, use ntn api v1/pages.

Data sources

ntn datasources resolve <database-id>
ntn datasources resolve <database-id> --json
ntn datasources query <data-source-id>
ntn datasources query <data-source-id> --limit 50 --json
ntn datasources query <data-source-id> --sort 'Date desc'
ntn datasources query <data-source-id> --filter '{"property":"Done","checkbox":{"equals":true}}'

Use resolve when you have a database ID. Query needs a data source ID.

Raw API

ntn api v1/users/me
ntn api v1/search query=roadmap page_size:=10
ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[Name][title][0][text][content]=New item'
ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
  'children[0][type]=paragraph' \
  'children[0][paragraph][rich_text][0][text][content]=Hello'

Input syntax:

path=value: string body field.
path:=json: typed JSON body field.
name==value: query parameter.
Header:Value: request header.
--data '<json>' or stdin JSON for larger bodies.
Only one body source per request.

Files

ntn files create < image.png
ntn files create --filename photo.png --content-type image/png < /tmp/photo
ntn files create --external-url https://example.com/photo.png
ntn files get <upload-id>
ntn files list

Workers

ntn workers new
ntn workers deploy
ntn workers list --json
ntn workers runs list --json
ntn workers runs logs <run-id>

Workers may require Business/Enterprise plan and workspace enablement.

Curl fallback

curl -sS "https://api.notion.com/v1/users/me" \
  -H "Authorization: Bearer $NOTION_API_TOKEN" \
  -H "Notion-Version: 2026-03-11" \
  -H "Content-Type: application/json"

Version notes

Current latest API version: 2026-03-11.
Use in_trash, not archived.
Append block positioning uses position, not flat after.
transcription block renamed to meeting_notes.
Databases can contain multiple data sources; page parents generally use data_source_id.

openclaw装→

连接 Notion 工作区，自动管理页面、数据库与内容协作流程

—装→

技能

★23k

notion-research-documentation

跨多个 Notion 信息源检索并整合，生成带引用的结构化文档与报告。

OpenAI装→

MCP 工具

Notion MCP Server

通过自然语言连接 Notion 工作区，搜索内容并创建、更新页面与数据库。

—装→

技能

★23k

notion-knowledge-capture

将对话与决策整理成结构化 Notion 页面，便于沉淀知识库与规范文档

OpenAI装→

$ loading_

请帮我安装 askskill 上的 "notion" 技能： 1. 下载 https://raw.githubusercontent.com/openclaw/openclaw/main/skills/notion/SKILL.md 2. 保存为 ~/.claude/skills/notion/SKILL.md 3. 装好后重载技能，告诉我可以用了

// 用法示例

批量创建项目文档

输入

请用 Notion API 在“产品需求”数据库中为以下项目批量创建页面：项目A、项目B、项目C。每个页面包含标题、负责人、截止日期和 Markdown 格式的需求概述。

预期产出

自动创建多条 Notion 页面记录，并按要求写入结构化字段与正文内容。

搜索并汇总知识库

输入

搜索 Notion 工作区中与“季度复盘”相关的页面、评论和附件，提取关键结论，并整理成一页中文总结。

预期产出

返回相关内容列表，并生成一页可读的总结文档，便于快速复盘。

自动同步表单数据

输入

把外部表单提交的数据同步到 Notion 数据库：如果记录不存在则创建，如果已存在则更新状态、备注和上传文件链接，并在页面下添加处理评论。

预期产出

实现表单到 Notion 的自动化入库与更新，并保留处理过程的协作备注。

// 文档

Notion

Prefer official ntn CLI. Use curl only when ntn is unavailable or a raw request is clearer.

Setup

npm install -g ntn
ntn --version
ntn login

Script/headless auth:

export NOTION_API_TOKEN=secret_or_ntn_token
export NOTION_API_VERSION=2026-03-11

ntn api sets Authorization and Notion-Version automatically. It uses CLI login by default, or NOTION_API_TOKEN when set.

Inspect

ntn doctor
ntn api ls
ntn api ls --json
ntn api v1/comments --help
ntn api v1/comments --spec -X POST
ntn api v1/comments --docs -X POST

Pages

Markdown-first helpers:

ntn pages get <page-id>
ntn pages get <page-id> --json
ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
ntn pages create --parent data-source:<data-source-id> < page.md
ntn pages update <page-id> --content '# Updated'
ntn pages update <page-id> < page.md
ntn pages trash <page-id> --yes

Notes:

pages get prints Markdown with page properties as frontmatter.
Content input: --content, stdin, or editor in a TTY.
Parent refs: page:<id>, database:<id>, data-source:<id>.
For properties/templates/full Pages API, use ntn api v1/pages.

Data sources

ntn datasources resolve <database-id>
ntn datasources resolve <database-id> --json
ntn datasources query <data-source-id>
ntn datasources query <data-source-id> --limit 50 --json
ntn datasources query <data-source-id> --sort 'Date desc'
ntn datasources query <data-source-id> --filter '{"property":"Done","checkbox":{"equals":true}}'

Use resolve when you have a database ID. Query needs a data source ID.

Raw API

ntn api v1/users/me
ntn api v1/search query=roadmap page_size:=10
ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[Name][title][0][text][content]=New item'
ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
  'children[0][type]=paragraph' \
  'children[0][paragraph][rich_text][0][text][content]=Hello'

Input syntax:

path=value: string body field.
path:=json: typed JSON body field.
name==value: query parameter.
Header:Value: request header.
--data '<json>' or stdin JSON for larger bodies.
Only one body source per request.

Files

ntn files create < image.png
ntn files create --filename photo.png --content-type image/png < /tmp/photo
ntn files create --external-url https://example.com/photo.png
ntn files get <upload-id>
ntn files list

Workers

ntn workers new
ntn workers deploy
ntn workers list --json
ntn workers runs list --json
ntn workers runs logs <run-id>

Workers may require Business/Enterprise plan and workspace enablement.

Curl fallback

curl -sS "https://api.notion.com/v1/users/me" \
  -H "Authorization: Bearer $NOTION_API_TOKEN" \
  -H "Notion-Version: 2026-03-11" \
  -H "Content-Type: application/json"

Version notes

Current latest API version: 2026-03-11.
Use in_trash, not archived.
Append block positioning uses position, not flat after.
transcription block renamed to meeting_notes.
Databases can contain multiple data sources; page parents generally use data_source_id.