OpenClaw Zulip Channel Plugin

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.

kagura-agent@kagura-agent

Install

openclaw skills install @kagura-agent/openclaw-zulip

OpenClaw Zulip Channel Plugin

Connect OpenClaw to Zulip — topic threading, metadata DB, bot commands, event queue processing.

Install (local path)

bash

git clone https://github.com/kagura-agent/openclaw-zulip.git

Add to openclaw.json:

json

{
  "plugins": {
    "load": {
      "paths": ["path/to/openclaw-zulip"]
    },
    "entries": {
      "kagura-zulip": { "enabled": true }
    }
  }
}

Configure

Add Zulip channel config:

json

{
  "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

bash

openclaw gateway restart

Check gateway logs for zulip channel initialization. Send a DM to the bot in Zulip to verify.

Tests

bash

cd openclaw-zulip && npm install && npm test

74 vitest tests covering client, gateway, normalize, threading, metadata, and probe modules.

Source

https://github.com/kagura-agent/openclaw-zulip