乐于分享
好东西不私藏

安装 Hermes / OpenClaw 并接入飞书智能体教程

安装 Hermes / OpenClaw 并接入飞书智能体教程

这份教程适合希望在飞书里拥有一个“能帮你处理日历、知识库、文档等工作的 AI 助手”的用户。
最终效果是:
你在飞书里创建一个智能体;
通过 Workbuddy 安装 Hermes 或 OpenClaw;
把飞书智能体、DeepSeek 大模型和 Hermes / OpenClaw 关联起来;
后续你就可以在飞书里和这个智能体对话,让它帮你处理日常工作。
建议选择:
苹果电脑:优先安装 Hermes
Windows 电脑:优先安装 OpenClaw

一、安装 Workbuddy

先安装 Workbuddy。
安装网址:
https://www.workbuddy.ai/
安装完成后,打开 Workbuddy。后续大部分复杂操作都可以直接交给 Workbuddy 处理。
你可以把 Workbuddy 理解成一个本地技术助手:
不懂怎么配置、哪里报错、飞书没反应、模型没接上,都可以直接问它。

二、让 Workbuddy 安装 Hermes 或 OpenClaw

打开 Workbuddy 后,直接对它说:
帮我安装 Hermes,并帮我关联上飞书。
如果你是 Windows 电脑,也可以说:
帮我安装 OpenClaw,并帮我关联上飞书。
推荐规则:
苹果电脑:建议 Hermes
Windows 电脑:建议 OpenClaw
如果你不确定自己该装哪个,也可以直接问 Workbuddy:
我是苹果/Windows电脑,帮我判断应该安装 Hermes 还是 OpenClaw,并完成安装。

三、注册并创建飞书智能体

1. 如果还没有飞书账号,先注册飞书
如果你还没有飞书账号,需要先注册飞书并登录。
2. 打开飞书开放平台
打开飞书开放平台:
https://open.feishu.cn/app?lang=zh-CN
登录你的飞书账号。
3. 创建智能体
打开创建智能体入口:
https://open.feishu.cn/page/launcher?from=backend_oneclick
进入后按提示创建智能体:
选择一个头像;
输入智能体名称;
点击创建。
智能体名称可以用你容易记住的名字,比如:
我的AI助理
4. 复制 AppID 和 AppSecret
创建完成后,页面会跳转到应用信息页面。
你会看到:
AppID
AppSecret
把这两个内容复制下来。
然后回到 Workbuddy,对它说:
飞书的 appID:这里替换成你的 AppID
appSecret:这里替换成你的 AppSecret
帮我把飞书智能体关联上。
示例:
飞书的 appID:cli_xxxxxxxxxxxxx
appSecret:xxxxxxxxxxxxxxxx
帮我把飞书智能体关联上。
注意:
AppSecret 不要发到公开群里,只发给你本地的 Workbuddy。

四、接入 DeepSeek 大模型

接下来需要给 Hermes / OpenClaw 配置大模型。这里推荐使用 DeepSeek。
1. 打开 DeepSeek
打开:
https://www.deepseek.com
点击 API / 开放平台入口。DeepSeek 官网也提供 API 开放平台和 API 文档入口。
2. 注册并充值
注册 DeepSeek 账号。
建议先充值少量金额,例如:
10 元
用于测试和日常轻量使用。
3. 创建 API 密钥
进入 DeepSeek 开放平台后:
在左侧点击 API;
找到 API 密钥管理;
新建一个 API 密钥;
复制这个密钥。
如果密钥没有复制成功,不用担心:
删除刚才那个密钥;
再创建一个新的;
重新复制即可。
4. 交给 Workbuddy 配置
复制好 DeepSeek API 密钥后,回到 Workbuddy,对它说:
帮我把 Hermes 对接上 DeepSeek 大模型,密钥是:XXX
如果你安装的是 OpenClaw,就说:
帮我把 OpenClaw 对接上 DeepSeek 大模型,密钥是:XXX
其中 XXX 替换成你刚刚复制的 DeepSeek API 密钥。
示例:
帮我把 Hermes 对接上 DeepSeek 大模型,密钥是:sk-xxxxxxxxxxxxxxxx

五、在飞书里启动智能体

1. 找到你的智能体
打开飞书消息界面。
在顶部搜索框里输入你刚才创建的智能体名称。
例如:
我的AI助理
找到它后,点进去。
2. 先发送一句 hello
给它发一句:
hello
接下来根据你安装的是 OpenClaw 还是 Hermes,会有不同情况。

六、OpenClaw 的首次处理方式

