📄 工具详情 ⚙️ 安装教程 📚 使用教程
🛠
AI工具

Obsidian AI智能体客户端

基于 TypeScript · 开源 AI 工具，GitHub 社区精选
英文名：obsidian-agent-client
⭐ 2.1k Stars 🍴 180 Forks 💻 TypeScript 📄 Apache-2.0 🏷 AI 8.2分
8.2AI 综合评分
AI智能体Obsidian插件工作流自动化Claude集成开源工具
🌐 访问官网
✦ AI Skill Hub 推荐

Obsidian AI智能体客户端 是 AI Skill Hub 本期精选AI工具之一。已获得 2.1k 颗 GitHub Star，综合评分 8.2 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析
Obsidian AI智能体客户端 是一款基于 TypeScript 的开源工具，在 GitHub 上收获 2k+ Star，是AI智能体、Obsidian插件、工作流自动化、Claude集成领域中的优质开源项目。开源工具的最大优势在于代码完全透明，你可以审计每一行代码的安全性，也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。

**安装与环境准备**
Obsidian AI智能体客户端 依赖 TypeScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 TypeScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 Obsidian AI智能体客户端 的版本更新，及时通知重要功能变化。
📋 工具概览

在Obsidian笔记应用中集成AI智能体的开源工具。支持Claude、Gemini等多个AI模型，通过Agent Client Protocol标准协议实现工作流自动化。适合需要在笔记中调用AI能力进行代码生成、文本处理的知识工作者。

Obsidian AI智能体客户端 是一款基于 TypeScript 开发的开源工具，专注于 AI智能体、Obsidian插件、工作流自动化 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 2.1k
开发语言
TypeScript
支持平台
Windows / macOS / Linux
维护状态
持续维护，定期更新
开源协议
Apache-2.0
AI 综合评分
8.2 分
工具类型
AI工具
Forks
180
📖 中文文档
以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

在Obsidian笔记应用中集成AI智能体的开源工具。支持Claude、Gemini等多个AI模型，通过Agent Client Protocol标准协议实现工作流自动化。适合需要在笔记中调用AI能力进行代码生成、文本处理的知识工作者。

Obsidian AI智能体客户端 是一款基于 TypeScript 开发的开源工具，专注于 AI智能体、Obsidian插件、工作流自动化 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费，支持本地部署，数据完全自主可控
  • 活跃的 GitHub 开源社区，持续迭代更新
  • 提供详细文档和使用示例，新手友好
  • 支持自定义配置，灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。
安装命令
# 方式一：npm 全局安装
npm install -g obsidian-agent-client

# 方式二：npx 直接运行（无需安装）
npx obsidian-agent-client --help

# 方式三：项目依赖安装
npm install obsidian-agent-client

# 方式四：从源码运行
git clone https://github.com/RAIT-09/obsidian-agent-client
cd obsidian-agent-client
npm install
npm start
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。
常用命令 / 代码示例
# 命令行使用
obsidian-agent-client --help

# 基本用法
obsidian-agent-client [options] <input>

# Node.js 代码中使用
const obsidian_agent_client = require('obsidian-agent-client');

const result = await obsidian_agent_client.run(options);
console.log(result);
以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。
配置示例
# obsidian-agent-client 配置说明
# 查看配置选项
obsidian-agent-client --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export OBSIDIAN_AGENT_CLIENT_CONFIG="/path/to/config.yml"
📑 README 深度解析 真实文档 完整度 52/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

简介

Agent Client Plugin for Obsidian

<p align="center"> <img src="https://img.shields.io/github/downloads/RAIT-09/obsidian-agent-client/total" alt="GitHub Downloads"> <img src="https://img.shields.io/github/license/RAIT-09/obsidian-agent-client" alt="License"> <img src="https://img.shields.io/github/v/release/RAIT-09/obsidian-agent-client" alt="GitHub release"> <img src="https://img.shields.io/github/last-commit/RAIT-09/obsidian-agent-client" alt="GitHub last commit"> <a href="https://github.com/RAIT-09/obsidian-agent-client/discussions"><img src="https://img.shields.io/github/discussions/RAIT-09/obsidian-agent-client" alt="GitHub Discussions"></a> </p>

<p align="center"> <a href="README.ja.md">日本語はこちら</a> </p>

<p align="center"> <a href="https://community.obsidian.md/plugins/agent-client" target="_blank"><img src="https://img.shields.io/badge/Add%20to%20Obsidian-7c3aed?logo=obsidian&logoColor=white&style=for-the-badge" alt="Add to Obsidian"></a> </p>

<p align="center"> <a href="https://www.buymeacoffee.com/rait09" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="180" height="50" ></a> </p>

Bring AI agents (Claude Code, Codex, Gemini CLI) directly into Obsidian. Chat with your AI assistant right from your vault.

Built on Agent Client Protocol (ACP) by Zed.

https://github.com/user-attachments/assets/1c538349-b3fb-44dd-a163-7331cbca7824

