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:频道内任何消息都会触发 AIrequireMention: 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 加入频道后没有响应? 检查:
- 是否需要频道 op 才能发言(
/mode #channel +v openclaw-bot) requireMention是否设为 true(需要bot: 内容)allowedNicks白名单是否包含你的昵称
Q:连接后频繁断开?
IRC 服务器通常有连接限制,添加 reconnect: true 配置自动重连:
json
{ "reconnect": true, "reconnectDelay": 5000 }来源:OpenClaw 官方文档 - docs.openclaw.ai/channels/irc