阿里云/本地零基础喂饭级部署 Hermes Agent / OpenClaw +配置免费大模型API+集成Obsidian CLI，让AI用你的知识库创作

2026年，个人知识库的价值已从“个人备忘”升级为“AI创作资产”——Obsidian凭借本地Markdown存储、双向链接、标签体系，成为知识管理的首选工具，但长期以来存在一个核心痛点：AI Agent（如OpenClaw）无法高效复用这些精心整理的知识。传统方案需将笔记向量化存入向量数据库，不仅丢失笔记结构与关系，还存在检索不透明、维护复杂等问题。

而Obsidian 1.12版本推出的官方CLI（命令行界面），彻底打通这一断点：AI Agent无需搬运数据，可直接调用Obsidian原生索引，实现毫秒级检索、反向链接查询、标签筛选等功能，4663个文件的知识库检索仅需0.26秒，比逐文件扫描快60倍，token消耗降低99%。本文基于实测经验，整合四大核心内容：一是2026年OpenClaw全平台部署流程（阿里云+MacOS+Linux+Windows11）；二是阿里云百炼免费大模型API配置步骤；三是Obsidian CLI启用与OpenClaw联动实战；四是新手高频问题解答，所有代码可直接复制执行，助力零基础用户1-2小时内实现“个人知识库+AI Agent”的全链路打通，让积累的每一篇笔记都成为AI创作的核心素材。阿里云部署 OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。









👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

一、核心认知：Obsidian CLI+OpenClaw的联动价值

（一）传统知识库AI复用方案的痛点

此前，OpenClaw等AI Agent复用Obsidian知识库主要依赖向量数据库（如Qdrant、Pinecone），存在三大核心问题：

1. 数据割裂：笔记需导出向量化，原文的标题层级、标签关系、双向链接在转化中丢失，AI无法理解知识结构；
2. 检索不透明：向量数据库存储的是机器可识别的向量数据，用户无法验证AI检索的准确性，也不知道遗漏了哪些素材；
3. 维护复杂：笔记修改后需重新向量化入库，高频更新场景下操作繁琐，且占用额外存储资源。

（二）Obsidian CLI的核心优势

Obsidian CLI的本质是“让AI直接调用Obsidian原生索引”，彻底解决传统方案的痛点：

1. 零数据搬运：笔记仍以Markdown格式存储在本地，AI通过CLI查询Obsidian已建好的索引（与用户手动搜索使用同一引擎），无需导出或转化；
2. 全结构保留：支持检索标题、标签、双向链接、属性、创建时间等所有Obsidian原生字段，AI能理解知识间的关联关系；
3. 高效低耗：检索速度比逐文件扫描快60倍以上，token消耗降低99%，4663个文件检索仅需100个token；
4. 透明可控：用户可通过Obsidian手动验证AI的检索结果，明确知道AI使用了哪些素材，避免“黑盒检索”。

（三）联动逻辑与适用场景

1. 联动架构

OpenClaw与Obsidian CLI的联动核心是“Skill调用+索引查询”：

1. OpenClaw安装Obsidian CLI专属Skill，获得调用Obsidian命令的权限；
2. 用户发起创作、分析等需求时，OpenClaw通过CLI查询Obsidian索引，获取相关笔记素材；
3. 结合阿里云百炼大模型的理解与生成能力，将知识库素材与需求结合，产出个性化内容。

2. 适用场景

• 内容创作：写文章、报告时，AI自动从Obsidian检索相关笔记，融入个人积累与风格；
• 知识梳理：让AI分析笔记间的关联，生成知识图谱或总结报告；
• 任务规划：基于Obsidian中的项目笔记，AI自动拆解任务、制定执行计划；
• 快速查询：通过自然语言向AI提问，由AI检索知识库并返回精准答案。

（四）前置准备（必做，避免部署中断）

1. 账号与凭证准备

