Hermes Agent 企业微信接入思路：权限、群聊、日报和客户服务

企业微信适合什么场景

企业微信适合内部通知、项目日报、客户服务摘要和异常提醒。它不适合一开始就承载高风险写入动作，比如批量群发、修改客户资料或操作生产系统。

推荐接入顺序

先建一个测试群，只允许负责人触发命令。跑通 `/status`、日报推送和错误提醒后，再把工作流接到正式群。

输出格式

企业微信群里信息容易被刷走，输出要短：标题、三条重点、负责人、下一步、是否需要人工确认。长报告放到文档里，群里只推摘要。

项目日报
重点：接口联调完成，验收脚本未完成
阻塞：生产环境变量未确认
负责人：李四
下一步：今天 16:00 前补齐配置清单

客户服务怎么用

客户服务场景先做摘要和草稿，不要直接自动外发。Hermes Agent 可以归纳高频问题、生成 FAQ 更新建议、写回复初稿；涉及退款、合同、价格、承诺和投诉升级时，必须交给人工确认。

权限边界

Bot 只申请当前工作流需要的权限。客户数据、订单数据和内部聊天记录要做脱敏处理；涉及外部发送和修改数据的动作必须二次确认。团队内部也要区分测试群和正式群，不要让维护命令暴露给所有成员。

排错清单

收不到消息先查群权限和 webhook；回复错群先查 Chat ID；多人触发串上下文时，按用户或频道隔离会话。Gateway 后台进程改过配置后，要重启并看日志，不要只看前端群消息。

进程怎么跑：调试期前台，稳定期装服务

接入初期，回调地址、凭证、群配置都在频繁改动，这个阶段用 `hermes gateway run` 在前台跑：每一条报错的原文直接打在终端里，改完配置 Ctrl+C 再拉起，反馈循环最短。前台进程随窗口关闭而消失，这恰好是调试期想要的性质——机器上不会残留一个你已经忘掉的实例。官方还点名三类环境应当长期保持 run 模式——WSL、Docker、Termux——这些环境里别折腾系统服务，交给容器或外层工具负责拉起即可。

hermes gateway install
hermes gateway status

配置连续一周没再动过，再切到 `gateway install`，把 gateway 装成系统服务：Linux 上是 systemd，macOS 上是 launchd，开机自启，不再绑定某个终端窗口的生死。切换动作有顺序：先确认前台那个 run 进程已经退出，再执行 install，装完用 `gateway status` 确认服务真的接管了，当晚留意一次推送是否按时到群。一台机器只保留一种启动方式，前台和服务并存时你很难说清现在到底是谁在收消息，出问题也不知道该查哪个进程。哪天要把机器人挪去别的服务器，先 `gateway uninstall` 把这台的服务卸干净，避免旧机器残留一个还在抢消息的实例。

私聊入口用配对码收口

群聊有成员列表天然圈定了范围，私聊没有：任何摸到机器人入口的同事都可能直接发起对话。Hermes 对这件事的方案是 DM 配对：

hermes pairing

`hermes pairing` 管理私聊配对码，决定谁能通过私聊使用这个机器人。落到企业流程里就是一步：新同事要用，先找维护者领配对码；人员变动时从配对管理里移除。相比去各平台后台逐个翻可见范围设置，配对码把"谁能私聊 Agent"收敛成 Hermes 这一侧的一份名单，审计的时候只看一处。发码这个动作本身别走大群，单独私发或当面给，否则名单等于形同虚设。

还没有真实场景？可以先领取 [Free Starter 模板包](/free-template-pack)，从低风险只读任务开始试跑。