← 返回 Skills 市场
Notion Sync
作者
robansuini
· GitHub ↗
· v2.5.3
· MIT-0
4752
总下载
6
收藏
0
当前安装
16
版本数
在 OpenClaw 中安装
/install notion-sync
功能描述
Bi-directional sync and management for Notion pages and databases. Use when working with Notion workspaces for collaborative editing, research tracking, proj...
安全使用建议
Review before installing if your Notion workspace contains important business or shared data. Use a least-privilege Notion integration shared only with needed pages/databases, protect any token file, run batch updates with --dry-run first, always provide a narrow --filter, and avoid forwarding JSON monitoring output to chat, CI, or alerting systems unless those destinations are approved.
功能分析
Type: OpenClaw Skill
Name: notion-sync
Version: 2.5.3
The notion-sync skill bundle is a well-structured set of tools for interacting with the Notion API using only built-in Node.js modules. It implements several security best practices, including a 'Path Safety Mode' in `notion-utils.js` to prevent path traversal and secure credential handling that avoids exposing tokens in process listings. The code logic is transparent, lacks external dependencies, and strictly aligns with the stated purpose of managing Notion workspaces.
能力评估
Purpose & Capability
Read, create, update, archive, search, and sync operations are coherent for a Notion management skill, but the bundled batch update command can mutate up to 100 database pages by default.
Instruction Scope
The documentation presents a query-mode filter as required, but batch-update.js does not enforce a filter or dry-run before applying changes to all returned pages up to the limit.
Install Mechanism
No install script, package installation, obfuscated setup, or hidden execution mechanism was found; the bundle is markdown plus Node.js scripts using built-in modules.
Credentials
Node.js, Notion API access, and local markdown file reads/writes fit the stated purpose. Local file paths are restricted to the current workspace by default, with an explicit unsafe-path override.
Persistence & Privilege
The skill uses a Notion token from documented sources, including an auto-detected ~/.notion-token file, and watch mode stores page IDs, titles, and timestamps in a documented state file. No background daemon was found.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install notion-sync - 安装完成后，直接呼叫该 Skill 的名称或使用
/notion-sync触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.5.3
Workspace path safety guard + docs hardening; keeps scanner-aligned metadata and credential-safe token handling.
v2.5.2
Security hardening: workspace-scoped file path safety guards, explicit --allow-unsafe-paths override, docs metadata updates, and test file removed from distributed bundle.
v2.5.1
fix: enforce Notion 2000-char rich_text limit for markdown spans in parseMarkdownRichText to prevent validation errors on long content.
v2.5.0
feat: batch-update.js for bulk property updates (query+update and stdin modes, --dry-run, rate limiting). feat: --json output mode on all scripts for composable piping.
v2.4.0
feat: friendlier error messages, ~ expansion in --token-file, auto-detect ~/.notion-token, --state-file flag for watch-notion
v2.3.0
Add clawdis registry metadata: declares NOTION_API_KEY and node requirements. Scanner should now see matching metadata.
v2.2.0
Security: remove bare --token arg. Credentials only via --token-file, --token-stdin, or NOTION_API_KEY env var. Never exposed in process listings or shell history.
v2.1.0
Add --token-file, --token-stdin, and NOTION_API_KEY env var as secure token input methods. --token still works. 109 tests. Addresses VirusTotal credential exposure concern.
v2.0.0
BREAKING: --token required for all scripts (env var removed). Fully platform-agnostic, zero environment dependencies. 105 tests. See upgrade guide in SKILL.md.
v1.0.6
Remove non-standard env field from frontmatter to resolve scanner metadata inconsistency
v1.0.5
Added homepage, repository, and license to frontmatter for provenance verification. Addresses ClawHub scanner recommendation.
v1.0.4
Security scan fixes: declared NOTION_API_KEY env dependency, made fully platform-agnostic (removed all macOS/OpenClaw references), eliminated code duplication across 6 scripts, centralized shared utils, 100 unit tests, backwards-compatible exports
v1.0.3
- Added test script: `scripts/test-normalize.js` for normalization testing.
- Improved functionality in `scripts/notion-to-md.js`.
- Enhanced monitoring or change detection logic in `scripts/watch-notion.js`.
v1.0.2
- Replaced the old `add-research-to-db.js` script with a new, more general `add-to-database.js` script for adding markdown files as pages to any Notion database.
- Updated documentation to reflect the more flexible workflow for adding content to databases.
- Simplified example commands and removed hardcoded database IDs, making usage examples more portable.
- Cleaned up references to removed scripts and clarified output and feature descriptions in core operation docs.
v1.0.1
Fix: Remove hardcoded environment-specific paths. Script now requires explicit arguments or environment variables for portability.
v1.0.0
Initial release: Bi-directional markdown to Notion sync with database management and change detection
元数据
常见问题
Notion Sync 是什么？
Bi-directional sync and management for Notion pages and databases. Use when working with Notion workspaces for collaborative editing, research tracking, proj... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 4752 次。
如何安装 Notion Sync？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install notion-sync」即可一键安装，无需额外配置。
Notion Sync 是免费的吗？
是的，Notion Sync 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Notion Sync 支持哪些平台？
Notion Sync 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Notion Sync？
由 robansuini（@robansuini）开发并维护，当前版本 v2.5.3。
推荐 Skills