OpenClaw、Hermes、Obsidian 本地 AI 工作台搭建教程

这两天我把自己电脑上的几个 AI 工具重新整理了一遍，最后保留下来的组合是 OpenClaw、Hermes 和 Obsidian。

单独看它们，每个工具都不复杂。但真正有用的地方，是把它们放在一个工作流里面：OpenClaw 负责图形界面和控制台，Hermes 负责终端里的 Agent 执行，Obsidian 负责把配置、教程、踩坑记录长期沉淀下来。

这篇就把安装、配置、验证、踩坑修复记录一次写完整。后面如果你也想在本地搭一套 AI 工作台，可以直接照着检查。

内容隐藏

最终搭好的效果

工具	当前状态	主要入口
OpenClaw	已安装，已配置 DeepSeek，Gateway 已运行	`openclaw dashboard`
Hermes Agent	已安装，已配置 DeepSeek，TUI 可进入	`hermes --tui`
Obsidian	已安装，作为长期知识库使用	本地 Obsidian vault

这套组合我的理解很简单：

OpenClaw 适合做“看得见的控制台”。
Hermes 适合做“终端里的执行 Agent”。
Obsidian 适合做“长期知识仓库”。

很多人用 AI 工具用着用着就散了，今天一个网页，明天一个插件，后天又换一个客户端。最后真正留下来的东西不多。我的做法是尽量把入口固定下来，能执行的放到 Agent，能复盘的放到笔记。

一、先安装工具

Mac 上先确认 Homebrew 可用：

which brew

安装 OpenClaw 和 Obsidian 图形应用：

brew install --cask openclaw obsidian

安装 OpenClaw CLI 和 Hermes Agent：

brew install hermes-agent openclaw-cli

检查版本：

openclaw --version
hermes --version
obsidian --version

这里有个小坑：Homebrew 里面还有一个叫 hermes 的旧播放器，不是我们要用的 AI Agent。这里安装的是 hermes-agent，装完以后命令入口仍然是 hermes / hermes-agent。

二、配置 OpenClaw 模型

OpenClaw 我这里接的是 DeepSeek，默认模型用的是 deepseek/deepseek-v4-flash。

openclaw models auth login --provider deepseek --method api-key --set-default

按提示粘贴自己的 DeepSeek API Key。

设置默认模型：

openclaw models set deepseek/deepseek-v4-flash

可选模型大概有这些：

deepseek/deepseek-v4-flash
deepseek/deepseek-v4-pro
deepseek/deepseek-chat
deepseek/deepseek-reasoner

日常用我建议先选 deepseek-v4-flash，速度和成本比较舒服。真遇到需要推理的任务，再换更重的模型。

检查模型状态：

openclaw models status
openclaw models list

最后实际跑一次：

openclaw infer model run --local --prompt "只回复 OK" --model deepseek/deepseek-v4-flash

如果返回 OK，说明模型和 key 都通了。

三、打开 OpenClaw 控制台

OpenClaw 的网页控制台依赖 Gateway。第一次打开时可以让它自动安装和启动：

openclaw dashboard --yes

以后日常打开：

openclaw dashboard

默认地址：

http://127.0.0.1:18789/

检查 Gateway 状态：

openclaw gateway status

如果看到类似：

Service: LaunchAgent (loaded)
Runtime: running
Listening: 127.0.0.1:18789

说明它已经在本机后台正常运行了。

有时候浏览器会提示“需要设备配对”，这个是正常的安全机制。页面会显示一个 request id，终端里这样处理：

openclaw devices list
openclaw devices approve <页面显示的 request id>

批准后回网页点连接就行。如果换浏览器、清缓存、开隐身窗口，可能会再次出现配对提示，重复上面两条命令即可。

四、配置 Hermes

Hermes 我这里同样配置为 DeepSeek：

Provider: DeepSeek
Model   : deepseek-v4-flash

重新配置入口：

hermes setup

或者只配置模型：

hermes model

检查状态：

hermes status

