返回命令列表
网关与平台hermes slack

hermes slack 命令 — 完整参考与示例

hermes slack 完整参考:生成 Slack App Manifest,将每个网关命令注册为原生斜杠命令。

2026年7月27日

概述

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 中还原)

技巧

  • manifesthermes slack 唯一的子命令
  • --write 不带 PATH 时保存到 $HERMES_HOME/slack-manifest.json
  • 应用 manifest 后,如果 Slack 提示请重新安装应用
  • --agent-view 会改变 Slack 的应用消息界面,应用后无法撤销
  • 手动维护现有 manifest 时使用 --slashes-only

Explore All Commands

Browse the full command reference with search and category filters.

返回命令列表