< >
Home » OpenClaw-AI助手入门教程 » OpenClaw AI助手入门教程-OpenClaw整合Obsidian打造你的AI知识库

OpenClaw AI助手入门教程-OpenClaw整合Obsidian打造你的AI知识库

说明

  • 你是否也遇到过这样的困扰：Obsidian里攒了几千条笔记，看似有了知识库，但真正要用的时候却翻箱倒柜找不到；想写点东西，明明素材都在库里，却得手动翻遍几十个文件。信息囤积变成了新的信息焦虑。

  • 随着OpenClaw与Obsidian CLI的深度整合，这个问题终于有了完美的解法——让AI直接替你“读”懂你的知识库，帮你整理、检索、创作，把Obsidian从“被动存储的容器”变成“主动创造价值的数字员工”

为什么要整合OpenClaw和Obsidian？

  • 1.1 传统方案的痛点
过去，让AI使用知识库通常需要将笔记向量化存入专用数据库。这种方式存在三个硬伤：

数据割裂：笔记的结构（标题、标签、双向链接）在转化中丢失，AI无法理解知识间的关联 

检索不透明：用户无法验证AI到底用了哪些素材，像个“黑盒” 

维护复杂：每次修改笔记都需要重新向量化，操作繁琐
  • 1.2 Obsidian CLI的革命性突破
Obsidian 1.12版本推出的官方CLI（命令行界面）彻底改变了这一局面。它的核心价值是：让AI直接调用Obsidian原生索引，无需数据搬运 。

实测数据很惊人：4663个文件的知识库检索仅需0.26秒，比逐文件扫描快60倍，token消耗降低99% 。更重要的是，AI能理解标题、标签、反向链接等所有Obsidian原生字段，检索结果完全透明可控
  • 1.3 两者结合的完整闭环
Obsidian：负责“存储与连接”，所有笔记以Markdown格式本地化存储，通过双向链接构建知识网络 

OpenClaw：负责“自动化与智能化”，自动采集信息、智能检索、批量处理、提炼总结 

两者结合形成“采集→处理→沉淀→复用→迭代”的完整生产线闭环

部署步骤

第一步，部署openclaw

  • 参考前面的文章，我们演示是docker版本openclaw

第二步，部署Obsidian（Docker版）

  • 配置docker-compose.yaml
cat > /home/ubuntu/obsidian/docker-compose.yml << 'EOF'
version: '3'
services:
  obsidian:
    image: lscr.io/linuxserver/obsidian:latest
    container_name: obsidian
    security_opt:
      - seccomp:unconfined    # 可选，用于兼容性
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - PIXELFLUX_WAYLAND=false
      - CUSTOM_USER=admin      # 建议修改
      - PASSWORD=your_password # 建议修改为强密码
      - LC_ALL=zh_CN.UTF-8
    volumes:
      - /home/ubuntu/.openclaw/obsidian/config:/config
      - /home/ubuntu/.openclaw/obsidian/config/obsidian-vault:/config/obsidian-vault
    ports:
      - "127.0.0.1:3001:3001"  # 只绑定本地，通过Nginx代理
    shm_size: "1gb"
    restart: unless-stopped
EOF

#启动Obsidian容器
cd /home/ubuntu/obsidian
docker-compose up -d
  • 配置Nginx反向代理（实现HTTPS安全访问）
sudo apt install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx
  • 配置域名
sudo tee /etc/nginx/sites-available/obsidian << 'EOF'
server {
    listen 80;
    server_name obsidian.yourdomain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name obsidian.yourdomain.com;

    # 如无证书，可先用自签名或注释掉SSL相关行，使用HTTP访问（不推荐公网使用）
    # ssl_certificate     /path/to/your/fullchain.pem;
    # ssl_certificate_key /path/to/your/privkey.pem;

    location / {
        proxy_pass https://127.0.0.1:3001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $http_connection;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_ssl_verify off;  # 忽略容器自签名证书错误
    }

    client_max_body_size 100M;
}
EOF

#启用配置并测试：
sudo ln -s /etc/nginx/sites-available/obsidian /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
  • 访问obsidian
https://obsidian.yourdomain.com

打通OpenClaw与Obsidian

  • 1.配置Obsidian CLI（关键步骤）
    进入Obsidian容器，启用CLI功能：
docker exec -it obsidian bash

# 在容器内安装Obsidian CLI工具（需根据实际版本调整）
# 通常最新版Obsidian已内置CLI，可直接使用以下命令验证
obsidian --version
# 如无此命令，需安装：proot-apps install obsidian-cli

