Obsidian AI Agent 配置指南：Claudian + Obsidian Skills

📋 概述

Claudian 是一个将 Claude Code 集成到 Obsidian 的第三方插件，配合 Obsidian Skills 可以在 Obsidian 中获得强大的 AI 能力。

核心组件

组件	说明
Claudian	Obsidian 第三方插件，适配 Claude Code API，提供 AI 聊天界面
Obsidian Skills	由 Obsidian CEO (Kepano) 发布的 Skill 包，赋予 AI 处理 Canvas、Markdown、Bases 等能力

---

🚀 快速开始

环境要求

• ✅ 已安装 Obsidian
• ✅ 已配置 Claude Code（或兼容模型如 DeepSeek、GLM）
• ✅ Node.js 环境（可选，用于开发自定义 Skills）

安装时间估算

• Claudian: ~5 分钟
• Obsidian Skills: ~3 分钟
• 总时间: 约 10 分钟即可完成配置

---

📦 安装步骤

第一步：安装 Claudian 插件

Claudian 暂未上架官方市场，需要手动安装：

1. 获取插件文件
   访问 GitHub: claudian，下载以下三个核心文件：

   • main.js
   • manifest.json
   • styles.css

2. 放置插件文件

   Obsidian 仓库根目录/
   └── .obsidian/
       └── plugins/
           └── claudian/
               ├── main.js
               ├── manifest.json
               └── styles.css
   

3. 启用插件

   • 重启 Obsidian
   • 进入「设置」→「第三方插件」
   • 找到「Claudian」并启用

第二步：配置模型参数

在 Claudian 设置中进行基础配置：

1. 打开设置页

   • Ctrl/Cmd + P 打开命令面板
   • 输入 claudian → 选择 Open chat view

2. 基础设置

   • 设置 User Name（如：Jason）
   • 选择界面主题（明亮/暗黑）

3. 配置 AI 模型

   使用国内模型示例（智谱 GLM）：

   ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
   ANTHROPIC_API_KEY=你的智谱_api_key
   ANTHROPIC_DEFAULT_OPUS_MODEL=GLM-4.6
   

   使用 DeepSeek 示例：

   ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
   ANTHROPIC_API_KEY=你的deepseek_api_key
   ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-chat
   

4. 验证连接

   • 在聊天界面输入「你好」
   • 收到正常回复即配置成功

第三步：部署 Obsidian Skills

1. 下载 Skills 包
   访问 GitHub: obsidian-skills：

   • 点击「Code」→「Download ZIP」
   • 下载 obsidian-skills-main.zip 并解压

2. 安装到 Claude 目录

   用户根目录/
   └── .claude/
           └── skills/
               ├── obsidian-markdown/
               ├── json-canvas/
               ├── obsidian-bases/
               └── (其他 skills)
   

   Windows 用户路径: C:\Users\你的用户名\.claude\skills\
   macOS/Linux 用户路径: ~/.claude/skills/

3. 验证安装

   • 重启 Claude Code / Claudian
   • 在聊天界面输入 /skills
   • 应显示已安装的 skills 列表

---

🎯 核心 Skills 说明

1. obsidian-markdown

功能	说明
双链支持	[[笔记名称]] 语法
嵌入语法	![[笔记名称]] 嵌入内容
标签系统	#标签 标签支持
Front Matter	YAML 属性处理
Callouts	> [!note] 引用块

适用场景: 创建和编辑 Obsidian 格式的笔记

2. json-canvas

功能	说明
节点类型	text, file, link, group
连接线	边 (edges) 连接节点
颜色标记	6 种预设颜色 + 自定义颜色
布局	自由画布，无限扩展

适用场景: 创建思维导图、知识图谱、流程图

3. obsidian-bases

功能	说明
视图类型	表格视图、看板视图、列表视图
过滤器	基于属性筛选笔记
公式	计算字段值
汇总	统计和聚合数据

适用场景: 项目管理、任务追踪、数据汇总

---

💡 实战应用

用例 1：生成知识图谱

指令:

