Hermes Agent 安裝與飛書 Lark 集成配置

Hermes Agent 是什麼？

Hermes Agent 是一個多渠道 AI 通訊 Agent，支援飛書/Lark、WhatsApp、微信、Telegram 等平台。在三層框架中，它擔任一層通訊層。

🔗 Hermes Agent GitHub

步驟 1：安裝 Hermes Agent

# 通過 Homebrew（推薦）
brew install hermes-agent

# 或通過 npm
npm install -g hermes-agent

驗證安裝：

hermes --version

步驟 2：初始化配置

hermes init

這會在 ~/.hermes/ 下創建配置目錄：

~/.hermes/
├── config.yaml          # 主配置
├── auth.json            # 認證信息
├── profiles/            # 多身份配置
├── skills/              # 自訂技能
└── sessions/            # 對話記錄

步驟 3：配置飛書 Lark Bot

3.1 在飛書開放平台創建應用

打開飛書開放平台
創建企業自建應用
獲取 App ID 和 App Secret
在「權限管理」中添加所需權限：
- im:message — 收發消息
- im:message.p2p_msg:readonly — 讀取私聊
- im:chat:readonly — 讀取群聊信息
- contact:user.id:readonly — 讀取用戶信息

3.2 配置事件訂閱

在飛書開放平台 → 事件訂閱：

請求地址：https://your-server.com/hermes/webhook
訂閱事件：
- im.message.receive_v1 — 接收消息
- im.message.reaction.created_v1 — 表情反應

3.3 配置 Hermes 的飛書頻道

編輯 ~/.hermes/config.yaml：

channels:
  lark:
    enabled: true
    app_id: "cli_xxxxxxxxxxxx"
    app_secret: "xxxxxxxxxxxxxxxxxxxxxxxxxx"
    verification_token: "xxxxxxxxxxxx"
    encrypt_key: "xxxxxxxxxxxx"  # 可選
    bot_name: "君澤智庫 Agent"

步驟 4：啟動 Hermes Agent

# 前台運行（開發模式）
hermes serve --channel lark

# 後台運行
hermes serve --channel lark --daemon

# 同時啟用多個渠道
hermes serve --channel lark,whatsapp,wechat

啟動成功後，在飛書中找到你的 Bot，發送 /ping 測試：

你：/ping
Bot：pong! Hermes Agent v1.x.x, channels: lark

步驟 5：讓 Hermes 閱讀 OpenClaw 項目

這是關鍵步驟——讓 Hermes Agent 理解 OpenClaw 的項目結構，以便後續擔任維運角色。

5.1 配置項目路徑

在 ~/.hermes/config.yaml 中：

projects:
  openclaw:
    path: "/path/to/OpenClaw"
    description: "OpenClaw 主項目 — AI Agent 編排框架"
    watch: true  # 監聽文件變更

5.2 觸發 Hermes 閱讀項目

在飛書中發送：

請詳細閱讀 OpenClaw 項目的所有文件和結構，我需要你理解這個項目以便後續的維護工作。

Hermes Agent 會：

遞歸掃描 OpenClaw 目錄
讀取關鍵文件（README、配置文件、源碼結構）
建立項目地圖並存入記憶
回復確認：「已閱讀 OpenClaw 項目，共 X 個文件，Y 個目錄。我已理解項目的核心架構。」

5.3 驗證

發送測試問題：

OpenClaw 的配置入口文件是什麼？
OpenClaw 如何管理 Skills？

Hermes 應能準確回答，表示已成功「理解」項目。

步驟 6：設置日常通訊

快捷指令

在 Hermes 中配置常用快捷指令：

shortcuts:
  status:
    command: "hermes status"
    description: "查看 Agent 狀態"
  projects:
    command: "hermes project list"
    description: "列出已知項目"
  memory:
    command: "hermes memory search"
    description: "搜索記憶"

定時匯報

配置 Hermes 定時在飛書群組中發送狀態匯報：

cron:
  - schedule: "0 9 * * *"
    channel: "lark"
    chat_id: "oc_xxxxxxxxxxxx"
    message: "早安！今日 Agent 狀態正常。昨日處理了 X 個任務。"

疑難排解

| 問題 | 解決方案 | |------|---------| | Bot 不回覆消息 | 檢查飛書開放平台的事件訂閱 URL 是否可達 | | 權限不足 | 確認應用已獲得 im:message 等必要權限 | | Hermes 無法讀取 OpenClaw | 檢查 projects.openclaw.path 路徑是否正確 | | 飛書 Webhook 超時 | 確認伺服器防火牆允許飛書 IP 範圍 |