2.安装Obsidian协同技能

# 进入OpenClaw容器（如使用npm安装则直接执行）
cd /home/ubuntu/.openclaw/skills

# 安装核心技能
clawhub install obsidian-sync obsidian-parser markdown-formatter
  1. 配置Obsidian目录结构与同步规则
cd /home/ubuntu/.openclaw/obsidian/config/obsidian-vault

mkdir -p {8_收件箱,1_日记,20_项目,30_研究,40_知识库,50_资源,90_计划,99_系统}
  1. 配置OpenClaw同步规则：
openclaw config set obsidian.vaultPath "/home/ubuntu/.openclaw/obsidian/config/obsidian-vault" --json

openclaw config set obsidian.syncRules '{
  "inbox": "/home/ubuntu/.openclaw/obsidian/config/obsidian-vault/8_收件箱",
  "daily": "/home/ubuntu/.openclaw/obsidian/config/obsidian-vault/1_日记",
  "projects": "/home/ubuntu/.openclaw/obsidian/config/obsidian-vault/20_项目",
  "research": "/home/ubuntu/.openclaw/obsidian/config/obsidian-vault/30_研究",
  "knowledge": "/home/ubuntu/.openclaw/obsidian/config/obsidian-vault/40_知识库"
}' --json
  1. 配置Frontmatter自动生成规则（可选）
openclaw config set obsidian.frontmatter '{
  "note": {
    "type": "note",
    "status": "processed",
    "createdAt": "{{date:YYYY-MM-DD HH:mm:ss}}"
  },
  "project": {
    "type": "project",
    "status": "active",
    "areas": "[[未分类]]",
    "createdAt": "{{date:YYYY-MM-DD HH:mm:ss}}"
  }
}' --json
  1. 重启openclaw

自动化实战验证

测试场景1：网页内容自动收录

  • 在OpenClaw Web控制台中输入：
帮我收藏这篇文章：https://example.com/ai-trends-2026
解析并存入Obsidian收件箱，添加标签 #AI #趋势
  • OpenClaw会自动抓取网页、提炼核心内容、转换为Markdown格式，存入 /8_收件箱，并自动添加Frontmatter元数据

测试场景2：基于知识库的创作

  • 假设你积累了多篇项目笔记，想写一篇总结报告：
基于我20_项目目录下的所有笔记，帮我写一份Q2项目总结报告
重点突出技术难点和突破，格式参考99_系统/模板/报告模板.md
  • OpenClaw会通过Obsidian CLI毫秒级检索相关笔记，理解笔记间的链接关系，生成符合你风格的内容

测试场景3：每日早报自动生成

  • 设置定时任务（在OpenClaw Web控制台的Cron Jobs中添加）
#设定cron
0 8 * * *  # 每天早上8点执行

#执行任务
搜索过去24小时的热点新闻，提炼3条核心内容
以今日早报为标题存入1_日记/YYYY-MM-DD.md

常见问题与避坑指南

  • 1 Obsidian容器无法访问
现象：浏览器打不开 https://域名:3001

解决：检查防火墙端口是否放行；确认Nginx配置正确；查看容器日志 docker logs obsidian
    1. OpenClaw无法连接Obsidian知识库
现象：OpenClaw提示找不到笔记目录

解决：检查 obsidian.vaultPath 配置是否指向正确的宿主机路径；确认目录权限（PUID=1000 需与目录所有者一致）
    1. Obsidian CLI命令找不到
现象：在容器内执行 obsidian 提示命令未找到

解决：Obsidian 1.12+ 已内置CLI，路径通常为 /opt/obsidian/obsidian；可使用 proot-apps install obsidian-cli 安装
    1. 百炼API调用失败
现象：OpenClaw返回“模型服务错误”

解决：检查API Key是否过期；确认已开通百炼服务并领取免费额度；在阿里云控制台设置消费限额（推荐0元）避免意外扣费
    1. 端口冲突
现象：启动服务时提示端口被占用

解决：修改 docker-compose.yml 中的映射端口，或在OpenClaw启动时指定 --port 参数

总结

  • 至此，你已经完成了OpenClaw + Obsidian的完整部署，拥有了一个24小时在线、自动采集、智能检索、辅助创作的AI知识库

纠错,疑问,交流: 请进入讨论区或 点击加入Q群

获取最新文章: 扫一扫右上角的二维码加入“创客智造”公众号


标签: openclaw ai助手入门教程