Features

  • Note Mentions: Reference your notes with @notename syntax
  • Image Attachments: Paste or drag-and-drop images into the chat
  • Slash Commands: Use / commands provided by your agent
  • Multi-Agent Support: Switch between Claude Code, Codex, Gemini CLI, and custom agents
  • Multi-Session: Run multiple agents simultaneously in separate views
  • Floating Chat: A persistent, collapsible chat window for quick access
  • Mode & Model Switching: Change AI models and agent modes from the chat
  • Session History: Resume or fork previous conversations
  • Chat Export: Save conversations as Markdown notes
  • Terminal Integration: Let agents execute commands and return results
  • MCP Support: Agents use their configured MCP servers — no extra setup needed in the plugin

Installation

Manual Installation

  1. Download main.js, manifest.json, styles.css from Releases
  2. Place them in VaultFolder/.obsidian/plugins/agent-client/
  3. Enable the plugin in Settings → Community Plugins

Setup Guides

Full Documentation

Quick Start

Open a terminal (Terminal on macOS/Linux, PowerShell on Windows) and run the following commands.

1. Install an agent and its ACP adapter (e.g., Claude Code): 

   curl -fsSL https://claude.ai/install.sh | bash   # Install Claude Code
   npm install -g @agentclientprotocol/claude-agent-acp   # Install ACP adapter

2. Login (skip if using API key): 

   claude
Follow the prompts to authenticate with your Anthropic account.

3. Find the paths: 

   which node   # macOS/Linux
   which claude-agent-acp

   where.exe node   # Windows
   where.exe claude-agent-acp

4. Configure in Settings → Agent Client: - Node.js path: e.g., /usr/local/bin/node - Built-in agents → Claude Code → Path: e.g., /usr/local/bin/claude-agent-acp (not claude) - API key: Add your key, or leave empty if logged in via CLI

  1. Start chatting: Click the robot icon in the ribbon
🎯 aiskill88 AI 点评 A 级 2026-05-22

创新地将AI智能体集成入Obsidian生态，2.1k星体现认可度。基于标准协议设计具有良好扩展性，TypeScript实现代码质量有保障。适合构建个人AI辅助工作流。

⚡ 核心功能
👥 适合人群
AI 技术爱好者研究人员和学生开发者和工程师技术创业者
🎯 使用场景
  • 本地部署运行，保护数据隐私，满足合规要求
  • 自定义集成到现有系统，扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
✅ 优点
  • +Apache-2.0 协议，可免费商用
  • +完全开源免费，无授权费用
  • +本地部署，数据完全自主可控
  • +开发者社区支持，遇问题可查可问
⚠️ 不足
  • −安装和初始配置可能需要一定技术基础
  • −功能完整性通常不如成熟商业产品
  • −技术支持主要依赖开源社区，响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。

🔗 相关工具推荐
AutoGPT 自主AI代理
AI工具
Ruflo智能编排平台
Claude多智能体编排领先平台，提供完整的agentic框架和工作流管理。支持智能RAG、多智能体协作和工作流定制。适
Claude代码智能体系统
基于Claude的MCP开源智能体框架，集成技能、本能、记忆和搜索能力。通过优化agent性能，支持复杂代码生成和自动化
OpenHands Agent工作流
AI工具
📚 相关教程推荐
n8n vs Make vs Zapier 2025：哪款工作流自动化工具最适合 AI 时代
帮助中心 · AI Skill Hub
MCP 工作流生产级配置方案：从开发环境到团队共享
帮助中心 · AI Skill Hub
n8n vs Make vs Zapier 2025：哪款工作流自动化工具最适合 AI 时代
帮助中心 · AI Skill Hub
MCP 工作流生产级配置方案：从开发环境到团队共享
帮助中心 · AI Skill Hub
❓ 常见问题 FAQ
obsidian-agent-client 是一款TypeScript开发的AI辅助工具。开源AI工作流：Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Co。⭐2.1k · TypeScript 主要应用场景包括：在笔记中调用AI进行代码生成、自动化文档处理和总结、AI辅助知识管理。
💡 AI Skill Hub 点评

经综合评估，Obsidian AI智能体客户端 在AI工具赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。

📚 深入学习 Obsidian AI智能体客户端
查看分步骤安装教程和完整使用指南，快速上手这款工具
⚙️ 安装教程 📚 使用教程
🌐 原始信息
原始名称 obsidian-agent-client
原始描述 开源AI工作流：Bring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Co。⭐2.1k · TypeScript
Topics AI智能体Obsidian插件工作流自动化Claude集成开源工具
GitHub https://github.com/RAIT-09/obsidian-agent-client
License Apache-2.0
语言 TypeScript
🔗 原始来源
🐙 GitHub 仓库  https://github.com/RAIT-09/obsidian-agent-client 🌐 官方网站  https://rait-09.github.io/obsidian-agent-client/

收录时间：2026-05-21 · 更新时间：2026-05-22 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。