從零搭建三層 Agent 框架：完整部署實錄

環境

Mac Studio M3 Ultra, 512GB RAM
macOS 15 Sequoia
目標：Homebrew → Hermes Agent → OpenClaw → Claude Code，三層協同

實錄

09:00 — 系統初始化

剛拆箱的 Mac Studio，沒有裝任何開發工具。

xcode-select --install

等待約 5 分鐘完成。

09:10 — Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

注意：M3 Ultra 在 /opt/homebrew 下，安裝完成後需要手動執行 eval 命令。

09:15 — 基礎工具鏈

brew install git gh node pnpm python@3.12 ripgrep

09:30 — Node.js 與 npm 全域工具

pnpm setup
source ~/.zshrc

10:00 — 安裝 Claude Code

npm install -g @anthropic-ai/claude-code

踩坑：npm install -g 需要 sudo 或使用 pnpm。改用：

pnpm add -g @anthropic-ai/claude-code

配置 API Keys：

# ~/.claude.json
{
  "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
  "baseURL": "https://api.deepseek.com/v1",
  "model": "deepseek-chat"
}

10:30 — 安裝 OpenClaw

git clone https://github.com/openclaw/openclaw.git ~/openclaw
cd ~/openclaw
pnpm install
pnpm build

踩坑：pnpm 安裝時出現依賴衝突。解決：刪除 node_modules 和鎖文件，重新安裝。

rm -rf node_modules pnpm-lock.yaml
pnpm install

11:00 — 初始化與配置

openclaw init

配置 ~/.openclaw/openclaw.json 加入雙模型（DeepSeek + ModelStudio）。

11:30 — 安裝 Claude Code Bridge

openclaw skill install claude-code-bridge

踩坑：Bridge 技能找不到 claude 二進制路徑。

# 確認 Claude Code 安裝位置
which claude
# /Users/xxx/Library/pnpm/claude

# 在 Bridge 配置中指定絕對路徑
openclaw skill config claude-code-bridge
# 修改 binary_path

12:00 — 安裝 Hermes Agent

brew install hermes-agent
hermes init

12:30 — 飛書 Bot 配置

在飛書開放平台創建應用，配置事件訂閱。

踩坑：Webhook URL 不可達。本地開發用 ngrok 做穿透：

brew install ngrok
ngrok http 3000

將 ngrok 提供的 URL 填入飛書開放平台的事件訂閱 URL。

13:00 — Hermes ↔ OpenClaw 串接

配置雙向 API 通訊：

Hermes: integrations.openclaw.enabled: true
OpenClaw: server.port: 3001

13:30 — 端到端測試

通過飛書發送測試指令：

通過 OpenClaw 調用 Claude Code，列出當前目錄的文件。

第一次運行超時——Claude Code 冷啟動較慢。調整 timeout：

{ "claude_code": { "timeout_seconds": 600 } }

第二次成功！完整流程跑通。

14:00 — Hermes 閱讀 OpenClaw 項目

請詳細閱讀 ~/openclaw 項目的所有文件和結構

Hermes 掃描了約 300 個文件，生成項目地圖，確認可以回答項目相關問題。

踩坑總結

坑	原因	解法
npm 全域安裝需要 sudo	macOS 權限	改用 pnpm
OpenClaw 依賴衝突	鎖文件版本不一致	清理重裝
Claude Code Bridge 找不到 binary	PATH 未包含 pnpm 目錄	指定絕對路徑
飛書 Webhook 不可達	本地無公網 IP	ngrok 穿透
Claude Code 首次調用超時	冷啟動	延長 timeout

最終架構狀態

飛書 (用戶)  ←→  Hermes Agent  ←→  OpenClaw  ←→  Claude Code
                    :3000              :3001         (CLI)
                                                  ↙        ↘
                                           DeepSeek    ModelStudio
                                            API         API

三層全部運行在 Mac Studio M3 Ultra 上，記憶體使用約 8GB（不含本地模型）。

下一步

加入更多 Skills（GitHub PR Review、自動部署等）
配置 WhatsApp 頻道
為 OpenClaw 配置工作空間隔離
加入監控和告警

環境

實錄