• 阿里云账号：注册阿里云账号 并完成实名认证，用于云服务器购买与百炼API开通；
• 阿里云百炼API密钥：访问登录阿里云百炼大模型服务平台，开通服务后创建Access Key ID和Access Key Secret（保存至加密记事本）；
• 辅助工具：Chrome/Edge浏览器、SSH终端（FinalShell，阿里云部署用）、VS Code（文本编辑）、加密记事本（存储敏感凭证）。

2. 设备与环境要求

• 云端部署：阿里云服务器（推荐Ubuntu 22.04 LTS，2vCPU+4GiB内存+40GiB ESSD）；
• 本地部署：Windows11/10、MacOS 12+、Linux（Ubuntu 22.04+），建议内存≥4GB、可用空间≥10GB（含Obsidian知识库存储）；
• 核心依赖：Node.js≥v22.0.0、Python≥3.9（OpenClaw运行依赖）、Git（Skill安装依赖）、Obsidian 1.12+（支持CLI功能）；
• 网络要求：阿里云服务器优先选择中国香港地域（免备案），本地设备确保网络通畅，可正常下载依赖与API调用。

二、2026年OpenClaw全平台部署流程（零基础友好）

（一）阿里云部署（长期运行首选）

适合需要7×24小时运行、多设备访问的场景，依托云服务器稳定性，支持Obsidian知识库远程联动，新手30分钟可完成。

新手零基础阿里云上部署OpenClaw喂饭级步骤流程

第一步：打开访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

第二步：打开选购阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

1. 服务器选购与基础配置

1. 服务器选购：

   • 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
   • 核心配置：2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽，地域选择中国香港（免备案），付费类型选“包年包月”；
   • 提交订单后，等待实例状态变为“运行中”，记录公网IP、登录账号（默认root）与密码。

2. 端口放行与环境准备：

# 1. SSH登录服务器（替换为你的公网IP）
ssh root@你的服务器公网IP

# 2. 一键放行核心端口
sudo apt install ufw -y
sudo ufw allow 22/tcp  # SSH连接端口
sudo ufw allow 18789/tcp  # OpenClaw核心端口
sudo ufw allow 443/tcp  # API调用端口
sudo ufw enable
sudo ufw status  # 显示“ALLOW”即为成功

# 3. 更新系统依赖并安装核心工具
sudo apt update && sudo apt upgrade -y
sudo apt install curl git python3-pip -y

# 4. 安装Node.js 22+（稳定版）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 5. 配置npm国内镜像，加速安装
npm config set registry https://registry.npmmirror.com

# 6. 安装Obsidian（阿里云部署需通过Flatpak安装）
sudo apt install flatpak -y
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub md.obsidian.Obsidian -y

2. OpenClaw安装与初始化

# 1. 一键安装OpenClaw（官方脚本，自动适配环境）
curl -fsSL https://openclaw.ai/install.sh | bash

# 2. 运行配置向导（核心步骤，按提示操作）
openclaw onboard

# 交互配置步骤（新手直接按以下提示选择）
# 1. 接受风险提示：输入Yes
# 2. 选择模型提供商：暂时选择“Custom Provider”（后续配置百炼API）
# 3. 网关绑定：选择lan（监听所有网络接口，支持多设备访问）
# 4. 频道配置：输入Skip（后续按需添加）
# 5. 技能配置：输入Skip（后续安装Obsidian CLI Skill）
# 6. 钩子（Hooks）：输入Skip
# 7. 孵化方式：选择Open the Web UI（启动Web控制台）

# 3. 启动网关服务
openclaw gateway start

# 4. 生成访问令牌（登录控制台需用，复制保存）
openclaw config get gateway.auth.token

3. 部署验证

• 浏览器输入 http://服务器公网IP:18789，粘贴访问令牌，能正常进入Web控制台即为部署成功；
• 命令行验证：openclaw gateway status，显示“running”即为服务正常。

（二）本地部署（Windows11+MacOS+Linux）

1. Windows11部署（办公场景适配）

系统要求：Windows11/10 64位、4GB+内存（推荐8GB+）、10GB+可用空间