使用 json-canvas skill 创建一个关于「地中海饮食」的知识结构图，包含核心原则、主要食物、健康益处、烹饪方式四个部分。

执行流程:

1. AI 分析需求
2. 调用 json-canvas skill
3. 自动生成节点和连接
4. 保存 .canvas 文件到 vault 根目录

结果: 可在 Obsidian 中直接打开 .canvas 文件查看

用例 2：批量创建笔记

指令:

根据以下大纲使用 obsidian-markdown skill 创建笔记：

# 项目规划
## 需求分析
## 技术选型
## 实施计划
## 风险评估

执行流程:

1. AI 解析大纲
2. 调用 obsidian-markdown skill
3. 应用 Obsidian 特有语法（双链、标签等）
4. 创建 .md 文件

---

⚙️ 高级配置

优化中文指令

由于 Skill 定义为英文，中文指令可能导致匹配偏差：

方案一：显式指定

请使用 json-canvas skill 帮我创建一个思维导图

方案二：添加系统提示词

在 Claudian 设置 → System Prompt 中添加：

当收到中文指令时，优先思考并匹配最合适的 Obsidian Skill 执行任务。
支持的 Skills：obsidian-markdown, json-canvas, obsidian-bases

自定义 Skills

Claudian 使用的 Skills 与 Claude Code 完全兼容，因此：

1. 编写自定义 Skill

   • 在 .claude/skills/your-skill/ 创建 SKILL.md
   • 遵循 Agent Skill 规范

2. Skill 结构示例

   ---
   name: my-custom-skill
   description: 自定义技能描述
   ---
   
   # My Custom Skill
   
   ## When to Use
   当用户需要执行 X 任务时使用
   
   ## Instructions
   1. 执行步骤 A
   2. 执行步骤 B
   

3. 自动发现

   • 重启 Claude Code / Claudian
   • 输入 /skills 查看是否识别到新技能

---

🔧 故障排查

常见问题

问题	可能原因	解决方案
Skills 未显示	路径错误	检查 .claude/skills/ 路径是否正确
模型调用失败	API Key 错误	检查环境变量或配置中的 API Key
中文乱码	编码问题	确保文件使用 UTF-8 编码
Canvas 无法打开	文件格式错误	检查 JSON 语法是否正确

调试模式

1. 查看 Claudian 日志

   • Obsidian 设置 → Developer → Show Console
   • 查看技能调用和错误信息

2. 测试 Skill 单独

   # 在 Claude Code CLI 中测试
   claude
   > 使用 obsidian-markdown skill 创建测试笔记
   

---

📚 参考资源

官方文档

资源	链接
Claudian GitHub	github.com/YishenTu/claudian
Obsidian Skills	github.com/kepano/obsidian-skills
Agent Skills 规范	agentskills.io
Claude Code 官方	docs.anthropic.com

社区资源

资源	链接
Obsidian 中文社区	forum-zh.obsidian.md
Obsidian 插件市场	obsidian.md/plugins
Claude Code Skills	github.com/anthropics/claude-code-skills

---

🎯 最佳实践

1. Privacy First: 所有数据本地处理，不上传云端
2. Version Control: 将 .claude/ 目录加入 Git 版本控制
3. Skill 模块化: 将复杂任务拆分为多个小 Skill
4. 定期更新: 关注 Skills 仓库更新，获取新功能和修复

---

---

💡 核心理念：Why Local Agent?

官方态度 (Stephan Ango/Kepano)

方面	说明
发布渠道	选择在个人 GitHub 账号而非 Obsidian 官方账号发布，体现了「非官方强制」的定位
核心哲学	知行合一。坚持 Local-first 和 Privacy-first
不参与 AI 军备	不构建封闭的官方 AI 环境

差异化优势

对比	Notion	Obsidian + Claudian
数据存储	云端封闭	完全本地化
AI 能力	固定官方 AI	「手搓」适合自己的 AI Agent
隐私安全	平台掌握	用户完全控制
扩展性	受限	完全开源，可自定义