ii-IRC：面向 AI 代理的事件驱动型 IRC 客户端

ii 将所有频道活动写入纯文本文件。一个监听脚本持续监控消息中是否提及 Bot，并据此触发 OpenClaw 系统事件；Bot 的响应则通过向 FIFO 文件写入完成。

架构

~/irc/
├── irc.sh              # 管理脚本（启动/停止/状态查询/发送消息）
├── watch-daemon.sh     # 提及监听器 → 触发 openclaw 系统事件
└── /
    └── /
        ├── in          # FIFO 文件 — 向此写入可发送消息
        └── out         # 所有频道消息的仅追加日志

快速配置

1. 安装 ii

ii 已收录于多数包管理器中。Arch Linux 用户执行：pacman -S ii；Debian/Ubuntu 用户执行：apt install ii；也可从 suckless.org 源码构建。

2. 创建脚本

运行随附的配置脚本（将生成 ~/irc/irc.sh 和 ~/irc/watch-daemon.sh）：

bash scripts/setup.sh --server irc.example.org --port 6667 --nick MyBot --channel "#mychannel"

或手动创建 — 参见 scripts/irc.sh.template 和 scripts/watch-daemon.sh.template。

3. 创建 systemd 用户服务（推荐）

实现开机自动启动：

mkdir -p ~/.config/systemd/user

# IRC 连接服务
cat > ~/.config/systemd/user/irc-bot.service << 'EOF'
[Unit]
Description=IRC connection (ii)
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/bin/ii -s SERVER -p PORT -n NICK -i %h/irc
ExecStartPost=/bin/bash -c 'sleep 3 && echo "/j CHANNEL" > %h/irc/SERVER/in'
Restart=always
RestartSec=10

[Install]
WantedBy=default.target
EOF

# 提及监听服务
cat > ~/.config/systemd/user/irc-watcher.service << 'EOF'
[Unit]
Description=IRC mention watcher
After=irc-bot.service
Wants=irc-bot.service

[Service]
Type=simple
ExecStart=%h/irc/watch-daemon.sh
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
EOF

# 替换服务文件中的 SERVER、PORT、NICK、CHANNEL，然后执行：
systemctl --user daemon-reload
systemctl --user enable --now irc-bot.service irc-watcher.service

发送消息

# 通过管理脚本发送
~/irc/irc.sh send "Hello, world!"

# 或直接写入 FIFO
echo "Hello, world!" > ~/irc///in

重要提示：ii 在字节边界处截断长消息，可能导致单词或 UTF-8 字符被中途截断。请将单条消息控制在约 400 字符以内；如需发送更长内容，请拆分为多条消息，并在各条之间加入短暂延迟。

读取上下文

# 获取最近 N 条消息（对 token 使用高效）
tail -n 20 ~/irc///out

# 快速查看状态（最近 5 条消息）
~/irc/irc.sh status

切勿读取整个 out 文件 —— 其大小会无限增长。务必始终配合限制参数使用 tail。

提及检测原理

1. watch-daemon.sh 对频道的 out 文件运行 tail -F
2. 逐行检查新到达的消息（不区分大小写），判断是否包含 Bot 的昵称（nick）
3. 跳过 Bot 自己发送的消息，以及用户加入/离开频道的通知
4. 匹配成功时，执行：openclaw system event --text "IRC mention: " --mode now
5. OpenClaw 被唤醒后，可通过 in FIFO 发送响应

该机制为事件驱动型 —— 无轮询、响应即时、资源开销极低。

加入多个频道

ii 支持在同一服务器上加入多个频道。每增加一个频道，请执行：

echo "/j #other-channel" > ~/irc//in

若需监听多个频道，可选择：为每个频道单独运行一个监听器实例，或修改 watch-daemon.sh 以同时监控多个 out 文件。

故障排查

• 无法连接：确认 ii 正在运行（pgrep -f "ii -s"），并核对服务器地址与端口
• 未成功加入频道：确保 in FIFO 已存在；检查 ExecStartPost 中的延时是否足够（必要时增大 sleep 时间）
• 提及未触发响应：确认监听器正在运行（pgrep -f watch-daemon），并核实昵称拼写完全一致
• 消息异常截断：缩短消息长度；ii 遵循 IRC 协议限制，单条消息上限约为 512 字节
• 断线重连：由 systemd 的 Restart=always 自动处理；ii 在断连时退出，systemd 将立即重启它