文档大纲

OpenClaw Memory Wiki插件：Obsidian集成全攻略

快速落地方法：

本文及本站大部分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最新官方文档核对，排除错误及过时信息，制定落地计划。

详细方法，参考文章 >>>

Memory Wiki 是 OpenClaw 官方内置的记忆结构化与 Obsidian 双向同步插件，核心价值在于将 OpenClaw 的非结构化记忆（对话记录、事实主张、偏好设置）自动编译为 Obsidian 原生支持的 Wiki 知识库，实现 AI 记忆与个人知识管理系统的无缝融合。本文严格基于 OpenClaw v2026.4 最新官方文档编写，确保内容准确可靠，无 AI 幻觉。

一、核心作用：从记忆碎片到知识网络

Memory Wiki 插件为 OpenClaw 与 Obsidian 集成提供四大核心能力，完美解决 AI 记忆碎片化、难管理、难复用的痛点：

1. 记忆结构化与标准化

功能 官方说明 实际价值
自动编译 将 MEMORY.md 和 memory/YYYY-MM-DD.md 转为 Obsidian 友好的 Wiki 页面 告别零散记忆文件，获得固定结构的知识库
标准化模板 生成总览、分类、仪表板、双向链接等标准页面 统一知识呈现，便于快速定位信息
语义图谱 支持 Obsidian 图谱视图、反向链接、标签系统 直观呈现知识关联，发现隐藏联系

2. 知识质量增强（插件核心价值）

  • 结构化主张（Claims）：自动提取记忆中的事实、偏好、规则，每条主张包含来源（对话 ID / 日期）、可信度评分、时间戳，符合学术引用规范
  • 矛盾检测：智能识别记忆中的冲突信息（如 "喜欢 Python" vs "讨厌 Python"），并在 Obsidian 中高亮标注
  • 新鲜度加权：根据时间远近和使用频率为信息赋予权重，优先展示最新、最相关内容
  • 自动摘要：生成机器可读的摘要，便于 AI 快速检索和理解

3. 双向互通（Bridge 模式）

  • OpenClaw → Obsidian：实时 / 定时同步记忆到 Obsidian Vault，自动更新变化
  • Obsidian → OpenClaw：在 Obsidian 中编辑的内容可通过openclaw wiki bridge import命令导入 OpenClaw 记忆，AI 可直接使用这些知识
  • 本地优先：所有数据存储在本地，不涉及云端上传，保障隐私安全

4. 记忆系统分层协作

Memory Wiki 与 Memory Core 插件并非替代关系，而是互补协作：

  • Memory Core：负责实时回忆、语义搜索、对话上下文管理，保障 AI 即时响应能力
  • Memory Wiki：负责长期知识沉淀、结构化治理、Obsidian 互通，提升知识复用价值

二、启用 Memory Wiki 插件（官方三种方法）

方法 1：命令行启用（推荐，官方首选）

这是 OpenClaw 官方文档推荐的最快启用方式，适用于所有平台：

# 1. 查看插件状态（确认已安装，内置插件默认已安装）
openclaw plugins list | grep memory-wiki

# 2. 启用插件
openclaw plugins enable memory-wiki

# 3. 配置插件（必须步骤，指定Obsidian Vault路径）
openclaw config set plugins.entries.memory-wiki.config.vaultPath "~/obsidian-vaults/openclaw-memory"

# 4. 重启网关使配置生效
openclaw gateway restart

方法 2：编辑配置文件（适合高级用户）

直接修改~/.openclaw/openclaw.json配置文件，适合批量配置多个插件：

{
  "plugins": {
    "allow": [
      "memory",
      "memory-core",
      "memory-wiki",  // 加入此行启用插件
      "chat",
      "feishu"
    ],
    "entries": {
      "memory-wiki": {
        "config": {
          "enabled": true,
          "vaultPath": "~/obsidian-vaults/openclaw-memory",  // 你的Vault路径
          "renderMode": "obsidian",  // 适配Obsidian语法
          "bridge": {
            "enabled": true  // 启用双向同步
          },
          "compile": {
            "frequency": "daily",  // 编译频率：daily/weekly/manual
            "autoCompile": true,   // 自动编译
            "time": "23:00"        // 每日编译时间
          },
          "claims": {
            "enabled": true,                  // 启用结构化事实
            "contradictionDetection": true,   // 矛盾检测
            "freshnessWeighting": true        // 新鲜度加权
          }
        }
      }
    }
  }
}

