WorkBuddy+Hermes+飞书 CLI 三层架构搭建避坑指南

第一部分：你自己先做的准备

这部分不需要 WorkBuddy，你自己操作就行。做好后再进入第二部分。

安装 WorkBuddy — 从官网下载安装，打开注册登录
安装飞书客户端 — 从 feishu.cn 下载电脑版客户端并登录（不是网页版！）
注册 DeepSeek — 打开 platform.deepseek.com 注册，进入「API Keys」页面，点「创建 API Key」，复制保存（格式：sk-xxxxxx）

打开浏览器，访问 open.feishu.cn，按以下步骤操作：

注意：App Secret 要从「凭证与基础信息」页面准确复制，差一个字符就连不上。建议直接复制粘贴，不要手打。

把下面这段完整复制，粘贴到 WorkBuddy 对话框发送。把方括号里的内容换成你自己的。

请帮我安装和配置 Hermes，并打通 WorkBuddy + Hermes + 飞书 CLI 三层架构。

**Hermes 是什么：**Nous Research 的本地智能体运行时，用于定时任务调度和飞书消息自动收发。

以下是我的配置信息：

请帮我完成以下工作：

下载安装 Hermes 到 AppData\Local\hermes
在 ~/.hermes/.env 文件中写入：DEEPSEEK_API_KEY、FEISHU_APP_ID、FEISHU_APP_SECRET、DOMAIN=feishu、CONNECTION_MODE=websocket
在 ~/.hermes/config.yaml 中配置 provider 为 deepseek，model 为 deepseek-chat，base_url 为 https://api.deepseek.com，并在 platform_toolsets 中添加 feishu: [hermes-feishu]
用 uv sync 安装 Hermes 依赖
用 uv pip install lark-oapi aiohttp 安装飞书相关依赖
配置 ~/.workbuddy/.mcp.json 中的飞书 CLI（App ID 和 App Secret）
确认 WorkBuddy 左侧飞书连接器已连接

请一步步操作，每步完成后告诉我结果。如果遇到问题，帮我排查解决。

**提示：**把三个方括号【】里的内容换成你自己的真实值，其余不用改。WorkBuddy 会自动完成安装和配置。

WorkBuddy 告诉你配置完成后，以下操作需要你自己来：

打开 Windows 命令行（按 Win+R，输入 cmd，回车），粘贴以下命令：

bash

cd %USERPROFILE%\AppData\Local\hermes\hermes-agent && %USERPROFILE%\AppData\Local\hermes\bin\uv.exe run hermes gateway run

看到类似下面的输出就说明成功了：

text

Hermes Gateway running
  Messaging platforms: feishu
  Cron scheduler: active
  WebSocket connected

注意：如果卡在 "Initializing agent..." 不动，可能是 App Secret 不对。回到飞书开放平台确认 App Secret 是否正确。

第一次发消息，机器人会回复一个 pairing code（如 PAIR-XXXX）。你需要：

bash

cd %USERPROFILE%\AppData\Local\hermes\hermes-agent && %USERPROFILE%\AppData\Local\hermes\bin\uv.exe run hermes pairing approve CODE

授权成功后，回到飞书客户端，给机器人发消息：

text

/sethome

机器人回复确认后，整个搭建就完成了！以后 Hermes 定时任务的执行结果会发到这个聊天窗口。

再发一次「你好」，如果机器人正常回复（不是 pairing code），说明三层架构完全打通。