嘿，今天咱们来聊聊怎么在 Mac 上快速部署 Hermes Agent，并把它接入飞书。这玩意儿其实挺有意思的，Neng让你的 AI 机器人跑在本地，还Neng自己长脑子，越用越聪明，你懂的，就是那种“用得越久越牛”的类型。

害，先说一句，这东西是 Nous Research 开的源，定位是“自托管 AI Agent 网关”，主打一个灵活、开源、Neng跑在你自己的服务器上，还Neng自己学习。你要是想在飞书里搞个 AI 机器人，那这个项目就是你的菜了。

那我们先从头开始，一步步来别急，别急，先装环境。

一、准备工作

你得有个 Mac，对吧？然后我们来装点基础依赖。别跳过这步，不然后面会出事的，信我。

打开你的终端，先装 Homebrew，这个是 Mac 上的包管理器，你要是还没装，Ke以敲：

/bin/bash -c "$"

装完之后它会提示你把 brew 加到 PATH 里你照着Zuo就行。然后验证一下：

brew --version

Ru果Neng跑出版本号，那说明你成了。

然后我们来装几个必要的依赖：

brew install python@3.11 node git ripgrep uv

装完之后验证一下：

python3 --version
node --version
uv --version

Apple Silicon 用户注意一下PATH 要对，别让系统自带的 Python 抢了风头。你Ke以用 which python3 kankan是不是指向 /opt/homebrew/bin/python3，不是的话就改一下：

echo 'export PATH="/opt/homebrew/bin:$PATH"'>> ~/.zshrc
source ~/.zshrc

二、安装 Hermes Agent

接下来就是正菜了安装 Hermes Agent。你只需要在终端里跑一行命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

这个脚本会自动帮你搞定安装，不用 sudo，不然后面写入权限会出问题，别问我怎么知道的，我踩过坑。

装完之后验证一下：

source ~/.zshrc
hermes version
hermes doctor

Ru果提示 hermes: command not found，那你就得手动加一下 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"'>> ~/.zshrc
source ~/.zshrc

然后跑一下 hermes setup，它会问你选哪个模型服务商，比如 MiniMax、OpenAI、百川啥的，你按提示来就行。

三、飞书平台配置

接下来我们得去飞书开放平台创建一个应用。这步不Neng跳，不然机器人连不上。

访问飞书开放平台，创建一个企业自建应用，名字随便起，比如“我的AI助手”。然后在应用详情里记下 App ID 和 App Secret，后面要用。

然后在“应用Neng力”里启用机器人，再在“权限管理”里加几个权限，比如：

im:message

im:message.p2p_msg:readonly

然后在“事件与回调”里把 im.message.receive_v1 事件订阅上，这个是关键，不订阅机器人就不会理你。

然后创建一个版本，比如 1.0，提交审批，发布应用。建议“全员可用”，省得你不在白名单里。

然后跑一下：

hermes setup gateway

注意，子命令是 gateway，不是 messaging，别搞错了。

然后启动网关：

hermes gateway start

Ru果提示你没选平台，记得按空格选上飞书，不然啥dou不会配。

启动后你可Neng会kan到一个警告：

No user allowlists configured. All unauthorized users will be denied.

测试阶段Zui快的办法就是放开所有用户：

echo 'GATEWAY_ALLOW_ALL_USERS=true'>> ~/.hermes/.env
hermes gateway restart

四、验证连接

然后kan日志：

tail -f ~/.hermes/logs/agent.log

kan到这行就说明连上飞书了：

 connected to wss://msg-frontier.feishu.cn/...

五、测试对话

然后在飞书 App 里搜你的机器人名字，或者在开放平台点“添加到工作台”，私聊发一句“你好”，机器人应该Neng回你。

常用命令：

hermes gateway status   # 查kan状态
hermes gateway start    # 启动
hermes gateway stop     # 停止
hermes gateway restart  # 重启
hermes gateway run      # 前台运行，方便kan日志

kan日书的正确方式：

ls ~/.hermes/logs/
tail -f ~/.hermes/logs/agent.log

六、常见问题

Ru果机器人没反应，按概率排查：

应用没发布

没订阅 im.message.receive_v1 事件

权限不全

机器人Neng力没启用

测试阶段Ke以跳过白名单，或者直接放开：

echo 'GATEWAY_ALLOW_ALL_USERS=true'>> ~/.hermes/.env
hermes gateway restart

七、安装飞书 CLI

Hermes Bot 本身只Neng收到 @ 或私聊它的消息，读不了群里历史聊天、云文档、多维表格。要让 Hermes 真正“接管”飞书，需要装飞书 CLI。

安装：

npm install -g @larksuite/cli

国内走镜像：

npm install -g @larksuite/cli --registry https://registry.npmmirror.com

验证：

lark-cli --version

Ru果找不到命令：

echo 'export PATH="$/bin:$PATH"'>> ~/.zshrc
source ~/.zshrc

创建 CLI 专用应用：

lark-cli config init

会弹浏览器链接，创建一个新应用，起个名比如“Lark CLI”，创建完回终端自动拿到凭证。

lark-cli auth login --recommend

--recommend 自动勾选常用权限，省得一个个选。

lark-cli auth status
lark-cli auth whoami
lark-cli calendar +agenda      # kan今天日程
lark-cli im +chats-list      # 列出聊天会话

八、让 Hermes 用上 lark-cli

方法 A：让 Hermes 自动学习

直接在飞书私聊 Hermes：

用飞书 CLI 拉一下我Zui近的聊天会话列表

Hermes 会自己摸索命令，并把经验沉淀成 skill。

