Win11 + WSL2 环境下 Hermes Agent 接入 Obsidian 知识库

Win11 + WSL2 环境下 Hermes Agent 接入 Obsidian 知识库

前言

---

最近在 Win11 上用 WSL2（Ubuntu）跑 Hermes Agent，桌面端用 Obsidian 管理笔记。想把两者打通，这样 AI 写的笔记可以直接进 Obsidian vault，Obsidian 里整理的资料 Hermes 也能搜到。

搜了一圈方案：WSL2 网络共享、NFS 挂载、符号链接同步……部署和维护都比较麻烦。后来发现 Hermes Agent 自带 Obsidian skill，配置起来很简单。记录一下具体流程留作后续参考。

正文

---

1. 环境信息

系统: Win11
子系统: WSL2 (Ubuntu)
Hermes Agent: v0.13.0 (2026.5.7)
Obsidian: 安装在 D:\obsidian
Obsidian vault: D:\obsidian_work\knowledge\

PS: 使用 hermes --version 可以查看自己当前的 Hermes 版本。

2. 配置流程

WSL2 中 Windows 各盘符挂载在 /mnt/ 下，D 盘对应的路径是 /mnt/d/。

# 确认 vault 路径在 WSL2 中可访问
ls /mnt/d/obsidian_work/knowledge/
# 应看到 .obsidian/ 配置目录和 .md 笔记文件

在 ~/.hermes/.env 中添加环境变量：

export OBSIDIAN_VAULT_PATH=/mnt/d/obsidian_work/knowledge

PS: 可以直接在微信或终端告诉 Hermes 你的 vault 路径，让它自动配置，不需要手动编辑文件。

3. 使用效果

配置完成后，Hermes 可以直接读写 vault 中的 Markdown 文件。日常使用场景：

• 讨论完一个技术方案后说：把刚才的结论记到知识库
• 遇到以前解决过的问题说：搜一下之前记录的 Docker 部署笔记
• 在 Obsidian 中写的新笔记，Hermes 下次对话就能读到

4. 注意事项

• Hermes Agent 自带 Obsidian skill，不需要额外安装插件或扩展
• vault 路径中如果包含空格，传参时注意转义
• WSL2 重启后 /mnt/ 挂载自动恢复，无需重新配置

---

以上内容由 Hermes Agent 根据实际配置过程记录。