夜雨聆风Hermes和飞书CLI打通之后，你就能让你的 Agent 在飞书里动手干活——发消息、建文档、拉会议、填表格、做项目等等很多事情。
说一个很重要的前提：全程你不需要亲自一步一步地操作，你只需要把 Codex 装好，所有的事情就告诉 Codex 你要干嘛，需要授权的时候你点一下审批就行。
下面是我折腾一遍后整理的最简流程，后面附了踩坑记录和 Q&A。
〇、初次安装Hermes
如果还没装 Hermes，先装。
方式一：让 Codex 帮你装（推荐）
打开 Codex，把下面这段话发给它：
请帮我安装并配置 Hermes。
GitHub 仓库：https://github.com/NousResearch/hermes-agent
安装路径用默认路径，大模型 API Key 请询问我配置哪个服务商。
Codex 会自动识别你的系统（Mac/Windows/Linux），引导你安装并配置模型。
方式二：手动安装
Windows 用户打开 PowerShell，复制这一行：
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Mac/Linux 用户：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
装完后开一个新终端窗口，输入hermes能进入对话界面就算装好了。
首次配置模型
hermes model
选择模型服务商（如 DeepSeek、OpenAI），按提示粘贴 API Key，然后测试：
hermes -z "只回复 OK"
返回 OK 就说明配置成功。
一、升级Hermes
# 查看当前版本
hermes --version
# 如果版本低于 v0.19.0，执行升级
hermes update
# 验证升级结果
hermes --version
踩过的坑
坑 1：进程锁定— 升级前先关掉 Hermes 进程
hermes gateway stop
taskkill /PID 进程号 /F
坑 2：Git 可疑目录
git config --global --add safe.directory D:/Hermes/hermes-agent
坑 3：网络中断后入口文件丢失
# 用虚拟环境重新安装入口
D:\Hermes\hermes-agent\venv\Scripts\pip.exe install -e D:\Hermes\hermes-agent
二、安装飞书CLI
# 安装
npx @larksuite/cli@latest install
# 验证
lark-cli --version
踩过的坑
坑 4：npm 包安装成功，但二进制下载失败
# 手动执行安装脚本
node C:\Users\你的用户名\AppData\Roaming\npm\node_modules\@larksuite\cli\scripts\install.js
三、绑定到Hermes
# 绑定
lark-cli config bind --source hermes --identity user-default --force --lang zh
# 绑定成功后，配置会保存在
# C:\Users\你的用户名\.lark-cli\hermes\config.json
identity 选择说明：bot-only只能用机器人身份；user-default可用用户身份，能访问日历、邮箱、文档等全部功能。建议选user-default。
四、扫码授权
# 生成授权链接
lark-cli auth login --recommend --no-wait --json
# 将链接转成二维码
lark-cli auth qrcode "<上一步生成的链接>" --output qr.png --size 360
# 打开飞书 App 扫码，授权成功后执行
lark-cli auth login --device-code "<device_code>"
# 验证授权状态
lark-cli auth status
五、验证安装
# 完整诊断
lark-cli doctor
# 正常输出：9 项检查全部 pass
# cli_version / cli_update / config_file / app_resolved
# bot_identity / user_identity / identity_ready
# endpoint_open / endpoint_mcp
# 测试 API
lark-cli im +chat-list --page-size 1
六、启动Hermes 网关
# 正式启动
hermes gateway run
# 或安装为开机自启
hermes gateway install
hermes gateway start
注意：如果同时配置了微信，需先关闭微信策略WEIXIN_DM_POLICY=disabled，否则网关会被拦截。
最终状态确认
Hermes Agent v0.19.0 (2026.7.20) · Up to date
Feishu ✓ configured
lark-cli version 1.0.76 · doctor: ok=true
Q&A
Q：Hermes 最新版是多少？怎么确认是否需要升级？A：当前最新版是 v0.19.0。在终端执行 hermes --version，如果版本低于 0.19.0 且有 "Update available" 提示，就需要升级。
Q：升级时提示文件被占用怎么办？A：hermes gateway stop关掉后台服务，再用taskkill /PID 进程号 /F强制结束正在运行的 hermes.exe。
Q：升级过程中网络断了，入口文件变成了 .old 怎么办？A：不用慌，源码其实已经下载好了。进到 Hermes 目录，用虚拟环境的 pip 重新安装入口：venv\Scripts\pip.exe install -e D:\Hermes\hermes-agent。
Q：npx 装完 lark-cli 但执行报错，说二进制没装好？A：npm 包和二进制是分开安装的，网络不好时二进制可能下不下来。手动执行 node 安装路径\scripts\install.js即可。
Q：绑定身份时，bot-only 和 user-default 有什么区别？A：bot-only 只能用机器人身份，操作范围有限，但更安全。user-default 可以用你的个人身份，能访问日历、邮箱、云盘、文档等全部功能。建议选 user-default。
Q：怎么确认飞书 CLI 装好了？A：执行 lark-cli doctor，9 个检查项全部显示 pass 就是装好了。再跑 lark-cli im +chat-list --page-size 1测试一下 API 调用，能正常返回数据就说明能用。
Q：装了飞书 CLI 后，我的 Agent 能干什么？A：飞书 CLI 覆盖 14 大业务域、2500+ 开放 API。你的 Agent 可以替你发消息、建文档、拉会议、填多维表格、管日历、处理邮件、查审批——一句话的事。
Q：Hermes 网关启不动，提示微信策略问题？A：如果同时配了微信和飞书，微信的安全策略会阻止网关启动。临时方案是在 .env 里加一行 WEIXIN_DM_POLICY=disabled，先只跑飞书。