OpenClaw Zulip Channel Plugin
Connect OpenClaw to Zulip — topic threading, metadata DB, bot commands, event queue processing.
Install (local path)
git clone https://github.com/kagura-agent/openclaw-zulip.git
Add to openclaw.json:
{
"plugins": {
"load": {
"paths": ["path/to/openclaw-zulip"]
},
"entries": {
"kagura-zulip": { "enabled": true }
}
}
}
Configure
Add Zulip channel config:
{
"channels": {
"zulip": {
"enabled": true,
"defaultAccount": "bot",
"accounts": {
"bot": {
"realm": "https://your-org.zulipchat.com",
"email": "your-bot@your-org.zulipchat.com",
"apiKey": "your-zulip-api-key"
}
}
}
}
}
Key features
- Topic threading: Maps Zulip topics to OpenClaw threads
- Metadata DB: SQLite-backed external metadata for messages/topics
- Bot commands:
/status, custom commands via plugin API - Event queue: Long-polling event processing with reconnection
- Rate limiting: Respects Zulip API rate limits with retry
Zulip bot setup
- Go to Zulip → Settings → Bots → Add a new bot
- Choose "Generic bot" type
- Copy the bot email and API key
- Use the organization URL as
realm
Verification
openclaw gateway restart
Check gateway logs for zulip channel initialization. Send a DM to the bot in Zulip to verify.
Tests
cd openclaw-zulip && npm install && npm test
74 vitest tests covering client, gateway, normalize, threading, metadata, and probe modules.