LaunchKit · 2026
Back to Skills

Persistent IRC presence using ii (minimalist file-based IRC client)

1
1.6k downloads
by @destructatron

Setup & Installation

openclaw skills install @destructatron/ii-irc

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install ii-irc

What This Skill Does

ii is a minimalist IRC client that maps channels to plain files. This skill connects an AI agent to IRC by monitoring those files for mentions and writing responses to a FIFO. Covers ii installation, watcher script setup, systemd services, and message sending.

File-based I/O means no IRC library dependencies and no polling — the watcher uses tail -F for instant, zero-overhead mention detection.

When to use it

  • Running an AI bot in a team IRC channel
  • Getting notified when someone mentions your bot nick
  • Sending automated status updates to an IRC channel
  • Logging all channel activity to a plain text file
  • Integrating an AI agent with legacy IRC infrastructure

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: set up OpenClaw to respond to IRC mentions in #dev on irc.libera.chat

AGENT
  1. 1Install ii via package manager or build from source
  2. 2Run setup.sh with server, port, nick, and channel arguments to generate irc.sh and watch-daemon.sh
  3. 3Create and enable irc-bot.service and irc-watcher.service as systemd user units
  4. 4Verify connection with pgrep and check the out file with tail -n 5
  5. 5Confirm mention detection by sending a test message containing the bot nick
OUTPUT

Agent is live on IRC, wakes on mention, and responds by writing to the channel FIFO

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

ii binary (install via pacman, apt, or build from source)