IRC

IRC は、OpenClaw をクラシックなチャンネル（#room）とダイレクトメッセージで使いたい場合に使用します。 公式 IRC Plugin をインストールし、channels.irc で設定します。

クイックスタート

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

openclaw plugins install @openclaw/irc

2. ~/.openclaw/openclaw.json で IRC 設定を有効にします。
3. 少なくとも次を設定します。

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

ボットの連携には、プライベート IRC サーバーを優先してください。意図的に公開 IRC ネットワークを使う場合、一般的な選択肢には Libera.Chat、OFTC、Snoonet があります。ボットやスウォームのバックチャンネル通信には、予測しやすい公開チャンネルを避けてください。

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

openclaw gateway run

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

• IRC は、OpenClaw のオペレーター管理フォワードプロキシルーティングの外側で、生の TCP/TLS ソケットを使用します。すべての送信トラフィックをそのフォワードプロキシ経由にする必要があるデプロイでは、直接 IRC 送信が明示的に承認されていない限り、channels.irc.enabled=false を設定してください。
• channels.irc.dmPolicy のデフォルトは "pairing" です。
• 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"]
• channels.irc.groupPolicy="open" は未設定のチャンネルを許可します（それでもデフォルトではメンションゲートがあります）

許可リストのエントリには、安定した送信者 ID（nick!user@host）を使用してください。 ベアな nick マッチングは変更可能であり、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 はグループコンテキストでデフォルトで メンションゲート を使用します。

つまり、メッセージにボットに一致するメンションパターンが含まれていない限り、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 を使用して、"*" にはより厳しいポリシーを、自分の nick にはより緩いポリシーを適用します。

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

注:

• toolsBySender のキーでは、IRC 送信者 ID 値に id: を使用してください。 より強いマッチングには 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",      },    },  },}

nick が登録された後は、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）を確認してください。ping なしで応答させたい場合は、そのチャンネルに requireMention:false を設定します。
• ログインに失敗する場合は、nick の空き状況とサーバーパスワードを確認してください。
• カスタムネットワークで TLS が失敗する場合は、ホスト/ポートと証明書の設定を確認してください。

関連

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