方法 B：手动创建 skill 指南

mkdir -p ~/.hermes/skills/lark-cli
cat> ~/.hermes/skills/lark-cli/SKILL.md <'EOF'
# 飞书 CLI  使用指南
当用户要求操作飞书时使用 lark-cli 命令行工具。
大部分 im 命令支持 `--as user|bot`，默认 user。
`--as user` 以登录用户身份Nengkan到所有私聊群聊文档，读取类操作用这个；
`--as bot` 以机器人身份只Nengkan到机器人参与的聊天主动发消息Ke以用。
读取用户数据省略 --as 即可，遇到 "Bot 身份无法列出私聊" 时显式加 --as user。
即时消息相关命令：
搜索聊天会话用 `lark-cli im +chat-search --query "关键词"`，注意 +chat-search 必须提供 --query 或 --member-ids 不Neng空参数调用；
按成员 open_id 搜私聊用 `lark-cli im +chat-search --member-ids "ou_xxx"`；
只搜私聊加 `--search-types private`；
按Zui近活跃排序加 `--sort-by update_time_desc`；
表格输出加 `--format table`。
真正列出全部Zui近聊天 chat-search 不支持，用原生 API：
`lark-cli api --method GET --path "/open-apis/im/v1/chats?page_size="`。
读取消息用 `lark-cli im +chat-messages-list --chat-id ` 或 `--user-id ` 自动解析 P2P 私聊；
跨所有聊天搜消息用 `lark-cli im +messages-search --query "关键词"` 这个 user-only Zui实用；
批量取消息详情用 `lark-cli im +messages-mget --ids om_xxx,om_yyy`；
读话题回帖用 `lark-cli im +threads-messages-list --message-id `。
发送消息用 `lark-cli im +messages-send --chat-id  --text "内容"` 或 `--user-id `；
回复某条消息用 `lark-cli im +messages-reply --message-id  --text "回复"`。
下载图片文件用 `lark-cli im +messages-resources-download --message-id  --file-key `。
群管理：建群 `lark-cli im +chat-create --name "群名"`，改群信息 `lark-cli im +chat-update --chat-id  --name "新群名"`。
调用规则 Agent 必须遵守：不确定命令或参数时先跑 `lark-cli <模块> --help` 再跑 `lark-cli <模块> +<命令> --help` 核对，绝不凭记忆瞎猜命令名；
命令用 + 前缀如 +chat-search 不是破 - 号；输出格式 --format 支持 json pretty table ndjson csv 默认 json 便于解析；
jq 筛选用 `--jq '.items | {chat_id, name}'` 只保留关心字段；
分页用 --page-size和 --page-token；
不确定时加 --dry-run 只打印请求不执行；
CLI 没封装的接口用 `lark-cli api --method GET --path "/open-apis/..."` 兜底。
常见错误及处理：报 `unknown flag: --xxx` 跑 --help 核对参数名不同版本 flag 可Neng不同；
报 `invalid choice: 'xxx'` 命令名错了跑 `lark-cli <模块> --help` kan实际命令列表；
报 `Bot 身份无法列出私聊` 显式加 --as user 或重新用户身份登录 `lark-cli auth login --recommend --domain all`；
报 `--query and --member-ids cannot both be empty` chat-search 必须带查询条件见上文 workaround；
报 `Scope required: xxx` 补授权 `lark-cli auth login --scope "xxx"`；
命令返回空或报权限确认登录身份 `lark-cli auth whoami` 和Yi授权 scope `lark-cli auth status`。
重要原则：遇到报错不要硬猜命令，先 --help，命令错了就换，参数错了就改，lark-cli 的错误信息dou会明确告诉你下一步Zuo什么。
EOF
hermes gateway restart

九、实战玩法

配好之后在飞书私聊 Hermes 试这些：

Hermes 会自动调 lark-cli 完成任务，并把经验沉淀成 skill，下次geng顺。

hen多人关心 1M tokens Neng用多久，粗略参考：

省 token 技巧：

个人用户推荐 DeepSeek — 国内访问快、便宜、Agent Neng力够用，块钱Neng撑挺久。

到这一步，你Yi经拥有了：

Hermes 的核心卖点是会自我成长——每次你教它Zuo一件事，它dou会沉淀成 skill，第二次再Zuo就熟练hen多。

建议把一些高频任务写成固定的触发话术，比如：

用上一两周，你会发现它真的在进化。

Ru果这篇文章帮到你，欢迎点赞收藏转发 👍

说实话，这玩意儿挺适合搞自动化的，比如你每天要查日报、写周报、回客户、查飞书文档，它douNeng帮你搞定。你只需要跟它说一句“帮我查查今天飞书上有没有新消息”，它就会自动去查，然后把结果发给你。你甚至Ke以教它怎么查、怎么回、怎么写，它会记住的，下次就geng聪明了。你懂的，就是那种“越用越顺手”的感觉。

对了你可Neng会问，为啥百度不收录？

害，这问题问得好。其实吧，百度收录这事儿，跟咱们这项目没啥关系。它收录的是网页内容，咱们这是本地部署的 AI 机器人，又不是网站，它当然不收录。你要是想让百度收录你机器人的回答，那得搞个网站，然后把内容放上去，再等它爬。不过咱这项目主打的是本地化、私有化，不是给搜索引擎kan的，是给你自己用的。所以百度不收录，也正常。

你要是想让它被收录，那得另开一个项目，专门搞网站内容生成，那又是另一回事了。咱们这个项目，是让你自己爽的，不是给搜索引擎kan的，你懂的。

---