IRC

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

เริ่มต้นอย่างรวดเร็ว

1. เปิดใช้งานคอนฟิก IRC ใน ~/.openclaw/openclaw.json
2. ตั้งค่าอย่างน้อย:

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

3. เริ่มหรือรีสตาร์ต Gateway:

openclaw gateway run

​

ค่าเริ่มต้นด้านความปลอดภัย

• IRC ใช้ซ็อกเก็ต TCP/TLS แบบดิบภายนอกการกำหนดเส้นทางผ่านพร็อกซีส่งต่อที่ผู้ปฏิบัติงาน OpenClaw จัดการ ในการปรับใช้ที่กำหนดให้ทราฟฟิกขาออกทั้งหมดผ่านพร็อกซีส่งต่อนั้น ให้ตั้ง channels.irc.enabled=false เว้นแต่การออกไปยัง IRC โดยตรงจะได้รับอนุมัติอย่างชัดเจน
• channels.irc.dmPolicy มีค่าเริ่มต้นเป็น "pairing"
• channels.irc.groupPolicy มีค่าเริ่มต้นเป็น "allowlist"
• เมื่อใช้ groupPolicy="allowlist" ให้ตั้ง channels.irc.groups เพื่อกำหนดช่องทางที่อนุญาต
• ใช้ TLS (channels.irc.tls=true) เว้นแต่คุณตั้งใจยอมรับการส่งข้อมูลแบบข้อความล้วน

​

การควบคุมการเข้าถึง

1. การเข้าถึงช่องทาง (groupPolicy + groups): บอตจะยอมรับข้อความจากช่องทางนั้นหรือไม่
2. การเข้าถึงของผู้ส่ง (groupAllowFrom / groups["#channel"].allowFrom ต่อช่องทาง): ใครได้รับอนุญาตให้เรียกใช้บอตภายในช่องทางนั้น

• รายการอนุญาต DM (การเข้าถึงของผู้ส่ง DM): channels.irc.allowFrom
• รายการอนุญาตผู้ส่งกลุ่ม (การเข้าถึงของผู้ส่งในช่องทาง): channels.irc.groupAllowFrom
• การควบคุมต่อช่องทาง (ช่องทาง + ผู้ส่ง + กฎการกล่าวถึง): channels.irc.groups["#channel"]
• channels.irc.groupPolicy="open" อนุญาตช่องทางที่ไม่ได้กำหนดค่าไว้ (ยังคงถูกควบคุมด้วยการกล่าวถึงตามค่าเริ่มต้น)

​

ข้อผิดพลาดที่พบบ่อย: allowFrom ใช้สำหรับ DM ไม่ใช่ช่องทาง

• irc: drop group sender alice!ident@host (policy=allowlist)

• ตั้ง channels.irc.groupAllowFrom (ใช้ร่วมกันสำหรับทุกช่องทาง) หรือ
• ตั้งรายการอนุญาตผู้ส่งต่อช่องทาง: channels.irc.groups["#channel"].allowFrom

{
  channels: {
    irc: {
      groupPolicy: "allowlist",
      groups: {
        "#tuirc-dev": { allowFrom: ["*"] },
      },
    },
  },
}

​

การเรียกให้ตอบกลับ (การกล่าวถึง)

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

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

​

หมายเหตุด้านความปลอดภัย (แนะนำสำหรับช่องทางสาธารณะ)

​

เครื่องมือเดียวกันสำหรับทุกคนในช่องทาง

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

​

เครื่องมือต่างกันตามผู้ส่ง (เจ้าของมีสิทธิ์มากกว่า)

{
  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: เท่านั้น
• นโยบายผู้ส่งที่ตรงกันรายการแรกจะถูกใช้ก่อน; "*" คือทางเลือกสำรองแบบไวลด์การ์ด

​

NickServ

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

{
  channels: {
    irc: {
      nickserv: {
        register: true,
        registerEmail: "bot@example.com",
      },
    },
  },
}

​

ตัวแปรสภาพแวดล้อม

• 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) หากต้องการให้ตอบกลับโดยไม่ต้องปิง ให้ตั้ง requireMention:false สำหรับช่องทางนั้น
• หากเข้าสู่ระบบล้มเหลว ให้ตรวจสอบว่าชื่อเล่นพร้อมใช้งานและรหัสผ่านเซิร์ฟเวอร์ถูกต้อง
• หาก TLS ล้มเหลวบนเครือข่ายแบบกำหนดเอง ให้ตรวจสอบโฮสต์/พอร์ตและการตั้งค่าใบรับรอง

​

ที่เกี่ยวข้อง

• ภาพรวมช่องทาง — ช่องทางทั้งหมดที่รองรับ
• การจับคู่ — การยืนยันตัวตนผ่าน DM และโฟลว์การจับคู่
• กลุ่ม — พฤติกรรมแชตกลุ่มและการบังคับกล่าวถึง
• การกำหนดเส้นทางช่องทาง — การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย — โมเดลการเข้าถึงและการเพิ่มความแข็งแกร่ง