新手如何用 WorkBuddy 或 Codex 搭建飞书 Hermes Agent：从安装到业务自动化完整教程

很多人一听到 Agent、API、飞书机器人、自动化，第一反应就是：这是不是程序员才能玩的东西？其实不是。

现在有了 WorkBuddy、Codex 这类可以直接执行任务、安装依赖、读日志、改配置的 AI 助手，手搓一个能处理业务流程的 Hermes Agent 已经不再是高门槛工程。真正重要的不是你会不会写代码，而是你能不能把自己的业务流程讲清楚，然后让 AI 帮你一步步搭出来。

这篇教程会用尽量直白的方式，带你搭一个可以在 飞书里工作的 Hermes Agent。你不需要一开始就懂技术，只需要会复制粘贴、会描述需求、会把报错截图或日志发给 AI。

当然，它不会一次就完美。中间大概率会遇到依赖安装、API 配置、飞书权限、模型报错、本地端口被占用等问题。但这正是 AI 工具最有价值的地方：你不需要自己硬啃文档，可以让 WorkBuddy 或 Codex 陪你一路排查。

跑通以后，你就会得到一个可以在后台帮你干活的业务 Agent。

一、先准备一个能帮你操作电脑的 AI 工具

第一步，先安装 WorkBuddy。如果你有条件，我更建议直接使用 Codex，它在理解复杂需求、排查工程问题、执行多步骤任务方面通常会更稳。

这一步不用想太复杂。你只需要有一个能帮你执行安装、配置、排查问题的 AI 助手。

WorkBuddy 下载地址：https://www.codebuddy.cn/events/invite?inviteCode=jlc6rmxm1e12w19

二、让 AI 帮你安装 Hermes Agent

注意，这里要安装的是 Hermes Agent，不要装错成别的 Agent 项目。

安装过程中，新手最容易遇到这些卡点：

电脑没有安装新版 Python；
没有安装 Node.js 或 npm；
终端权限不足；
某些依赖下载失败；
本地端口被占用。

不用慌。让 WorkBuddy 或 Codex 帮你检查环境、安装依赖、修复报错即可。你自己只需要会打开命令终端，因为有些操作 AI 可能没有权限直接执行，它会把命令给你，你复制到终端里运行就行。

可直接复制的提示词

请帮我在这台电脑上安装并配置 Hermes Agent。
请按以下步骤执行：
1. 先检查当前系统环境，包括 Python、Node.js、npm、Git、包管理器和终端权限。
2. 如果缺少依赖，请告诉我需要安装什么；你能直接安装就直接安装，不能直接操作就把命令给我，我手动复制到终端运行。
3. 安装 Hermes Agent，并确认它可以正常启动。
4. 启动完成后，请告诉我 Hermes 的本地访问地址、后台服务是否正常、日志在哪里查看。
5. 不要跳过验证步骤，请用健康检查、Web UI 或日志确认 Hermes 确实已经跑起来。

三、配置大模型 API：Hermes 是壳，模型是灵魂

Hermes Agent 本身只是一个“壳”，真正负责思考、理解和生成结果的是后面的 AI 大模型。你需要注册一个大模型 API，例如 Kimi、MiniMax、DeepSeek、通义千问、OpenAI，或其他兼容 OpenAI API 格式的模型服务。

注册后，找到 API Key。最省事的方法，是把 API Key 发给 WorkBuddy 或 Codex，让它帮你配置到 Hermes 里。但这里要提醒一句：API Key 是敏感信息，明文发送一定有泄露风险。更稳妥的方式，是让 AI 告诉你应该把 Key 填到哪个本地配置文件、环境变量或 Web UI 页面里，然后你自己手动粘贴。

如果你的 Hermes 安装方式支持 Web UI，可以让 WorkBuddy 或 Codex 打开 Hermes 管理页面。部分环境也可以在终端输入类似 hermes dashboard 的命令进入控制台。进入后找到 Model 或模型配置页面，手动填入模型地址、模型名称和 API Key。

