IRC

IRC は、従来型のチャンネル（#room）やダイレクトメッセージで OpenClaw を使用したい場合に利用します。 公式 IRC Plugin をインストールし、channels.irc 配下で設定します。

クイックスタート

1. Plugin をインストールします。

openclaw plugins install @openclaw/irc

2. ~/.openclaw/openclaw.json で、少なくともホスト、ニックネーム、参加するチャンネルを設定します。

{  channels: {    irc: {      enabled: true,      host: "irc.example.com",      port: 6697,      tls: true,      nick: "openclaw-bot",      channels: ["#openclaw"],    },  },}

3. Gateway を起動または再起動します。

openclaw gateway run

ボットの連携にはプライベート IRC サーバーを推奨します。意図的にパブリック IRC ネットワークを使用する場合、一般的な選択肢には Libera.Chat、OFTC、Snoonet があります。ボットやスウォームのバックチャンネルトラフィックには、推測されやすいパブリックチャンネルを使用しないでください。

受信の耐久性

OpenClaw は、受理した各 IRC PRIVMSG を、通常のポリシーチェックとエージェントへのディスパッチより前に、永続的な受信キューへ書き込みます。保留中または再試行可能なメッセージは Gateway の再起動後も保持され、チャンネルまたはダイレクトメッセージの相手ごとに直列化された状態を維持します。

IRC は、再生可能な配信 ID を提供せず、切断中のクライアントが受信できなかったメッセージを再送しません。そのため OpenClaw は、現在の TCP 接続内でのみ安定するローカル ID を割り当てます。キューが保護するのは、ローカルでの受理からディスパッチまでの区間です。OpenClaw に到達しなかったメッセージを復元したり、接続をまたいでサーバーによる再送を重複排除したりすることはできません。

接続設定

セキュリティのデフォルト

• IRC は、OpenClaw のオペレーターが管理するフォワードプロキシのルーティング外で、生の TCP/TLS ソケットを使用します。すべての外向き通信をそのフォワードプロキシ経由にする必要があるデプロイでは、IRC への直接の外向き通信が明示的に承認されていない限り、channels.irc.enabled=false を設定してください。
• channels.irc.dmPolicy のデフォルトは "pairing" です。不明な DM 送信者にはペアリングコードが送られ、openclaw pairing approve irc <code> で承認します。
• channels.irc.groupPolicy のデフォルトは "allowlist" です。
• groupPolicy="allowlist" を使用する場合、許可するチャンネルを定義するために channels.irc.groups を設定します。
• 平文転送を意図的に受け入れる場合を除き、TLS（channels.irc.tls=true）を使用してください。

アクセス制御

IRC チャンネルには、次の 2 つの独立した「ゲート」があります。

1. チャンネルアクセス（groupPolicy + groups）：ボットがそのチャンネルからのメッセージを受け付けるかどうか。
2. 送信者アクセス（groupAllowFrom / チャンネルごとの groups["#channel"].allowFrom）：そのチャンネル内でボットを起動できるユーザー。

設定キー：

• DM 許可リスト（DM 送信者アクセス）：channels.irc.allowFrom
• グループ送信者許可リスト（チャンネル送信者アクセス）：channels.irc.groupAllowFrom
• チャンネルごとの制御（チャンネル、送信者、メンションルール）：channels.irc.groups["#channel"]。設定項目は requireMention、allowFrom、enabled、tools、toolsBySender、skills、systemPrompt
• channels.irc.groupPolicy="open" は未設定のチャンネルを許可します（デフォルトでは引き続きメンションが必要です）

許可リストのエントリには、安定した送信者 ID（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 を設定する

例（#openclaw 内の全員がボットと会話できるようにする）：

{  channels: {    irc: {      groupPolicy: "allowlist",      groups: {        "#openclaw": { allowFrom: ["*"] },      },    },  },}

返信のトリガー（メンション）

