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

1. Go to Zulip → Settings → Bots → Add a new bot
2. Choose "Generic bot" type
3. Copy the bot email and API key
4. 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.

Source