← 返回 Skills 市场
hxy9243

Zettel Link

作者 Xiaoyu Kevin Hu · GitHub ↗ · v1.1.3
cross-platform ✓ 安全检测通过
592
总下载
0
收藏
2
当前安装
5
版本数
在 OpenClaw 中安装
/install zettel-link
功能描述
This skill maintains the Note Embeddings for Zettelkasten, to search notes, retrieve notes, and discover connections between notes.
安全使用建议
This skill appears to do what it says: index and search notes by sending note text to an embedding provider. Before installing or running it: (1) decide whether you want note content sent to remote APIs — use a local Ollama model for better privacy; (2) if you use OpenAI/Gemini, set API keys as environment variables instead of placing long-lived keys in the skill folder .env unless you trust the installation location; (3) inspect config/config.json and the scripts (already included) if you have concerns; (4) be aware the scripts will create a .embeddings directory inside the target notes directory to store caches and results. If you want stronger guarantees, run the code on a copy of your vault or run only with a local provider.
功能分析
Type: OpenClaw Skill Name: zettel-link Version: 1.1.3 The OpenClaw skill 'zettel-link' is classified as benign. The Python scripts are designed for semantic search and linking of notes, using local or remote embedding providers. A critical security control is implemented in `scripts/embed.py` (and used by `scripts/search.py`): the `validate_url` function strictly enforces `ALLOWED_DOMAINS` for all API calls, preventing data exfiltration to arbitrary external endpoints. API keys are handled securely by reading from environment variables or a local `.env` file for legitimate API authentication, without any evidence of malicious intent or exfiltration. The `SKILL.md` and `README.md` files contain clear, functional instructions without any prompt injection attempts.
能力评估
Purpose & Capability
The name/description (zettelkasten embeddings, search, linking) matches the included Python scripts which enumerate, embed, cache, search, and compute similarities for markdown notes. Network access to embedding providers (Ollama/OpenAI/Gemini) is expected for this purpose.
Instruction Scope
Runtime instructions are narrowly scoped: run config → embed → search/link. The scripts traverse only the supplied notes directory, create/read a local cache (.embeddings) and may send note text to the configured embedding provider. The SKILL.md explicitly instructs providing API keys (env or local .env) for remote providers. This transmission of note contents to remote APIs is expected for embedding but is a privacy consideration the user should be aware of.
Install Mechanism
There is no install spec that downloads external code; the package is instruction-first and includes Python scripts. No remote archives, launchers, or post-install hooks are present in the manifest.
Credentials
The skill does not declare required environment variables in the registry, but supports optional OPENAI_API_KEY and GEMINI_API_KEY (and uses a local .env fallback). That is proportionate to its ability to call remote embedding APIs. Users should avoid placing sensitive/global credentials into the skill directory unless they trust the code and host.
Persistence & Privilege
The skill does not request permanent/always-on inclusion and does not attempt to modify other skills or system-wide agent settings. It writes only to the note-directory cache (.embeddings) and its own config/config.json.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install zettel-link
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /zettel-link 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.3
- Added _meta.json file for metadata tracking and improved skill management. - No changes to core features or functionality.
v1.1.2
Security hardening: switch Gemini to header-based auth, add URL validation, and declare env vars
v1.1.1
Security patch: support local .env for keys
v1.1.0
Support loading API keys from local .env to improve security posture and reduce environment scanning suspicion
v1.0.0
Initial release
元数据
Slug zettel-link
版本 1.1.3
许可证
累计安装 2
当前安装数 2
历史版本数 5
常见问题

Zettel Link 是什么?

This skill maintains the Note Embeddings for Zettelkasten, to search notes, retrieve notes, and discover connections between notes. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 592 次。

如何安装 Zettel Link?

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

Zettel Link 是免费的吗?

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

Zettel Link 支持哪些平台?

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

谁开发了 Zettel Link?

由 Xiaoyu Kevin Hu(@hxy9243)开发并维护,当前版本 v1.1.3。

💬 留言讨论