大模型配置提示词

请帮我配置 Hermes Agent 使用大模型 API。
我会提供以下信息：
- API 服务商：
- API Key：
- Base URL：
- 模型名称：
请你帮我完成配置，并注意：
1. 不要在日志或输出里明文展示我的 API Key。
2. 如果可以，请优先使用本地配置文件或环境变量保存密钥。
3. 配置完成后，请用一条简单测试消息验证模型是否能正常回复。
4. 如果失败，请检查 Base URL、模型名称、API Key、余额、网络连接和接口兼容性。
5. 最后请告诉我配置是否成功，以及后续如何更换模型。

四、创建 Hermes Profile：把业务流程写清楚

这是最关键的一步。你需要让 WorkBuddy 或 Codex 帮你创建一个 Hermes Profile。可以把它理解成 Agent 的“角色档案”或“工作说明书”。

你要告诉它：这个 Agent 是什么角色、负责什么业务、可以使用哪些工具、用户会输入什么内容、应该输出什么结果、哪些操作需要确认、哪些错误流程要自动处理、结果不确定时应该怎么追问。

Profile 创建提示词

请帮我创建一个 Hermes Agent 的 Profile。
这个 Agent 的角色是：
【在这里写角色，例如：Ozon 电商选品助手】
它的主要任务是：
【在这里写任务，例如：根据商品链接、成本、售价、平台数据，判断商品是否值得上架，并输出优化建议】
它可以使用的数据来源有：
【在这里写数据来源，例如：飞书多维表格、1688 商品链接、Ozon 卖家 API】
它的输出格式需要包括：
- 商品基础信息
- 成本和利润估算
- 竞争分析
- 风险提示
- 是否建议上架
- 下一步操作建议
请你帮我把这些内容整理成一个清晰、可执行、低 Token 消耗的 Hermes Profile。
要求：不要写空泛人设，要写清楚工作流程、判断标准、异常处理方式和输出格式。

五、接入电商平台 API 和商品信息来源

如果你做的是电商 Agent，通常还需要接入对应平台的卖家 API。例如沃尔玛、Ozon 的 API 一般可以在卖家后台设置中找到；Amazon 会麻烦一些，需要到“应用与服务”或“开发者应用管理”相关页面申请，认证通常需要 1 到 3 天；其他小平台一般会简单很多，通常在开放平台或卖家后台能找到 API 配置。

API Key 同样是敏感信息。简单做法是交给 WorkBuddy 或 Codex 帮你配置；更安全的做法是让它告诉你配置位置，你自己手动填写。

除了平台 API，你还需要给 Agent 一个商品信息来源。常见方式有两种：

从其他平台抓取信息：可以使用官方 API，例如 1688 的 API 可以在 1688 开放平台申请，也可以找第三方 ERP 是否有对应接口。不想麻烦的话，也可以让 AI 用 Playwright 模拟浏览器打开网页、读取页面内容，但这种方式通常需要 cookies，且稳定性不如官方 API。
飞书多维表格：这是最简单的方式。你创建一个飞书多维表格，把商品链接、成本、售价、平台、备注等字段整理好，然后把表格链接或字段说明交给 WorkBuddy/Codex，让它帮你接入。

六、创建飞书应用：权限和事件别漏

打开飞书开发者后台，创建一个企业自建应用。这一步很关键，也很容易出错。建议按下面顺序检查：

添加应用能力：开启“机器人”。
权限管理：搜索并开通消息、群组、机器人相关权限。新手为了减少排错成本，可以先多开一些“消息与群组”权限，跑通后再收窄到实际需要的权限。
事件与回调：事件订阅方式选择“长连接”。然后添加和即时消息相关的事件，常见是 im 开头的事件，例如接收用户私聊消息、群聊中被 @、消息发送等。回调配置同样使用长连接，并添加“卡片回传交互”，这样 Agent 需要确认时，可以通过消息卡片确认。
发布应用：权限和事件配置完成后，记得发布或更新应用版本。很多人配置都对了，但忘记发布，结果机器人一直收不到消息。

