Obsidian AI Agent 配置指南：Claudian + Obsidian

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

📋 概述

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

核心组件

🚀 快速开始

环境要求

• ✅ 已安装 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
   • 进入「设置」→「第三方插件」
   • 找到「Claudian」并启用

放置插件文件

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

第二步：配置模型参数

在 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 

第三步：部署 Obsidian Skills

1. 下载 Skills 包
   访问 GitHub: obsidian-skills：
   • 点击「Code」→「Download ZIP」
   • 下载 obsidian-skills-main.zip 并解压
2. 验证安装
   • 重启 Claude Code / Claudian
   • 在聊天界面输入 /skills
   • 应显示已安装的 skills 列表

安装到 Claude 目录

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

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

🎯 核心 Skills 说明

1. obsidian-markdown

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

2. json-canvas

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

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. 自动发现
   • 重启 Claude Code / Claudian
   • 输入 /skills 查看是否识别到新技能

Skill 结构示例

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

🔧 故障排查

常见问题

调试模式

1. 查看 Claudian 日志
   • Obsidian 设置 → Developer → Show Console
   • 查看技能调用和错误信息

测试 Skill 单独

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

📚 参考资源

官方文档

社区资源

🎯 最佳实践

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

💡 核心理念：Why Local Agent?

官方态度 (Stephan Ango/Kepano)

差异化优势