教程

OpenClaw 接入 IRC:让 AI 助手进驻经典 IRC 聊天室完全指南

OpenClaw 接入 IRC(Internet Relay Chat)的完整配置教程:IRC 渠道的内置支持(无需插件)、服务器连接配置(host/port/nickname/channels)、TLS 加密连接、NickServ 认证(密码/SASL)、频道加入与白名单控制、私信配对(DM pairing)、群组消息与 @ 提及配置、IRC 与现代聊天工具的融合使用场景,以及常见 IRC 服务器(Libera.Chat/OFTC/Freenode替代)的连接示例。

2026/3/223分钟 阅读ClaudeEagle

IRC(Internet Relay Chat)诞生于 1988 年,至今仍是开源社区、安全研究者 和技术极客的重要交流平台。OpenClaw 内置 IRC 支持,无需额外插件。

IRC 支持的特点

内置支持(无需插件) 支持:频道消息、私信(DM)、TLS 加密连接 认证:NickServ 密码认证 + SASL 访问控制:频道白名单 + DM 配对

基础配置

json
{
  "channels": {
    "irc": {
      "enabled": true,
      "host": "irc.libera.chat",
      "port": 6697,
      "tls": true,
      "nickname": "openclaw-bot",
      "username": "openclaw",
      "realname": "OpenClaw AI Assistant",
      "channels": ["#my-channel", "#project-help"]
    }
  }
}

TLS 加密连接

现代 IRC 服务器推荐使用 TLS(端口 6697):

json
{
  "channels": {
    "irc": {
      "host": "irc.libera.chat",
      "port": 6697,
      "tls": true,
      "tlsVerify": true
    }
  }
}

对于使用自签名证书的私有 IRC 服务器:

json
{
  "tls": true,
  "tlsVerify": false
}

NickServ 认证

大多数公共 IRC 服务器需要注册昵称:

json
{
  "channels": {
    "irc": {
      "nickname": "openclaw-bot",
      "nickservPassword": "your-registered-password"
    }
  }
}

SASL 认证(更安全,推荐):

json
{
  "channels": {
    "irc": {
      "sasl": {
        "mechanism": "PLAIN",
        "username": "openclaw-bot",
        "password": "your-sasl-password"
      }
    }
  }
}

频道与访问控制

加入频道并设置白名单

json
{
  "channels": {
    "irc": {
      "channels": ["#openclaw-test", "#project"],
      "groups": {
        "#openclaw-test": {
          "requireMention": false,
          "allowedNicks": ["alice", "bob", "charlie"]
        },
        "#project": {
          "requireMention": true
        }
      }
    }
  }
}
  • requireMention: false:频道内任何消息都会触发 AI
  • requireMention: true:需要 openclaw-bot: 你的问题 格式才触发
  • allowedNicks:只有这些昵称的用户能触发 AI 回复

私信(DM)配对

json
{
  "channels": {
    "irc": {
      "dmPolicy": "pairing"
    }
  }
}
  • "pairing":用户第一次私信需要完成配对确认
  • "allowlist":只有 allowedNicks 中的用户可以私信
  • "open":任何人都可以私信

主流 IRC 服务器连接示例

Libera.Chat(开源社区)

json
{
  "host": "irc.libera.chat",
  "port": 6697,
  "tls": true,
  "sasl": { "mechanism": "PLAIN", "username": "your-nick", "password": "your-pass" }
}

OFTC(Debian/开源项目)

json
{
  "host": "irc.oftc.net",
  "port": 6697,
  "tls": true
}

私有企业 IRC 服务器

json
{
  "host": "irc.company.internal",
  "port": 6697,
  "tls": true,
  "tlsVerify": false,
  "channels": ["#general", "#engineering", "#ops"]
}

IRC 使用场景

开源项目支持频道

用户在 #project-help 提问 openclaw-bot(仅被 @ 时回复): "根据文档,这个问题的解决方法是..."

内部运维频道

监控告警发到 #ops openclaw-bot 自动分析告警内容并给出排查建议

开发者个人助手

在私信中: 你:帮我解释这个 Git 错误 Bot:这个错误意味着...

常见问题

Q:Bot 加入频道后没有响应? 检查:

  1. 是否需要频道 op 才能发言(/mode #channel +v openclaw-bot
  2. requireMention 是否设为 true(需要 bot: 内容
  3. allowedNicks 白名单是否包含你的昵称

Q:连接后频繁断开? IRC 服务器通常有连接限制,添加 reconnect: true 配置自动重连:

json
{ "reconnect": true, "reconnectDelay": 5000 }

来源:OpenClaw 官方文档 - docs.openclaw.ai/channels/irc

相关文章推荐

教程OpenClaw + Telegram 配置完全教程:5 分钟把 Claude 变成你的私人 Telegram 机器人OpenClaw 连接 Telegram 完整教程:BotFather 创建机器人、获取 Bot Token、OpenClaw 配置步骤、第一次对话测试、多用户权限控制、常见连接问题解决,以及 Telegram 频道和群组模式配置。2026/3/15教程OpenClaw 接入 Twitch:直播聊天室 AI Bot、IRC 协议配置与用户角色权限控制OpenClaw 接入 Twitch 完整教程:IRC 协议 Bot 账号配置、Token 生成步骤、两种访问控制(用户 ID 白名单 vs 角色权限 broadcaster/moderator/subscriber)、关闭 @提及要求、Token 自动刷新、多账号多频道管理,以及常见问题排查。2026/3/3教程OpenClaw 接入 IRC:经典聊天协议配置、访问控制与 NickServ 认证OpenClaw 接入 IRC 完整教程:快速配置(host/port/TLS/nick/channels)、两道访问控制(频道 Gate + 发言人 Gate)、@提及触发控制、按用户分级的工具权限、NickServ 自动认证,以及常见问题排查。2026/3/3教程OpenClaw Telegram Bot 完整配置指南:访问控制、群组管理与高级选项OpenClaw Telegram Bot 完整配置指南,涵盖 Bot Token 获取、访问控制策略(pairing/allowlist/open)、群组管理、@提及配置、Webhook 模式、代理设置和内联按钮等高级选项,附详细 JSON 配置示例。2026/2/27教程OpenClaw Standing Orders 完全指南:让 AI 记住你的长期规则和行为偏好OpenClaw Standing Orders(常驻指令)功能完整教程:Standing Orders 与 SOUL.md 的区别(动态运行时规则 vs 静态人格文件)、通过对话动态添加/查看/删除常驻指令、指令的持久化存储与跨会话生效机制、适合写入 Standing Orders 的内容类型(格式偏好/禁止行为/固定工作流)、与 Hooks 的协同使用、按渠道/Agent 设置不同的 Standing Orders,以及常驻指令的最佳实践(写清晰的规则、避免矛盾冲突、定期清理过时规则)。2026/3/26教程OpenClaw 多媒体处理完全指南:图片识别、音频转写与视频理解实战OpenClaw 多媒体处理(Media)完整教程:发送图片给 AI 进行视觉分析(OCR/物体识别/图表解读/代码截图)、音频消息自动转写为文字(Whisper/系统STT)、视频消息关键帧提取与理解、Node 摄像头实时拍照触发分析、媒体消息的渠道支持差异(各渠道的图片/音频/视频支持情况对比)、大文件处理策略(分割/压缩/超时设置)、媒体消息在不同 AI 模型上的能力对比(Claude Vision/GPT-4V/Gemini Pro Vision),以及本地媒体文件分析(read 工具读取图片路径)。2026/3/25