IRC

IRC适配器可将Hermes与任意IRC服务器相连，实现IRC频道（或私信）与智能体之间的消息传递。它通过Python标准库中的asyncio来实现IRC协议通信——无需任何外部依赖、无需SDK，也不需要后台进程。该适配器既支持Libera.Chat等公共网络，也适用于任何自托管的ircd服务器。

IRC为纯文本格式：不支持语音、图片、文件、主题讨论、表情反应、输入状态显示或流媒体功能——回复以PRIVMSG消息形式发送，过长内容则会按IRC消息行长度限制进行拆分。

运行hermes gateway setup命令并选择IRC选项，即可获得逐步指导。

先决条件

一个可连接的IRC服务器（例如irc.libera.chat）
一个要加入的频道（例如#hermes）——如需同时加入多个频道，请用逗号分隔
机器人的昵称（默认为hermes-bot）
可选：如果您的网络要求身份验证，则需要已注册的昵称及NickServ密码

配置Hermes

您可以通过两种方式配置IRC功能：通过环境变量进行快速设置，或是在~/.hermes/config.yaml文件中使用gateway块进行配置。

方式A — config.yaml配置

gateway:
  platforms:
    irc:
      enabled: true
      extra:
        server: irc.libera.chat
        port: 6697
        nickname: hermes-bot
        channel: "#hermes"
        use_tls: true
        server_password: ""       # optional server password
        nickserv_password: ""     # optional NickServ identification
        allowed_users: []         # empty = allow all, or list of nicks
        max_message_length: 450   # IRC line limit (safe default)

方案 B — 环境变量

变量	是否必填	说明
`IRC_SERVER`	✅	IRC 服务器主机名（例如 `irc.libera.chat`）
`IRC_CHANNEL`	✅	需要加入的频道——多个频道用逗号分隔
`IRC_NICKNAME`	✅	机器人昵称（默认为 `hermes-bot`）
`IRC_PORT`	—	服务器端口（使用 TLS 时默认为 `6697`，不使用 TLS 时为 `6667`）
`IRC_USE_TLS`	—	是否使用 TLS（`true`/`false`；在端口 `6697` 上默认为 `true`）
`IRC_SERVER_PASSWORD`	—	用于 `PASS` 命令的服务器密码
`IRC_NICKSERV_PASSWORD`	—	连接时自动进行 IDENTIFY 操作所需的 NickServ 密码
`IRC_ALLOWED_USERS`	—	允许与机器人对话的昵称，以逗号分隔
`IRC_ALLOW_ALL_USERS`	—	允许频道内的任何人都能与机器人对话（仅开发人员使用）
`IRC_HOME_CHANNEL`	—	用于定时任务/通知发送的频道（默认值为 `IRC_CHANNEL`）

访问控制

默认情况下，只有列在 allowed_users（或 IRC_ALLOWED_USERS）中的昵称才能与机器人对话。若将列表留空并同时设置 IRC_ALLOW_ALL_USERS=true，则允许频道内的任何人都能与 Hermes 对话——这有助于测试，但由于除非网络环境支持 NickServ，否则 IRC 昵称无法经过身份验证，因此不推荐在公共网络上使用此设置。

如果你的网络会对昵称进行注册，请设置 IRC_NICKSERV_PASSWORD（或 nickserv_password），这样机器人连接时就能向 NickServ 报告身份，并保持其已注册的昵称。

频道对话与私信对话

加入的频道中的消息被视为群组对话。
发送给该机器人的私信则被视为直接消息。

定时任务和通知会被发送到主频道——如果已设置 IRC_HOME_CHANNEL，则发送至该频道；否则发送至第一个 IRC_CHANNEL。

启动网关

hermes gateway start

可使用 hermes gateway status 命令查看状态——该命令会显示 IRC 连接状况，包括仅使用环境配置的场景。

备注

为避免超出 IRC 消息长度限制（扣除协议开销后的默认最大值为 450 字节），过长的代理回复会自动拆分为多条 PRIVMSG 消息。
该适配器会为每个服务器加昵称组合获取独立的凭证锁，因此不同的 Hermes 配置文件不会争夺同一个 IRC 账号。

Keyboard shortcuts

Hermes Agent Docs i18n