從零搭建三層 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 配置工作空間隔離
加入監控和告警

環境

實錄