Slack集成HermesAgent：团队协作自动化

一、配置Slack应用与API凭证

想把Hermes Agent和Slack打通，让告警推送和任务协作自动化起来？第一步，得先搞定身份认证。这活儿全靠两个关键凭证：Bot Token和App Token。你得在Slack的API后台创建一个专属应用，并开启Socket Mode，这样才能让Agent和Slack之间建立起双向、实时的通信通道。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

具体怎么操作呢？跟着这几步走：

首先，访问Slack API控制台，点击那个醒目的“Create New App”按钮。创建时选择“From scratch”模式，从头开始。

接着，给你的应用起个名，比如Hermes-Alerts，然后选择它要入驻的工作区，点击“Create App”完成创建。

应用创建好后，找到左侧菜单的“OAuth & Permissions”页面。这里的关键是配置机器人权限。在“Bot Token Scopes”部分，把这几个权限scope加上：chat:write（发消息）、channels:read、groups:read、im:read（读取频道、群组和私信信息）。

权限配好了，就滚动到页面底部，点击“Install to Workspace”把应用安装到工作区。安装成功后，系统会生成一个以xoxb开头的SLACK_BOT_TOKEN，务必复制保存好。

最后一步，启用Socket Mode。进入“Settings”菜单下的“Socket Mode”选项，打开开关。页面上会显示一个以xapp开头的SLACK_APP_TOKEN，同样复制下来。这两个Token就是后续所有集成的钥匙。

二、设置环境变量与启动参数

拿到了钥匙，下一步就是告诉Hermes Agent钥匙在哪。为了保证安全，凭证绝对不能硬编码在配置文件里。标准的做法是通过环境变量注入。

操作很简单，在运行Agent的主机上，执行下面两条命令：

export SLACK_BOT_TOKEN=xoxb-your-slack-bot-token

export SLACK_APP_TOKEN=xapp-your-slack-app-token

执行后，可以用echo $SLACK_BOT_TOKEN命令验证一下，确保输出不是空的，证明变量已经设置成功。

如果你的Agent是通过systemd这类服务管理器托管的，记得还需要在服务文件（比如/etc/systemd/system/hermes.service）的[Service]段落里，用Environment指令把这些变量加进去，确保服务启动时能读到它们。

三、启用Slack通知模块并绑定事件

凭证就位了，现在来激活Agent的Slack通知功能。这个模块默认是不开启的，需要你在YAML配置文件里显式启用，并告诉它：消息往哪个频道发，以及什么情况下才需要发。目的是确保只有关键事件才会触发通知，避免频道被无关信息刷屏。

打开Hermes Agent的主配置文件config.yaml，找到notifications:这个配置节点。在里面添加一个slacker的配置块。

核心配置就这几项：把enabled设为true；在channel里指定目标频道，比如“#hermes-alerts”（注意，这个频道需要你提前在Slack工作区里创建好）。

然后，在events:这个列表里，声明哪些事件类型会触发Slack通知。举个例子，你可以把high_cpu_usage（CPU使用率过高）、task_failure_rate（任务失败率超标）这些关键指标放进去。

配置保存后，别忘了重启一下Agent进程，让所有改动生效。

四、验证Slack消息投递链路

配置都做完了，但通道真的通了吗？最好在依赖它发送真实告警前，先手动验证一下整个投递链路是否畅通。这能帮你提前发现权限问题、网络拦截或者配置疏漏。

最直接的验证方法，就是通过Agent的CLI工具发送一条测试消息。在Agent的运行目录下，执行这个命令：

hermes notify slack "✅ Hermes Slack integration test"

执行之后，立刻去Slack里找到你配置的目标频道。如果一切正常，5秒内你应该能看到一条带着✅表情的测试消息。

如果没收到消息，别慌。先去查看Agent的日志文件，重点找gateway/platforms/slack.py相关的错误记录。常见问题无非是Token权限不足、Socket连接超时，或者网络策略阻断了连接。

基础消息通了之后，还可以发一条结构更复杂的JSON测试负载，看看富文本、代码块这些格式在Slack里渲染得是否正常，确保后续的协作消息能完美呈现。

五、配置多角色协作消息模板

基础的告警通知可能只包含状态和数值，但真正的团队协作需要更丰富的上下文。比如，谁是这个任务的负责人？截止时间是什么时候？相关的操作链接在哪？这就需要定制化的消息模板了。

Hermes Agent支持使用Jinja2模板引擎来定义消息格式。具体做法是，在skills/notifications/slack/templates/这个目录下，新建一个模板文件，比如task_assignment.j2。

在这个模板文件里，你可以用变量占位符来设计消息体。比如，用{{ assignee }}表示负责人，用{{ due_date }}表示截止日期，用{{ task_link }}放入任务详情链接。你甚至可以设计Slack的@提及语法，来直接通知到具体成员。

模板创建好后，回到config.yaml的slack配置块中，添加一个template: task_assignment.j2字段，指向你刚创建的模板文件。

这样，当有协同任务需要分配时，Agent就会自动抓取任务数据，填充到模板的变量里，生成一条信息完整、责任到人的协作消息，并推送到Slack频道，真正实现自动化的工作流闭环。