# 1. 以管理员身份打开PowerShell（右键开始菜单选择）
# 2. 解决执行策略限制（避免脚本无法运行）
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

# 3. 安装核心依赖（Node.js 22+、Python 3.9、Git）
winget install OpenJS.NodeJS.LTS --version 22.2.0
winget install Python.Python.3.9
winget install Git.Git

# 4. 配置npm国内镜像，加速安装
npm config set registry https://registry.npmmirror.com

# 5. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 6. 运行配置向导
openclaw onboard

# 交互步骤（参考阿里云部署的选择）
# 1. 接受风险提示：输入Yes
# 2. 模型提供商：选择Custom Provider
# 3. 网关绑定：选择lan
# 4. 其余步骤：均输入Skip

# 7. 启动网关服务
openclaw gateway start

# 8. 获取访问令牌
openclaw config get gateway.auth.token

关键配置（必做）：

• 将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表，避免被误判为病毒；
• 下载安装Obsidian 1.12+版本（官网下载，无需额外配置）；
• 访问方式：浏览器输入 http://localhost:18789，粘贴令牌即可登录。

2. MacOS部署（体验最佳，推荐）

系统要求：MacOS 12+（M系列/Intel芯片）、8GB+内存、10GB+可用空间

# 1. 打开终端（Cmd + Space输入“Terminal”）
# 2. 安装Homebrew（国内用户用镜像加速）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 3. 安装核心依赖（Node.js 22、Python 3.9、Git）
brew install node@22 python@3.9 git

# 4. 配置Node.js环境变量（确保全局可调用）
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 5. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 6. 运行配置向导
openclaw onboard

# 交互步骤（参考阿里云部署）
# 1. 接受风险提示：输入Yes
# 2. 模型提供商：选择Custom Provider
# 3. 网关绑定：选择lan
# 4. 其余步骤：均输入Skip

# 7. 启动网关服务（后台运行）
nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &

# 8. 获取访问令牌
openclaw config get gateway.auth.token

# 9. 安装Obsidian（通过Homebrew）
brew install --cask obsidian

M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖；

• 访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录。

3. Linux部署（Ubuntu 22.04 LTS，稳定性强）

系统要求：Ubuntu 22.04 LTS、4GB+内存、10GB+可用空间

# 1. 更新系统依赖
sudo apt update && sudo apt upgrade -y

# 2. 安装核心工具
sudo apt install curl git python3-pip -y

# 3. 安装Node.js 22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 4. 配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 5. 一键安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 6. 运行配置向导
openclaw onboard

# 交互步骤（参考阿里云部署）
# 1. 接受风险提示：输入Yes
# 2. 模型提供商：选择Custom Provider
# 3. 网关绑定：选择lan
# 4. 其余步骤：均输入Skip

# 7. 启动网关服务并设置开机自启
sudo systemctl enable --now openclaw
openclaw gateway start

# 8. 获取访问令牌
openclaw config get gateway.auth.token

# 9. 安装Obsidian
sudo apt install flatpak -y
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install flathub md.obsidian.Obsidian -y

访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录。

三、阿里云百炼免费API配置（核心步骤，零成本解锁智能）

（一）API密钥获取步骤

1. 登录阿里云官网，访问登录阿里云百炼大模型服务平台；
2. 点击“开通服务”，阅读并同意服务协议，新用户自动领取90天免费额度（可在“费用管理”中查看）；
3. 进入“密钥管理”页面，点击“创建Access Key”，完成身份验证（短信/扫码）后，生成Access Key ID和Access Key Secret；
4. 复制并保存密钥（仅创建时可完整查看Access Key Secret，丢失需重新创建）；
5. 开启“消费限额”（推荐）：进入“费用管理”→“消费限额”，设置每月最大消费额度，避免超额计费。

（二）OpenClaw对接阿里云百炼API（全环境通用）

# 1. 配置百炼API密钥（替换为你的凭证）
openclaw config set models.providers.bailian.accessKeyId "你的Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的Access Key Secret"

# 2. 配置国内接口地址（降低延迟）
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"