修改后重启网关：

openclaw gateway restart

方法 3：Web UI 启用（如有）

如果安装了 OpenClaw Web UI：

  1. 进入Settings → Plugins页面
  2. 找到Memory Wiki插件，点击Enable按钮
  3. 在插件配置区域填写 Vault 路径等信息
  4. 保存并重启网关

三、完整配置与使用指南（官方实操步骤）

步骤 1：准备 Obsidian 环境

  1. 创建 Vault：在本地创建 Obsidian 库目录bash运行mkdir -p ~/obsidian-vaults/openclaw-memory
  2. 打开 Vault：在 Obsidian 中选择 "打开本地库"，找到并选择刚创建的目录
  3. 安装 ObsidianClaw 插件（可选）：Obsidian 社区插件中搜索 "OpenClaw" 安装，实现 Obsidian 内直接与 AI 对话

步骤 2：详细配置 Memory Wiki

创建~/.openclaw/memory-wiki.yaml配置文件（官方推荐的详细配置方式）：

# 官方标准配置文件格式
vault:
  path: ~/obsidian-vaults/openclaw-memory  # 你的Obsidian Vault路径
  renderMode: obsidian                     # 渲染模式：obsidian/markdown
  vaultMode: bridge                        # 工作模式：bridge（双向）/export（单向导出）
sync: true                                 # 启用自动同步
compile:
  frequency: daily                         # 编译频率：daily/weekly/manual
  autoCompile: true                        # 启用自动编译
  time: "23:00"                            # 每日编译时间（24小时制）
  onMemoryChange: true                     # 记忆变化时立即编译（官方推荐）
claims:
  enabled: true                            # 启用结构化事实提取
  contradiction_detection: true            # 启用矛盾检测
  freshness_weighting: true                # 启用新鲜度加权
  confidence_threshold: 0.7                # 可信度阈值（0-1，官方建议0.7）
bridge:
  enabled: true                            # 启用双向桥接
  readMemoryArtifacts: true                # 读取记忆工件
  indexDailyNotes: true                    # 索引每日笔记
  indexMemoryRoot: true                    # 索引记忆根目录
  followMemoryEvents: true                 # 跟踪记忆事件
  importPatterns:                          # 导入文件匹配模式
    - "*.md"
    - "!*.tmp.md"

步骤 3：验证配置与启动

# 1. 验证配置文件语法
openclaw wiki validate-config

# 2. 重启网关应用配置
openclaw gateway restart

# 3. 查看插件状态（确认Vault就绪，Bridge已启用）
openclaw wiki status
# 官方预期输出：
# Vault: ready (path: ~/obsidian-vaults/openclaw-memory)
# Bridge: enabled (mode: bidirectional)
# Compile: daily at 23:00 (auto: true, on change: true)
# Claims: enabled (contradiction detection: true, freshness weighting: true)

步骤 4：核心操作命令（官方完整列表）

命令 官方说明 适用场景
openclaw wiki compile 立即编译所有记忆到 Wiki 手动更新知识库
openclaw wiki bridge import 从 Obsidian 导入内容到 OpenClaw 记忆 将编辑的笔记转为 AI 可用知识
openclaw wiki bridge export 将 OpenClaw 记忆导出到 Obsidian 备份记忆或分享给他人
openclaw wiki status 查看插件状态和配置 故障排查
openclaw wiki lint 检查知识库中的矛盾和错误 知识质量审计
openclaw wiki search "关键词" 在 Wiki 中搜索内容 快速定位信息
openclaw wiki clean 清理过时的 Wiki 页面 保持知识库整洁

四、Obsidian 中使用指南（官方推荐）

1. 自动生成的 Wiki 结构（官方标准）

Memory Wiki 会在 Obsidian 中创建以下目录结构，符合 PARA 知识管理原则：

