← 返回 Skills 市场
Siyuan Agent
作者
Yi Lok Enoch Lam
· GitHub ↗
· v2.0.6
· MIT-0
141
总下载
0
收藏
0
当前安装
10
版本数
在 OpenClaw 中安装
/install siyuan-agent
功能描述
Interact with SiYuan notes via direct HTTP API. Use when reading, writing, searching, or managing SiYuan blocks, documents, notebooks, attributes, assets, or...
安全使用建议
This skill appears to implement exactly what it claims (a SiYuan HTTP API CLI) and enforces reasonable write and SQL restrictions, but the package metadata omitted the required SIYUAN_TOKEN. Before installing: (1) Confirm you set SIYUAN_TOKEN — the tool will exit without it; (2) Keep SIYUAN_BASE at the default localhost unless you intentionally want to point it elsewhere (setting it to a remote URL will send your token and data to that host); (3) Inspect the small JS files (they're included and readable) to verify no unexpected network targets; (4) Prefer minimizing agent autonomy or restricting the skill's use until you trust the publisher; and (5) Verify the publisher/slug/source — the registry metadata inconsistency could be a packaging error, but treat it as a warning.
功能分析
Type: OpenClaw Skill
Name: siyuan-agent
Version: 2.0.6
The siyuan-agent skill is a legitimate tool for interacting with the SiYuan note-taking application via its HTTP API. It implements several safety features, including a mandatory 'write=true' flag for destructive operations, a blocklist of sensitive notebook management endpoints (FORBIDDEN_PATHS in siyuan.js), and basic SQL validation to restrict queries to SELECT statements. The code is transparent, uses native fetch without external dependencies, and only communicates with the user-configured SIYUAN_BASE endpoint.
能力评估
Purpose & Capability
Name/description (SiYuan HTTP API client) matches the code and SKILL.md: the tool needs a SiYuan API token and optionally a base URL. However the registry metadata lists no required env vars while SKILL.md and lib/api.js require SIYUAN_TOKEN (primaryCredential). This metadata omission is an incoherence that could mislead users about credential requirements.
Instruction Scope
SKILL.md instructions are specific and align with the implemented commands. The skill enforces SELECT-only for sql, requires write=true for write operations, and hard-blocks certain notebook-management paths. The runtime instructions do not request unrelated files or credentials.
Install Mechanism
No install spec (instruction-only plus small JS files included). There are no external downloads or package installs — low install risk.
Credentials
The only credential used is SIYUAN_TOKEN (appropriate for a SiYuan API client). But the registry metadata failing to declare this required env var is a red flag. Additionally SIYUAN_BASE (default localhost) is user-configurable; if set to a remote host it would cause the skill to send the token and data to that host, enabling token exfiltration if misconfigured or maliciously set.
Persistence & Privilege
Skill does not request always:true and does not modify other skills or system configs. Autonomous invocation is allowed (platform default) but not combined with elevated privileges in this package.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install siyuan-agent - 安装完成后,直接呼叫该 Skill 的名称或使用
/siyuan-agent触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.6
- Added author field ("eloklam") to skill metadata.
- No functional or command changes; documentation improvement only.
v2.0.5
- Documentation reformatted in SKILL.md for improved clarity and consistency.
- No changes to functionality or commands—behavior remains the same.
v2.0.4
- Removed SIYUAN_BASE from the required environment variables.
- Only SIYUAN_TOKEN is now required for setup and authentication.
v2.0.3
- Added a metadata section to SKILL.md, declaring required environment variables (SIYUAN_TOKEN, SIYUAN_BASE) and primary credential.
- No changes to commands, usage, or behavior; documentation update only.
v2.0.2
**Major simplification and refactor: direct HTTP API, no dependencies**
- Dropped opencli dependency and adapter layer; now uses only direct HTTP API.
- New CLI (`siyuan.js`) with clear `read`, `write`, and `call` commands.
- All write commands require `write=true` flag for protection.
- SQL command limited strictly to SELECT statements for safety.
- Notebook management API paths are hard-blocked for safety.
- Updated documentation for setup, commands, and usage examples.
v2.0.1
Version 2.0.1
- Internal changes in `siyuan.js` (see repo for details)
- No changes to user-facing features, commands, or documentation
- All usage instructions, command references, and operational notes remain the same
v2.0.0
README improvements — install guide, CLI usage, agent-first
v1.0.2
fix: util/client.js respects SIYUAN_BASE; isWritePath covers all read-only endpoints; package.json declares SIYUAN_TOKEN + SIYUAN_BASE as required env vars
v1.0.1
fix: README — opencli adapter, not MCP server
v1.0.0
Initial release
元数据
常见问题
Siyuan Agent 是什么?
Interact with SiYuan notes via direct HTTP API. Use when reading, writing, searching, or managing SiYuan blocks, documents, notebooks, attributes, assets, or... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 141 次。
如何安装 Siyuan Agent?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install siyuan-agent」即可一键安装,无需额外配置。
Siyuan Agent 是免费的吗?
是的,Siyuan Agent 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Siyuan Agent 支持哪些平台?
Siyuan Agent 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Siyuan Agent?
由 Yi Lok Enoch Lam(@eloklam)开发并维护,当前版本 v2.0.6。
推荐 Skills