用途:该 Skill 把思源笔记的 MCP 工具组织成稳定、可重复的工作流,告诉 OpenClaw 在何种情境使用哪些工具、如何组合并把结果写回笔记。MCP 与 Skill 分离,Skill 只描述用法,不涉及 MCP 内部实现。
先决条件:需设置 SIYUAN_TOKEN 与 SIYUAN_BASE_URL,并让 mcporter 配置名为 siyuan 的 MCP server,例如执行 mcporter config add siyuan --command "siyuan-mcp stdio --token $SIYUAN_TOKEN --baseUrl $SIYUAN_BASE_URL"。调用形式为 mcporter call siyuan.<tool_name> key=value,可用 mcporter list siyuan --all-parameters 查看工具与参数。
主要能力(MVP 工作流):快速记录写入今日 Daily Note(append_to_daily_note);新增 checkbox 待办;列出近 N 天未完成待办(list_daily_note_todos);按内容、文件名或标签搜索笔记(unified_search,必要时再 get_document_content);整理今日笔记(定位或创建今日文档,读取内容,产出 Inbox/TODO/今日整理区块后写回);生成周报草稿(先产出 Markdown,再决定是否写回,自动写回列为后续里程碑)。
使用方式示例:mcporter call siyuan.append_to_daily_note notebook_id="20260205161632-m9mibni" content="- [ ] 明天买电池";mcporter call siyuan.list_daily_note_todos notebook_id="20260205161632-m9mibni" days=7;mcporter call siyuan.unified_search content="kubernetes" limit=10。多行 Markdown 内容建议使用 content_file 参数,避免换行被写成字面 \n。
限制与注意:多行内容不要直接在参数中写 \n;若工具列表读不到,先检查 SIYUAN_TOKEN、SIYUAN_BASE_URL、思源是否在该 baseUrl 启动以及 mcporter 配置。整理与归档遵循最小原则:不自动搬移或删除文件,归档需用户确认,整理前建议快照。内部链接格式为 显示名称。上述每日笔记 notebook_id、路径策略等为资料中给出的默认值,其他环境需自行确认。