七、连接飞书机器人和 Hermes Agent

把飞书应用的 App ID 和 App Secret 提供给 WorkBuddy 或 Codex，让它帮你接入 Hermes。再次提醒：App Secret 是敏感信息，更稳妥的方式是让 AI 指导你填入本地配置文件、环境变量或 Hermes Web UI，而不是长期留在聊天记录里。

飞书连接提示词

请帮我把飞书机器人连接到 Hermes Agent。
我会提供：
- 飞书 App ID：
- 飞书 App Secret：
- Hermes 后台地址：
- 需要绑定的 Agent 名称：
请你帮我检查并配置：
1. 飞书应用是否已经开启机器人能力。
2. 消息与群组相关权限是否足够。
3. 事件订阅是否使用长连接。
4. 是否订阅了私聊消息、群聊 @ 消息等必要事件。
5. Hermes 是否已经接收到飞书事件。
6. 机器人是否能正常回复私聊消息。
7. 机器人在群聊里被 @ 时是否能正常回复。
如果中间需要我去飞书后台手动操作，请一步一步告诉我点哪里、选什么。

配置完成后，打开飞书客户端，在工作台或应用列表中找到你的机器人。先做一个最简单的测试：给机器人发一句“测试”。如果机器人有回复，说明基础链路跑通了。

八、没有回复怎么办：按日志排查

如果机器人没有回复，让 WorkBuddy 或 Codex 帮你检查两类日志：飞书 Gateway 的实时日志，确认飞书消息有没有进入 Hermes；以及 Hermes 会话记录，确认 Hermes 有没有收到消息、有没有调用模型、有没有报错。

一般没接通就两个原因：第一，飞书没有真正接入 Hermes，例如 App ID/App Secret 配错、事件没订阅、权限没开、应用没发布、长连接没启动；第二，Hermes 处理异常，例如模型 API Key 配错、模型名称不对、Profile 写得不清楚、工具调用失败或代码报错。

排查提示词

Hermes Agent 现在出现了问题，请帮我排查。
问题现象是：
【在这里描述问题，例如：飞书机器人收不到消息 / Hermes 启动失败 / 模型没有回复 / 工具调用失败】
请你按这个顺序检查：
1. 先确认 Hermes 服务是否正在运行。
2. 检查 Hermes 后台健康状态和访问地址。
3. 查看最近的错误日志。
4. 判断问题属于哪一类：环境依赖、模型配置、飞书连接、Profile 配置、工具调用、网络问题。
5. 不要直接猜原因，请根据日志给出判断。
6. 如果需要我手动执行命令，请把命令单独列出来，并告诉我执行后应该把什么结果发给你。
7. 修复后，请重新测试，直到确认问题解决。

九、跑通只是 0 到 1，后面要持续优化

跑通以后，再观察 Agent 的交付结果是否符合预期。如果结果不好，不要太快放弃，先优化这几个地方：

修改 Profile，让角色、流程、输入输出更明确；
把高频错误流程沉淀成 Skill；
把常用工具提前写成脚本；
限制无效搜索和无效思考，减少 Token 消耗；
给关键动作加确认机制，避免误操作。

不要指望第一次搭出来的 Agent 就完美。真正有价值的 Agent，都是一边使用一边优化出来的。第一次跑通，只是完成了从 0 到 1。后面你还要继续调整 Profile、沉淀 Skill、优化工具脚本、减少 Token 消耗、增加异常处理，让它越来越懂你的业务。

它不一定比人更快，也不一定每次都更聪明，但它最大的优势是不用休息，可以持续工作、持续复盘、持续改进。先跑起来，再慢慢变强。