obsidian-copilot

在 Obsidian 里直接调用 AI，让笔记秒变智能工作台

obsidian-copilot 是 Obsidian 笔记软件中的 AI 助手插件，将 ChatGPT 等大语言模型能力直接嵌入笔记工作流。它解决的核心问题是用户需要在笔记应用和 AI 对话工具之间频繁切换的痛点，让 AI 能直接读取、理解并操作当前笔记内容。插件提供聊天面板、笔记问答、内容生成、文本改写、摘要提取、翻译等核心能力，支持自定义提示词模板和多种 AI 模型接入。用户可以在不离开 Obsidian 的情况下，对选中文本进行润色、扩写、总结，或基于整个笔记库进行智能问答。项目采用 TypeScript 开发，架构清晰，社区活跃，是 Obsidian 生态中功能最全面的 AI 插件之一。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7751

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队logancyang

所属国家

官网地址https://www.obsidiancopilot.com

GitHubhttps://github.com/logancyang/obsidian-copilot

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议AGPL-3.0

主要语言TypeScript

技术栈/模型ai,aiagent,chatgpt,copilot,obsidian-plugin

GitHub 星标★ 7751

30天Star增速

HF 下载量

上线时间2023-03-31 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 4 步

环境要求

已安装 Obsidian 笔记软件
可访问 Obsidian 社区插件市场
如使用 Claude Code，需本机已有安装并登录
如使用 Codex，需已有 Codex 登录

安装与启动步骤

1安装 Copilot 插件

在 Obsidian 社区插件中搜索并安装 Copilot，或直接打开官方插件页面点击 Install。安装后在插件列表中启用。
2打开 Agent 设置

进入 Obsidian 设置，依次打开 Copilot → Basic → Agents，这里是选择 Agent 后端的地方。
3选择 Agent 后端

三选一：点 Download opencode（推荐，由 Copilot 下载并管理）；用 Auto-detect 连接已装的 Claude Code；或让 Copilot 安装其测试过的 Codex 适配器。
4打开 Agent 聊天窗口

点击侧边栏的 Agent 功能区图标，或运行命令 Open Copilot Agent Chat Window，即可开始对话。

关键配置

配置项	必填	说明	示例
`Agents（Agent 后端）`	是	选择 opencode、Claude Code 或 Codex 作为执行 Agent	`opencode`
`模型来源`	否	opencode 可用 Copilot 托管模型、自有 provider key 或本地模型	`自有 provider key`

如何确认成功

点击 Agent 功能区图标能正常打开 Agent 聊天窗口，即表示插件安装与 Agent 配置成功。

常见问题

Q：安装后在哪里配置 Agent？

A：打开设置 → Copilot → Basic → Agents，在此选择并连接 opencode、Claude Code 或 Codex。

Q：没有 Claude Code 或 Codex 可以只用 opencode 吗？

A：可以。opencode 是推荐方式，Copilot 可代为下载和管理，并支持 Copilot 托管模型、自有 provider key 或本地模型。

Q：已经有 Claude 或 ChatGPT 付费账号，还要再付费吗？

A：README 中该段内容被截断，未给出完整说明，请查看官网定价页 https://www.obsidiancopilot.com/en/pricing 确认。

Q：Codex 是怎么接入的？

A：通过 @agentclientprotocol/codex-acp 适配器连接，并使用你已有的 Codex 登录；Copilot 也可安装其测试过的适配器。

注意事项

插件必须通过 Obsidian 社区插件安装，无法脱离 Obsidian 单独运行。
Claude Code 需先在本机安装并登录，Copilot 会自动检测常见安装位置。
更详细的各条安装路径见官方文档 docs/getting-started.md。

核心亮点

深度集成笔记上下文，AI 能直接读取当前文件或整个库进行问答和操作
支持自定义提示词模板，可针对不同写作场景快速复用
模型接入灵活，兼容 OpenAI、Anthropic 及本地模型，满足隐私需求

不足之处

高度依赖 API 密钥和网络，离线场景下功能受限
复杂提示词配置对新手有一定学习成本
文档/社区待观察

适用场景

写作者用 AI 对笔记进行实时润色、扩写和续写
研究者基于笔记库进行跨文档问答和知识梳理
知识管理者用 AI 自动生成摘要、标签和关联建议

替代项目

obsidian-textgenerator、smart-connections、obsidian-ai

项目介绍

obsidian-copilot 是对话助手领域的开源项目，由 logancyang 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（7,751）位列前 6%，在对话助手分类的 905 个项目里位列前 4%。

近 44 天，它的 GitHub 星标从 7,538 增加到 7,751，净增 213。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：写作者用AI对笔记进行实时润色、扩写和续写。同类可对比的替代方案包括 obsidian-textgenerator、smart-connections、obsidian-ai。

上一篇：ollama-client

下一篇：SmsForwarder