- name
- openclaw-zulip
- description
- Zulip channel plugin for OpenClaw with topic threading, metadata DB, bot commands, and event queue processing. Install from source when you want to connect OpenClaw to a Zulip organization.
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.gitAdd 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 restartCheck gateway logs for zulip channel initialization. Send a DM to the bot in Zulip to verify.
Tests
cd openclaw-zulip && npm install && npm test74 vitest tests covering client, gateway, normalize, threading, metadata, and probe modules.
Source
<https://github.com/kagura-agent/openclaw-zulip>