概述
hermes slack 提供 Hermes 的 Slack 集成辅助功能。它只有一个子命令 manifest,用于输出或写入 Slack App Manifest,其中每个网关命令都被注册为原生斜杠命令(/btw、/stop、/model 等)。将生成的 manifest 粘贴到 Slack 应用配置中,即可将你的工作区连接到 Hermes 网关。
hermes slack manifest
子命令
manifest
生成一个 Slack App Manifest,将命令注册表中的每个网关命令注册为一级 Slack 斜杠命令。将输出粘贴到 Slack 应用配置 → 功能 → App Manifest → 编辑,然后保存。如果 Slack 提示,请重新安装应用。
| 选项 | 说明 |
|---|---|
--write [PATH] |
将 manifest 写入文件而不是输出到标准输出。不指定 PATH 时,写入 $HERMES_HOME/slack-manifest.json |
--name NAME |
机器人显示名称(默认:Hermes) |
--description DESCRIPTION |
Slack 应用目录中显示的机器人描述 |
--long-description TEXT |
设置 Slack 的长应用描述(175–4,000 个字符) |
--long-description-file PATH |
从 UTF-8 文本文件读取长应用描述(175–4,000 个字符) |
--slashes-only |
仅输出 features.slash_commands 数组(用于手动合并到现有 manifest) |
--no-assistant |
省略 Slack AI Assistant 模式;私聊将渲染为扁平聊天,裸斜杠命令(/help、/new)可直接内联使用 |
--agent-view |
输出 Slack 的 Agent 消息体验,替代旧的 assistant_view;应用 manifest 后无法在 Slack 中撤销 |
常见场景
首次设置
hermes slack manifest
# 向标准输出输出完整的 manifest.json
# 1. 打开 https://api.slack.com/apps
# 2. 创建新应用 → 从 manifest 创建
# 3. 粘贴生成的 manifest
# 4. 将应用安装到你的工作区
保存到文件
hermes slack manifest --write
# 写入 $HERMES_HOME/slack-manifest.json
hermes slack manifest --write ./slack-manifest.json
# 或写入自定义路径
自定义机器人
hermes slack manifest --name "Hermes Bot" --description "通过 Hermes 网关中继的 AI 助手"
合并到现有 manifest
hermes slack manifest --slashes-only
# 仅输出 slash_commands 数组,供手动合并
选择消息体验
hermes slack manifest --agent-view
# 使用 Slack 的 Agent 消息体验(之后无法在 Slack 中还原)
技巧
manifest是hermes slack唯一的子命令--write不带 PATH 时保存到$HERMES_HOME/slack-manifest.json- 应用 manifest 后,如果 Slack 提示请重新安装应用
--agent-view会改变 Slack 的应用消息界面,应用后无法撤销- 手动维护现有 manifest 时使用
--slashes-only