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

配置 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)

差异化优势