# 3. 设置默认模型（推荐qwen3.5，免费额度足够使用）
openclaw config set models.default "qwen3.5"

# 4. 配置超时时间与知识库协同优化参数
openclaw config set models.providers.bailian.timeout 60000
openclaw config set models.providers.bailian.knowledgeCooperation true

# 5. 重启网关生效（不同环境重启命令）
# 阿里云/Linux
openclaw gateway restart

# MacOS
pkill -f openclaw && nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &

# Windows11（PowerShell）
openclaw gateway stop
openclaw gateway start

（三）API配置验证与避坑要点

1. 验证方法：登录OpenClaw Web控制台，输入测试指令：帮我生成一份2026年Q2工作规划，返回结构化回复即为配置成功；
2. 避坑要点：
   • 密钥复制错误→逐字符核对，避免多余空格或换行，区分Access Key ID与Secret；
   • 接口地址错误→国内部署必须使用指定地址，否则调用超时；
   • 免费额度耗尽→登录百炼控制台查看，及时切换基础模型；
   • 服务未重启→配置后必须重启网关，否则配置不生效。

四、Obsidian CLI启用与OpenClaw联动实战

（一）步骤1：启用Obsidian CLI（全系统通用）

Obsidian CLI需手动启用，步骤简单，仅需开启设置并配置环境变量：

1. 启用CLI功能

1. 打开Obsidian，进入“设置”→“第三方插件”，开启“命令行界面”开关；
2. 记录Obsidian知识库路径（如Windows：C:\Users\你的用户名\Obsidian\MyVault，MacOS：~/Obsidian/MyVault，Linux：~/Obsidian/MyVault），后续配置需用。

2. 配置环境变量（确保全局可调用）

• Windows11：

# 1. 以管理员身份打开PowerShell
# 2. 添加Obsidian CLI到环境变量（替换为你的Obsidian安装路径）
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\Obsidian", "Machine")
# 3. 验证配置（重启PowerShell后执行）
obsidian --version

• MacOS/Linux：

# 1. 编辑环境变量配置文件
nano ~/.zshrc  # MacOS
# 或
nano ~/.bashrc  # Linux

# 2. 添加以下内容（替换为你的Obsidian安装路径）
export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"  # MacOS
# 或
export PATH="$PATH:/var/lib/flatpak/app/md.obsidian.Obsidian/current/active/files/bin"  # Linux

# 3. 生效配置
source ~/.zshrc  # MacOS
# 或
source ~/.bashrc  # Linux

# 4. 验证配置
obsidian --version

显示Obsidian版本号（1.12+）即为配置成功。

（二）步骤2：安装OpenClaw Obsidian CLI Skill

# 1. 安装Obsidian CLI专属Skill（全环境通用）
clawhub install obsidian-cli-skill

# 2. 配置知识库路径（替换为你的Obsidian知识库路径）
openclaw config set skills.obsidian-cli-skill.vaultPath "你的Obsidian知识库路径"

# 3. 配置检索参数（可选，优化检索效果）
openclaw config set skills.obsidian-cli-skill.searchDepth "full"  # 全量检索
openclaw config set skills.obsidian-cli-skill.maxResults 20  # 最大返回20条结果
openclaw config set skills.obsidian-cli-skill.includeTags true  # 包含标签筛选

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

（三）步骤3：联动实战（让AI用知识库创作）

1. 基础检索测试

登录OpenClaw Web控制台，输入指令：帮我检索Obsidian中标签为“AI工具”的笔记，汇总核心观点，OpenClaw会通过CLI查询Obsidian索引，返回结构化的笔记摘要。

2. 内容创作实战

输入指令：基于我Obsidian中“OpenClaw部署”相关的笔记，写一篇零基础部署教程，要求分步骤、包含代码命令，AI会：

1. 通过CLI检索所有标题或内容包含“OpenClaw部署”的笔记；
2. 提取笔记中的部署步骤、代码命令、避坑要点；
3. 按教程格式重新组织内容，融入个人积累的实战经验，生成个性化教程。

