← 返回 Skills 市场
kitakitsune0x

Notion Sync

作者 kitakitsune0x · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
592
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openclaw-notion-sync
功能描述
Sync local workspace directories and files to Notion pages using the notion-sync CLI or programmatic API. Use when the user wants to push files to Notion, mi...
安全使用建议
This skill appears to do what it says: mirror a local directory to Notion. Before using it, (1) create a Notion integration with the minimum scopes needed and use that token; (2) keep the generated .notion-sync.json out of version control (the default ignore list already includes it, but double-check your repo’s .gitignore) because it contains the token in plaintext; (3) run sync with --dry-run or --diff first to preview changes; (4) be aware that updates clear and re-append page blocks, which can overwrite existing content in the target Notion pages—test on a dedicated root page or a small sample directory first; and (5) review the token and page sharing settings in Notion so the integration only has access to the intended pages.
功能分析
Type: OpenClaw Skill Name: openclaw-notion-sync Version: 0.1.0 The skill's core functionality involves reading local files and syncing them to Notion, which requires both file system and network access, consistent with its stated purpose. However, the Notion API token is stored in plain text within the `.notion-sync.json` configuration file. While this is a common practice for CLI tools, it represents a vulnerability as it exposes sensitive credentials if the config file is compromised. There is no evidence of intentional malicious behavior such as exfiltration to unauthorized endpoints, persistence mechanisms, or prompt injection attempts designed to subvert the agent's purpose beyond the stated functionality.
能力评估
Purpose & Capability
Name/description, CLI flags, SKILL.md, and source files all consistently implement a Notion syncing tool. Dependencies (@notionhq/client, glob, ignore, etc.) are appropriate for this functionality. No unrelated credentials, binaries, or platform access are requested.
Instruction Scope
Runtime instructions and code operate on the target directory and Notion via the provided token. They do not read unrelated system files or env vars. Important behavioral note: updating a file will cause the tool to clear existing blocks on the corresponding Notion page and re-append content (destructive-within-Notion behavior). SKILL.md documents usage and init flow; nothing unexpected is being transmitted to external endpoints other than Notion's API.
Install Mechanism
This is an instruction-only skill with source included; SKILL.md recommends installing from npm (registry). There is no remote arbitrary download URL or archive extraction in the skill metadata. package.json and package-lock.json show normal npm dependencies.
Credentials
No environment variables are required by the skill metadata. The tool requires a Notion token provided at init and stores it in plaintext inside .notion-sync.json in the project root. The default ignore set includes '.notion-sync.json' (so the config should be ignored by git by default), but if committed the token could be exposed. The tool needs readonly/write access to the specified directory and write access in Notion — both are expected for the stated purpose.
Persistence & Privilege
always is false and the skill does not request persistent presence or modify other skills or global agent settings. It writes its own .notion-sync.json config in the user's project directory (expected behavior).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install openclaw-notion-sync
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /openclaw-notion-sync 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
notion-sync 0.1.0 initial release - Syncs local directories and files into Notion, mirroring folders as pages and files as sub-pages. - CLI commands for initializing config, syncing, ignore pattern management, and checking sync status. - Programmatic API for custom integrations. - Uses checksums for efficient diff-based syncing and supports dry-run previews. - Automatic chunking of file contents and robust Notion page handling. - Easily configurable via `.notion-sync.json` with sensible defaults and ignore patterns.
元数据
Slug openclaw-notion-sync
版本 0.1.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Notion Sync 是什么?

Sync local workspace directories and files to Notion pages using the notion-sync CLI or programmatic API. Use when the user wants to push files to Notion, mi... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 592 次。

如何安装 Notion Sync?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-notion-sync」即可一键安装,无需额外配置。

Notion Sync 是免费的吗?

是的,Notion Sync 完全免费(开源免费),可自由下载、安装和使用。

Notion Sync 支持哪些平台?

Notion Sync 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Notion Sync?

由 kitakitsune0x(@kitakitsune0x)开发并维护,当前版本 v0.1.0。

💬 留言讨论