文档大纲

打造专属工作大脑:让OpenClaw优先使用你的私有工作知识库Obsidian

在使用 openclaw 搭建业务 AI Agent 时,普遍会遇到一个核心痛点:Agent 默认优先联网检索,容易引入无关、过时甚至错误的公网信息。即便已经使用Obsidian搭建了专业的知识系统,小龙虾还是无法复用你在 Obsidian 中沉淀的业务规范、项目案例、工作流程等私有知识,导致输出结果不贴合实际业务、重复造轮子、一致性难以保障。

本文针对「私有知识无法优先调用、联网检索不可控、Agent 行为不统一」三大问题,提供一套温和且可落地的配置方法,通过 OpenClaw 内置的记忆体系、Obsidian 本地知识库与可选的 GBrain 知识图谱三层协作,让 Agent 始终以本地知识库为核心依据,公网信息做兜底补充,真正实现私有知识可控、AI 输出稳定、经验持续沉淀。

看不懂?让小龙虾帮你快速落地:
本文及本站大部分openclaw相关文章,都可以让OpenClaw agent阅读,然后进行应用,参考Prompt如下:

请阅读这篇文章:
https://www.aiec.fun/%e6%89%93%e9%80%a0%e4%b8%93%e5%b1%9e%e5%b7%a5%e4%bd%9c%e5%a4%a7%e8%84%91%ef%bc%9a%e8%ae%a9openclaw%e4%bc%98%e5%85%88%e4%bd%bf%e7%94%a8%e4%bd%a0%e7%9a%84%e7%a7%81%e6%9c%89%e5%b7%a5%e4%bd%9c%e7%9f%a5/ 
分析有哪些内容,对我们优化工作流程有价值,并严格根据openclaw最新官方文档核对,排除错误及过时信息,制定落地计划。

一、核心工作逻辑

本方案遵循「本地知识库优先,公网信息兜底」的智能检索流程,既保证工作内容贴合你的业务规范,又不丧失实时信息处理能力。

二、Obsidian 与 OpenClaw 基础对接

OpenClaw 通过memory-wiki插件与 Obsidian 进行集成,配合内置的memory_search工具实现知识库检索。无需手动创建软链接,直接通过配置文件指定 Obsidian vault 路径即可。

1. 工作区目录规范

在 OpenClaw 工作区建立 Obsidian 关联目录,用于统一管理知识库读写权限:

your-workspace/
├── skills/ # 自定义技能目录
├── memory/      # 每日记忆文件
├── knowledge-base/  # 知识库文档
├── AGENTS.md
├── SOUL.md
└── TOOLS.md

2. 配置 Obsidian Vault 路径

通过memory-wiki插件配置 Obsidian vault 路径,在~/.openclaw/openclaw.json中添加:

{
  "plugins": {
    "entries": {
      "memory-wiki": {
        "enabled": true,
        "config": {
          "vault": {
            "path": "/你的/Obsidian/仓库路径"
          },
          "bridge": {
            "enabled": true
          }
        }
      }
    }
  }
}

3. 基础连通性测试

在 OpenClaw 交互窗口中执行以下指令,验证文件访问正常:

openclaw wiki obsidian status
openclaw wiki obsidian search "业务关键词"

三、优先级配置:让 Agent 优先使用 Obsidian 知识

不采用激进的禁用联网策略,通过技能加载优先级 + 提示词强约束,实现 Obsidian 优先检索。

1. 技能加载优先级设置

OpenClaw 原生遵循工作区技能 > 全局技能 > 内置技能的调用顺序,将 Obsidian 相关检索工具放置在工作区技能目录,保证优先触发。

2. 检索权重与行为规范

通过 Agent 行为规则,固定检索顺序:

  • 先读取 Obsidian 中的流程、规范、历史案例
  • 本地信息不足时,自动进行联网补充
  • 外部信息需与本地知识做交叉校验

四、Agent 行为约束配置

通过 AGENTS.md 引用子配置文件的方式,固化 Agent 的知识使用逻辑。

## 知识检索与执行规范
1. 处理任何工作任务,第一步必须检索 Obsidian 本地知识库。
2. 若本地存在完整方案、标准或案例,直接以此为依据完成任务。
3. 本地知识缺失或不完整时,可自动联网检索补充信息,无需人工确认。
4. 任务产出的新经验、新结论,自动整理并写入 Obsidian 更新知识库。
5. 外部信息仅作为补充,不得与本地已有规范冲突。
6. 以 Obsidian 中的私有工作知识为核心依据,保持输出一致性与专业性。
7. 优先使用你沉淀的业务流程、操作规范与历史经验。
8. 主动维护知识库,将新的工作成果同步归档,持续迭代知识体系。
9. 公网信息仅用于补充未知内容,不替代本地核心知识。

五、运行验证与日志排查

配置完成后,可通过任务执行结果判断优先级是否生效:

  • 本地知识覆盖场景:Agent 直接引用 Obsidian 内容,无联网行为
  • 本地知识缺失场景:Agent 先检索本地,再自动联网补充
  • 知识沉淀场景:任务完成后自动生成笔记更新知识库

如需排查检索行为,可通过 OpenClaw 原生日志查看工具调用顺序,确认 Obsidian 检索优先触发。

附件:可直接复制的完整配置模板

1. 知识检索规范(建议添加到 AGENTS.md 或独立配置文件)

## 核心执行规则
1. 处理任何工作任务,第一步必须检索 Obsidian 本地知识库。
2. 若本地存在完整方案、标准或案例,直接以此为依据完成任务。
3. 本地知识缺失或不完整时,可自动联网检索补充信息,无需人工确认。
4. 任务产出的新经验、新结论,自动整理并写入 Obsidian 更新知识库。
5. 外部信息仅作为补充,不得与本地已有规范冲突。

2. SOUL.md 补充片段

## 工作风格
- 以 Obsidian 中的私有工作知识为核心依据,保持输出一致性与专业性。
- 优先使用你沉淀的业务流程、操作规范与历史经验。
- 主动维护知识库,将新的工作成果同步归档,持续迭代知识体系。
- 公网信息仅用于补充未知内容,不替代本地核心知识。

3. memory-wiki 插件配置示例

{
  "plugins": {
    "entries": {
      "memory-wiki": {
        "enabled": true,
        "config": {
          "vault": {
            "path": "~/Obsidian/你的Vault名称"
          },
          "bridge": {
            "enabled": true
          }
        }
      }
    }
  }
}

4. 可选:GBrain 知识图谱(团队增强层)

如果你的团队希望建立更强大的知识图谱关系网络,可以在 OpenClaw 基础上额外安装 GBrain。GBrain 是基于 Obsidian 的知识图谱增强工具,支持自动关系识别、语义搜索和跨页面链接。

安装方式:

npm install -g gbrain
mkdir -p ~/.gbrain/你的agent-id
gbrain init --engine pglite
gbrain import ~/Obsidian/你的Vault路径 --no-embed

GBrain 不是 OpenClaw 的必选项,而是团队自定义的增强层。如果只需要基础的 Obsidian 集成,使用memory-wiki插件即可。

阅读量: 353