3. 反向链接分析

输入指令：分析Obsidian中“AI Agent”笔记的所有反向链接，梳理知识关联关系，生成思维导图大纲，AI会调用Obsidian CLI的反向链接查询功能，理解知识结构并生成可视化大纲。

（四）常用Obsidian CLI命令参考（OpenClaw自动调用，用户可手动验证）

五、新手高频问题解答

（一）部署类问题

1. 问题1：OpenClaw启动提示“Node.js版本过低”？

   • 解决方案：执行node --version验证版本，确保≥22.0.0；Windows重新运行Node.js安装命令，Linux/MacOS执行sudo npm install -g n && sudo n 22.0.0升级。

2. 问题2：Mac M系列芯片安装Obsidian后，CLI无法调用？

   • 原因：Obsidian安装路径未添加到环境变量；
   • 解决方案：执行export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"，并将该命令添加到~/.zshrc，确保永久生效。

3. 问题3：阿里云部署后，Obsidian无法启动？

   • 原因：Flatpak安装权限不足；
   • 解决方案：执行sudo flatpak update md.obsidian.Obsidian，更新Obsidian后重新启动。

（二）联动类问题

1. 问题1：OpenClaw提示“无法找到Obsidian CLI”？

   • 解决方案：① 验证Obsidian CLI是否启用（设置→第三方插件→命令行界面）；② 检查环境变量配置是否正确，重启终端后执行obsidian --version验证；③ 重新安装Obsidian CLI Skill（clawhub install --force obsidian-cli-skill）。

2. 问题2：AI检索不到Obsidian中的笔记？

   • 解决方案：① 核对知识库路径是否正确（openclaw config get skills.obsidian-cli-skill.vaultPath）；② 确保笔记已被Obsidian索引（在Obsidian中手动搜索关键词，确认能找到）；③ 执行obsidian index rebuild --vault "知识库路径"，重建Obsidian索引后重试。

3. 问题3：检索结果不完整，遗漏相关笔记？

   • 解决方案：① 调整检索深度（openclaw config set skills.obsidian-cli-skill.searchDepth "full"）；② 增加最大返回结果数（openclaw config set skills.obsidian-cli-skill.maxResults 30）；③ 优化检索关键词，使用更精准的术语。

（三）API类问题

1. 问题1：阿里云百炼API调用提示“密钥无效”？

   • 解决方案：逐字符核对Access Key ID与Secret，删除多余空格；登录百炼控制台，确认密钥未过期、未被禁用，若丢失，重新创建密钥。

2. 问题2：API调用提示“超时”？

   • 解决方案：① 核对接口地址是否为国内节点；② 检查网络是否通畅，阿里云服务器选择中国香港地域；③ 增加超时时间（openclaw config set models.providers.bailian.timeout 120000）。

六、总结

Obsidian CLI与OpenClaw的联动，彻底解决了个人知识库AI复用的核心痛点——无需数据搬运、保留知识结构、检索高效透明，让积累的每一篇笔记都能成为AI创作的核心资产。本文通过全平台部署流程、免费API配置、Obsidian CLI联动实战，助力零基础用户快速打通“知识积累→AI复用”的全链路。

核心要点总结：

1. 部署选择：阿里云适合长期运行、多设备访问，本地部署适合隐私敏感场景，MacOS/Linux兼容性更佳；
2. API配置：阿里云百炼免费额度充足，核心是正确填写密钥与接口地址，重启网关生效；
3. 联动关键：启用Obsidian CLI并配置环境变量，安装专属Skill并核对知识库路径，AI即可通过原生索引检索笔记；
4. 避坑核心：确保Obsidian版本≥1.12，环境变量配置正确，知识库路径无中文或特殊字符，检索前重建索引（必要时）。

通过本文的流程与技巧，你可让OpenClaw从“通用AI工具”进化为“懂你的个性化助手”，无论是内容创作、知识梳理还是任务规划，都能融入个人积累的知识与风格，真正发挥AI与个人知识库的协同价值。