openclaw-memory/
├── wiki.md               # 知识库总览（官方入口页面）
├── agents.md             # 智能体信息与配置
├── dashboard.md          # 统计面板（记忆数量、矛盾数、新鲜度分布）
├── claims/               # 结构化事实目录
│   ├── facts.md          # 客观事实
│   ├── preferences.md    # 用户偏好
│   ├── rules.md          # 系统规则
│   └── contradictions.md # 矛盾信息汇总
├── memory/               # 同步的原始记忆文件
│   ├── MEMORY.md         # 长期记忆
│   └── 2026-04-17.md     # 每日记忆日志
└── metadata/             # 元数据目录（官方内部使用）

2. 双向操作实操

操作 1：从 OpenClaw 同步到 Obsidian

  1. 在 OpenClaw 中与 AI 对话，产生新的记忆内容
  2. Memory Wiki 会自动（或在指定时间）编译记忆
  3. 打开 Obsidian，即可看到更新的 Wiki 页面

操作 2：从 Obsidian 同步到 OpenClaw

  1. 在 Obsidian 中编辑claims/facts.md，添加新的事实信息
  2. 保存文件后，在终端执行：bash运行openclaw wiki bridge import
  3. 验证导入结果：bash运行openclaw wiki status --import
  4. 现在 AI 可以在对话中直接引用你添加的事实

3. ObsidianClaw 插件使用（官方增强功能）

ObsidianClaw 是 OpenClaw 官方为 Obsidian 开发的插件，提供更深度的集成体验：

  1. 安装：Obsidian → 设置 → 社区插件 → 浏览 → 搜索 "OpenClaw" → 安装并启用
  2. 配置：
    • Gateway URL：ws://127.0.0.1:18789（OpenClaw 默认端口）
    • Token：从~/.openclaw/openclaw.json中复制gateway.auth.token字段值
  3. 核心功能：
    • 侧边栏聊天：无需离开 Obsidian 即可与 AI 对话
    • 基于笔记提问：选中笔记内容，右键选择 "Ask OpenClaw about this"
    • 流式回复：实时看到 AI 的思考和回复过程
    • 记忆同步：一键触发双向同步操作

五、常见问题与官方解决方案

1. 插件启用后无反应

  • 官方排查步骤：
    1. 检查插件是否真的启用：openclaw plugins list | grep memory-wiki
    2. 验证配置文件：openclaw wiki validate-config
    3. 查看网关日志：openclaw gateway logs --follow | grep memory-wiki
    4. 确保 Memory Core 已启用：openclaw plugins list | grep memory-core
  • 解决方案：重新启用插件并重启网关，确保配置文件路径正确

2. Bridge 模式显示 "0 artifacts"

  • 官方原因：可能是路径配置错误或权限问题，导致插件无法访问记忆文件
  • 解决方案：
    1. 确认 Vault 路径正确，使用绝对路径而非相对路径
    2. 检查文件权限：chmod -R 755 ~/obsidian-vaults/openclaw-memory
    3. 手动执行编译：openclaw wiki compile
    4. 重新导入：openclaw wiki bridge import --force

3. Obsidian 中看不到更新

  • 官方排查：
    1. 检查同步状态：openclaw wiki status
    2. 确认onMemoryChange配置为true
    3. 重启 Obsidian，刷新 Vault 视图
  • 解决方案：手动执行openclaw wiki bridge export强制导出

4. 矛盾检测功能不工作

  • 官方原因：可能是可信度阈值设置过高，或记忆中没有明确的矛盾信息
  • 解决方案：
    1. 降低confidence_threshold至 0.5（官方建议范围 0.5-0.8）
    2. 手动添加矛盾信息测试功能
    3. 确保contradiction_detection配置为true

六、最佳实践（官方推荐）

  1. 每日编译 + 实时触发：配置compile.frequency: daily和compile.onMemoryChange: true，兼顾性能和实时性
  2. 定期清理：每周执行openclaw wiki clean，删除过时内容，保持知识库整洁
  3. 矛盾审计：每月查看claims/contradictions.md，手动解决 AI 无法判断的矛盾信息
  4. 知识分类：在 Obsidian 中使用标签系统（如#fact、#preference、#rule）增强知识组织
  5. 备份策略：定期导出 Wiki 到独立目录，防止数据丢失

阅读量： 415

网站备案号：沪ICP备2025137870号