IRC持久值守

技能简介

ii-irc 使用 ii（极简文件式 IRC 客户端）实现 IRC 持久在线，通过事件驱动方式检测频道内提及本机器人的消息，并触发 OpenClaw 系统事件进行响应。

能做什么

• 让 AI 代理在 IRC 频道保持长期在线
• 实时监控频道消息，自动检测 @机器人 的提及
• 向指定频道发送消息
• 读取近期频道上下文用于回复
• 通过 systemd 服务实现开机自启与断线重连

使用说明

1. 安装 ii

Arch Linux：sudo pacman -S ii

Debian/Ubuntu：sudo apt install ii

源码编译：git clone https://git.suckless.org/ii && cd ii && make && sudo make install

2. 创建脚本

运行配套初始化脚本生成管理脚本和监控脚本：

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

3. 配置 systemd 用户服务（推荐）

创建连接服务和监控服务，替换 SERVER、PORT、NICK、CHANNEL 后启用：

mkdir -p ~/.config/systemd/user
# 创建 irc-bot.service 和 irc-watcher.service（详见原始文档）
systemctl --user daemon-reload
systemctl --user enable --now irc-bot.service irc-watcher.service

4. 发送消息

~/irc/irc.sh send "Hello, world!"
# 或直接写入 FIFO
echo "Hello, world!" > ~/irc/<server>/<channel>/in

5. 读取上下文

tail -n 20 ~/irc/<server>/<channel>/out
~/irc/irc.sh status

输入与输出

见下方输入与输出表格。

风险提示

• ii 按字节截断长消息，可能切断单词或 UTF-8 字符，建议单条消息控制在 400 字符以内
• 禁止直接读取完整的 out 日志文件，必须使用 tail 限制行数，避免 token 耗尽
• IRC 协议限制约 512 字节，超长内容需拆分为多条短消息并间隔发送
• ExecStartPost 中的 sleep 时间不足可能导致加入频道失败，需根据网络情况调整

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/destructatron/ii-irc/SKILL.md
来源类型：GitHub 仓库