跳转到主要内容

​
IRC

当您需要在经典频道（#room）和直接消息中使用 OpenClaw 时，请使用 IRC。 IRC 作为扩展插件提供，但在 channels.irc 下的主配置文件中进行配置。

​
快速开始

  1. 在 ~/.openclaw/openclaw.json 中启用 IRC 配置。
  2. 至少设置：
{
  channels: {
    irc: {
      enabled: true,
      host: "irc.libera.chat",
      port: 6697,
      tls: true,
      nick: "openclaw-bot",
      channels: ["#openclaw"],
    },
  },
}
  1. 启动/重启网关：
openclaw gateway run

​
安全默认值

  • channels.irc.dmPolicy 默认为 "pairing"。
  • channels.irc.groupPolicy 默认为 "allowlist"。
  • 使用 groupPolicy="allowlist" 时，设置 channels.irc.groups 以定义允许的频道。
  • 使用 TLS (channels.irc.tls=true)，除非您有意接受明文传输。

​
访问控制

IRC 频道有两个独立的“入口”：
  1. 频道访问权限 (groupPolicy + groups)：机器人是否接受来自频道的消息。
  2. 发送者访问权限 (groupAllowFrom / 每个频道的 groups["#channel"].allowFrom)：谁被允许在该频道内触发机器人。
配置键：
  • 私信 允许列表（私信 发送者访问权限）：channels.irc.allowFrom
  • 群组发送者允许列表（频道发送者访问权限）：channels.irc.groupAllowFrom
  • 每个频道的控制（频道 + 发送者 + 提及规则）：channels.irc.groups["#channel"]
  • channels.irc.groupPolicy="open" 允许未配置的频道（默认仍受提及限制）
允许列表条目应使用稳定的发送者身份（nick!user@host）。 简单的昵称匹配是可变的，仅在 channels.irc.dangerouslyAllowNameMatching: true 时启用。

​
常见陷阱：allowFrom 适用于 DM，而非频道

如果您看到如下日志：
  • irc: drop group sender alice!ident@host (policy=allowlist)
……这意味着该发送者未被允许发送 群组/频道 消息。请通过以下方式之一修复：
  • 设置 channels.irc.groupAllowFrom（所有频道的全局设置），或
  • 设置每个频道的发送者允许列表：channels.irc.groups["#channel"].allowFrom
示例（允许 #tuirc-dev 中的任何人 与机器人对话）： 
{
  channels: {
    irc: {
      groupPolicy: "allowlist",
      groups: {
        "#tuirc-dev": { allowFrom: ["*"] },
      },
    },
  },
}

​
回复触发 (提及)

即使频道被允许（通过 groupPolicy + groups）且发送者也被允许，OpenClaw 在群组上下文中默认为 提及门控（mention-gating）。 这意味着您可能会看到类似 drop channel … (missing-mention) 的日志，除非消息包含匹配机器人的提及模式。 若要使机器人在 IRC 频道中回复而无需提及，请为该频道禁用提及限制： 
{
  channels: {
    irc: {
      groupPolicy: "allowlist",
      groups: {
        "#tuirc-dev": {
          requireMention: false,
          allowFrom: ["*"],
        },
      },
    },
  },
}
或者允许所有 IRC 频道（无针对每个频道的允许列表）并且仍然无需提及即可回复： 
{
  channels: {
    irc: {
      groupPolicy: "open",
      groups: {
        "*": { requireMention: false, allowFrom: ["*"] },
      },
    },
  },
}

​
安全说明（推荐用于公共频道）

如果您在公共频道中允许 allowFrom: ["*"]，任何人都可以提示机器人。 为了降低风险，请限制该频道的工具。

​
频道内所有人使用相同的工具

{
  channels: {
    irc: {
      groups: {
        "#tuirc-dev": {
          allowFrom: ["*"],
          tools: {
            deny: ["group:runtime", "group:fs", "gateway", "nodes", "cron", "browser"],
          },
        },
      },
    },
  },
}

​
根据发送者使用不同的工具（所有者获得更多权限）

使用 toolsBySender 对 "*" 应用更严格的策略，并对您的昵称应用较宽松的策略： 
{
  channels: {
    irc: {
      groups: {
        "#tuirc-dev": {
          allowFrom: ["*"],
          toolsBySender: {
            "*": {
              deny: ["group:runtime", "group:fs", "gateway", "nodes", "cron", "browser"],
            },
            "id:eigen": {
              deny: ["gateway", "nodes", "cron"],
            },
          },
        },
      },
    },
  },
}
注意：
  • toolsBySender 键应使用 id: 作为 IRC 发送者标识值： 使用 id:eigen 或 id:eigen!~eigen@174.127.248.171 以进行更强的匹配。
  • 旧的无前缀键仍被接受，并仅作为 id: 进行匹配。
  • 第一个匹配的发送者策略优先；"*" 是通配符后备选项。
有关组访问与提及门控（以及它们如何交互）的更多信息，请参阅：/channels/groups。

​
NickServ

要在连接后使用 NickServ 进行身份验证： 
{
  channels: {
    irc: {
      nickserv: {
        enabled: true,
        service: "NickServ",
        password: "your-nickserv-password",
      },
    },
  },
}
连接时可选的一次性注册： 
{
  channels: {
    irc: {
      nickserv: {
        register: true,
        registerEmail: "bot@example.com",
      },
    },
  },
}
在昵称注册后禁用 register，以避免重复的 REGISTER 尝试。

​
环境变量

默认帐户支持：
  • IRC_HOST
  • IRC_PORT
  • IRC_TLS
  • IRC_NICK
  • IRC_USERNAME
  • IRC_REALNAME
  • IRC_PASSWORD
  • IRC_CHANNELS (逗号分隔)
  • IRC_NICKSERV_PASSWORD
  • IRC_NICKSERV_REGISTER_EMAIL

​
故障排除

  • 如果机器人已连接但从未在渠道中回复，请验证 channels.irc.groups 以及提及门控是否正在丢弃消息 (missing-mention)。如果您希望它在没有 ping 的情况下回复，请为该渠道设置 requireMention:false。
  • 如果登录失败，请验证昵称可用性和服务器密码。
  • 如果在自定义网络上 TLS 失败，请验证主机/端口和证书设置。
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。
Last modified on March 27, 2026