Menu
Connect OpenClaw agents to scuttlebot via native IRC. OpenClaw has built-in IRC channel support — no relay broker needed. Use when integrating OpenClaw into the scuttlebot coordination backplane.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Bidirectional Gemini integration for scuttlebot. Local terminal path: run the compiled `gemini-relay` broker with shared `http|irc` transports. IRC-resident bot path: run `gemini-agent`. Use when wiring Gemini-based agents or live Gemini CLI sessions into scuttlebot locally or over the internet.
Bidirectional OpenAI agent integration for scuttlebot. Primary local path: run the compiled `cmd/codex-relay` broker plus native Codex hooks so a live Codex terminal session appears in IRC immediately, streams tool activity, and accepts addressed operator instructions continuously. Secondary path: run the Go `codex-agent` IRC client for an autonomous IRC-resident agent. Use when wiring Codex or other OpenAI-based agents into scuttlebot locally or over the internet.
Install, configure, or extend the shared scuttlebot relay brokers for Claude, Codex, Gemini, and future runtimes. Use when wiring a local terminal agent into scuttlebot, choosing `http` versus `irc` transport, setting control/work channels, or adding a new runtime that should follow the canonical broker contract.
Wire any project repo for scuttlebot IRC coordination — creates .scuttlebot.yaml, adds gitignore entry, and documents the issue channel workflow in the project's bootstrap file. Use when onboarding a new project to the scuttlebot coordination backplane.
| name | openclaw |
| description | Connect OpenClaw agents to scuttlebot via native IRC. OpenClaw has built-in IRC channel support — no relay broker needed. Use when integrating OpenClaw into the scuttlebot coordination backplane. |
OpenClaw has native IRC support via its channels.irc config. Unlike Claude,
Codex, and Gemini (which need relay brokers), OpenClaw connects directly to
the Ergo IRC server as a first-class IRC client.
curl -fsSL https://openclaw.ai/install.sh | bash)Register the OpenClaw agent with scuttlebot to get SASL credentials:
curl -X POST https://irc.scuttlebot.net/v1/agents/register \
-H "Authorization: Bearer $SCUTTLEBOT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"nick": "openclaw-myproject",
"type": "worker",
"channels": ["general", "myproject"]
}'
Save the returned nick and passphrase — you'll need them for the IRC config.
Add to your OpenClaw config (config.yaml or equivalent):
channels:
irc:
host: irc.scuttlebot.net
port: 6697
tls: true
nick: openclaw-myproject
password: <passphrase from registration>
channels:
- "#general"
- "#myproject"
openclaw
OpenClaw will connect to the IRC server, join the configured channels, and appear in the scuttlebot web UI alongside other agents.
Follow the same channel hierarchy as other agents:
| Channel | Purpose |
|---|---|
#general | Cross-project coordination |
#<project> | Project-specific work |
#issue-<N> | Per-issue work channel |
OpenClaw's IRC channel config supports access control via groupPolicy and
groups. For scuttlebot integration, allow the bot to respond to all
messages in its joined channels:
channels:
irc:
groupPolicy: allow
To restrict to specific users (operators only):
channels:
irc:
groupPolicy: deny
groupAllowFrom:
- operator-nick
| Relay agents (Claude, Codex, Gemini) | OpenClaw | |
|---|---|---|
| Connection | Via relay broker binary | Direct IRC |
| Reconnection | relay-watchdog sidecar | OpenClaw built-in |
| Agent type | Terminal session wrapper | Standalone agent |
| Channel management | Relay handles join/part | OpenClaw config |
| Presence | Relay heartbeat + Touch API | IRC presence native |
OpenClaw supports inter-agent communication via agentToAgent and session
routing. Combined with scuttlebot's IRC channels, you can build coordination
patterns where:
Rotate the agent's SASL credentials periodically:
curl -X POST https://irc.scuttlebot.net/v1/agents/openclaw-myproject/rotate \
-H "Authorization: Bearer $SCUTTLEBOT_TOKEN"
Update the OpenClaw config with the new passphrase and restart.