如果你安装的是 OpenClaw:
它可能会回复你一串代码或验证码。
你需要:
复制这串码;
回到 Workbuddy;
对 Workbuddy 说:
OpenClaw 给了我这串码:XXX
帮我处理一下。
把 XXX 替换成 OpenClaw 返回给你的那串码。
Workbuddy 会继续帮你完成后续关联。

七、Hermes 的首次处理方式

如果你安装的是 Hermes:
Hermes 可能会要求你设置主要对话界面。
你只需要在飞书智能体对话框里发送:
/sethome
发送后,Hermes 会把当前飞书智能体设置为主要对话入口。
之后就可以正常使用了。

八、正常使用

完成上面的步骤后,你就可以在飞书里和你的智能体对话了。
你可以试着问:
帮我总结今天的日程。
帮我查一下知识库里关于项目推进的资料。
帮我整理一份会议纪要。
帮我新建一个文档,标题是本周工作计划。
后续怎么用,取决于你的工作场景和日常协作方式。
它可以逐渐变成一个能操作飞书日历、知识库和文档的“工作小虾”。

九、如果飞书没有反应怎么办

如果你在飞书里发消息后没有反应,不要自己硬排查。
直接告诉 Workbuddy:
目前飞书没有反应,帮我检查一下 Hermes / OpenClaw 的配置。
如果你看到报错、弹窗、终端异常、页面异常,也可以截图丢给 Workbuddy,然后说:
这是我现在遇到的问题,帮我修复。
也可以说:
帮我检查一下 Hermes / OpenClaw 是否正常启动,如果没有启动,请帮我启动。
简单理解:

万事不决,问 Workbuddy。

你可以把 Workbuddy 当成安装和维护这个 AI 助手的本地技术支持。

十、安装 find-skills 技能

完成基础配置后,可以让你的飞书智能体安装一个技能,用来发现和安装更多技能。
这个页面显示,find-skills 用于帮助智能体发现和安装开放生态里的专业技能,也提供了 npx skills 相关命令。
你可以直接对飞书智能体说:
我需要安装这个技能,这个技能在这个链接:

https://www.skills.sh/vercel-labs/skills/find-skills

如果智能体需要你确认安装,就按提示确认。

十一、安装飞书 CLI

接下来,让智能体安装飞书 CLI,使它能够更好地操作飞书里的日历、知识库、文档等能力。
飞书官方文档链接:
你可以对飞书智能体说:
我需要安装这个 CLI,链接是:

https://open.feishu.cn/document/mcp_open_tools/feishu-cli-let-ai-actually-do-your-work-in-feishu

如果它需要 Workbuddy 配合安装,也可以把这个需求转给 Workbuddy:
帮我按照这个链接安装飞书 CLI

十二、完成后的使用建议

配置完成后,你就拥有了一个可以连接飞书工作场景的 AI 助手。
它能做什么,取决于你给它安装了哪些能力,以及你如何使用它。
你可以围绕这些方向来用:
日历:查看日程、安排会议、提醒事项;
文档:创建文档、整理内容、生成会议纪要;
知识库:查询资料、总结文档、沉淀知识;
协作:根据上下文生成待办、同步信息、辅助跟进。
建议你从简单任务开始,比如:
帮我整理今天的工作待办。
帮我把这段内容整理成飞书文档。
帮我查一下知识库里有没有关于客户跟进的资料。
帮我根据这个会议内容生成一份会议纪要。

十三、常见问题处理

1. 飞书智能体没反应
对 Workbuddy 说:
目前飞书没有反应,帮我检查一下 Hermes / OpenClaw 的配置。
2. 不确定 Hermes / OpenClaw 有没有启动
对 Workbuddy 说:
帮我检查一下 Hermes / OpenClaw 是否启动;如果没有启动,请帮我启动。
3. DeepSeek 好像没有接上
对 Workbuddy 说:
帮我检查一下 Hermes / OpenClaw 是否已经正确接入 DeepSeek 大模型。
4. 飞书关联失败
对 Workbuddy 说:
飞书智能体关联失败,帮我检查 appID、appSecret 和飞书开放平台配置。
5. 看到报错但不知道什么意思
截图发给 Workbuddy,然后说:
这是报错截图,帮我判断问题并修复。
一句话总结
整个流程可以理解为:
安装 Workbuddy
→ 让 Workbuddy 安装 Hermes / OpenClaw
→ 在飞书开放平台创建智能体
→ 把 AppID 和 AppSecret 交给 Workbuddy 关联
→ 注册 DeepSeek 并生成 API 密钥
→ 让 Workbuddy 接入 DeepSeek
→ 在飞书里激活智能体
→ 安装 find-skills 和飞书 CLI
→ 开始使用
完成后,你就有了一只可以在飞书里帮你处理日历、知识库和文档的 AI 工作小虾。