最小测试：

hermes -z "只回复 OK"

成功返回 OK 就可以继续。

五、Hermes 的两个入口

Hermes 有两个界面：

入口	命令	适合场景
TUI	`hermes --tui`	日常聊天、看工具调用、终端里操作
Dashboard	`hermes dashboard --tui`	查看配置、会话、日志，不建议当主力聊天界面

我自己日常更推荐：

hermes --tui

Dashboard 地址：

http://127.0.0.1:9119/

停止 Dashboard：

hermes dashboard --stop

六、这次遇到的几个坑

这次安装最花时间的地方不是配置模型，而是 Homebrew 版 Hermes 包里少了一些东西。

第一个坑是 hermes chat -q 报 pyexpat 动态库错误。大概意思是 Python 的 pyexpat 链到了系统 expat，但它需要的符号在 Homebrew expat 里。

修复思路是把 pyexpat 指向 Homebrew expat，然后重新签名：

install_name_tool -change /usr/lib/libexpat.1.dylib /opt/homebrew/opt/expat/lib/libexpat.1.dylib /opt/homebrew/Cellar/[email protected]/3.14.5/Frameworks/Python.framework/Versions/3.14/lib/python3.14/lib-dynload/pyexpat.cpython-314-darwin.so

codesign --force --sign - /opt/homebrew/Cellar/[email protected]/3.14.5/Frameworks/Python.framework/Versions/3.14/lib/python3.14/lib-dynload/pyexpat.cpython-314-darwin.so

验证：

/opt/homebrew/opt/[email protected]/bin/python3.14 -c "from xml.dom import minidom; import pyexpat; print('pyexpat ok')"

第二个坑是 Hermes Dashboard 只显示：

{"error":"Frontend not built. Run: cd web && npm run build"}

原因是 Homebrew 安装包没有带 Dashboard 前端构建产物。处理方式是下载 Hermes 对应版本源码，进入 web/ 执行 npm install 和 npm run build，再把生成的 hermes_cli/web_dist/ 复制到 Homebrew Hermes 的运行目录。

第三个坑是 hermes --tui 进不去，提示找不到 site-packages/ui-tui。这个也是包里漏了目录。处理方式是从 Hermes 对应版本源码复制 ui-tui/ 到 Homebrew Hermes 的 Python site-packages 目录。

这些问题不一定每个人都会遇到，但如果你也是 Homebrew 安装，遇到类似报错，可以优先往“包缺文件、动态库指向不对”这两个方向排查。

七、Obsidian 负责长期沉淀

工具装好只是第一步，真正能省时间的是把配置和踩坑记录下来。

我这边建议这样放：

03-素材摘录/
  工具教程/
    OpenClaw-Hermes-Obsidian本地安装配置教程.md

99-附件/
  images/
    ai-tools-local-workstation/
      ai-tools-overview.svg
      openclaw-flow.svg
      hermes-fixes.svg
      daily-commands.svg

02-主题索引/
  工具方法.md

为什么不直接丢到“公众号文章”里面？因为这类内容首先是一篇可反复查的操作手册，不是一次性发布完就结束的文章。以后版本更新、命令变动、报错修复，都可以继续补在这篇笔记里。

八、日常命令速查

OpenClaw：

openclaw dashboard
openclaw gateway status
openclaw models status
openclaw infer model run --local --prompt "只回复 OK"

Hermes：

hermes --tui
hermes status
hermes -z "只回复 OK"
hermes dashboard --tui
hermes dashboard --stop

Obsidian：

open -a Obsidian

最后说一下

这套东西不是为了“装软件而装软件”，而是为了把 AI 工具变成一个长期可用的工作台。

OpenClaw 管入口，Hermes 管执行，Obsidian 管沉淀。只要这三个角色分清楚，后面不管是写文章、整理资料、维护网站，还是做自动化任务，都能少很多重复劳动。

好了，今天就先写到这里。祝大家工具越用越顺，项目越做越稳，多收款，多做海外项目。