チャンネルが（groupPolicy + groups により）許可され、送信者も許可されていても、OpenClaw はグループコンテキストではデフォルトで メンションゲート を適用します。接続中のボットのニックネームがメッセージに含まれる場合、または設定済みのメンションパターンに一致する場合、ボットへのメンションとして扱われます。

そのため、メッセージにボットと一致するメンションパターンが含まれていないと、drop channel … (missing-mention) のようなログが表示されることがあります。

IRC チャンネルでボットが メンションなしで 返信するようにするには、そのチャンネルのメンションゲートを無効にします。

{  channels: {    irc: {      groupPolicy: "allowlist",      groups: {        "#openclaw": {          requireMention: false,          allowFrom: ["*"],        },      },    },  },}

または、（チャンネルごとの許可リストを使用せずに）すべての IRC チャンネルを許可し、引き続きメンションなしで返信するには、次のように設定します。

{  channels: {    irc: {      groupPolicy: "open",      groups: {        "*": { requireMention: false, allowFrom: ["*"] },      },    },  },}

セキュリティ上の注意（パブリックチャンネルで推奨）

パブリックチャンネルで allowFrom: ["*"] を許可すると、誰でもボットにプロンプトを送信できます。 リスクを軽減するため、そのチャンネルで使用できるツールを制限してください。

チャンネル内の全員に同じツールを適用する

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

送信者ごとに異なるツールを適用する（所有者にはより強い権限を付与）

toolsBySender を使用して、"*" にはより厳格なポリシーを、自分のニックネームにはより緩やかなポリシーを適用します。

{  channels: {    irc: {      groups: {        "#openclaw": {          allowFrom: ["*"],          toolsBySender: {            "*": {              deny: ["group:runtime", "group:fs", "gateway", "nodes", "cron", "browser"],            },            "id:alice": {              deny: ["gateway", "nodes", "cron"],            },          },        },      },    },  },}

注記：

• toolsBySender のキーには、明示的なプレフィックス（channel:、id:、e164:、username:、name:）を使用してください。IRC では、送信者 ID の値とともに id: を使用します。より強い照合には id:alice または id:alice!~alice@203.0.113.7 を使用します。
• 従来のプレフィックスなしキーも引き続き受け付けられますが、id: としてのみ照合され、非推奨警告が出力されます。
• 最初に一致した送信者ポリシーが適用されます。"*" はワイルドカードのフォールバックです。

グループアクセスとメンションゲートの詳細、およびそれらの相互作用については、/channels/groups を参照してください。

NickServ

接続後に NickServ で識別するには、次のように設定します。

{  channels: {    irc: {      nickserv: {        enabled: true,        service: "NickServ",        password: "your-nickserv-password",      },    },  },}

パスワードが設定されている場合、NickServ の識別はデフォルトで常に実行されます（オプトアウトする場合にのみ enabled を false にする必要があります）。service のデフォルトは NickServ です。passwordFile は、インラインの password に代わる設定です。

接続時に任意で一度だけ登録する場合（register: true には registerEmail が必要です）：

{  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

IRC_HOST はワークスペースの .env から設定できません。ワークスペースの .env ファイルを参照してください。

トラブルシューティング

• ボットが接続してもチャンネルでまったく返信しない場合は、channels.irc.groups と、メンションゲートによってメッセージが破棄されていないか（missing-mention）を確認してください。メンションなしで返信させる場合は、そのチャンネルに requireMention:false を設定します。
• ログインに失敗する場合は、ニックネームが使用可能であることとサーバーパスワードを確認してください。
• カスタムネットワークで TLS に失敗する場合は、ホスト、ポート、証明書の設定を確認してください。

関連項目

• チャンネルの概要 — サポートされているすべてのチャンネル
• ペアリング — DM の認証とペアリングの流れ
• グループ — グループチャットの動作とメンションゲート
• チャンネルルーティング — メッセージのセッションルーティング
• セキュリティ — アクセスモデルと強化策