← Back to Skills Marketplace
OpenClaw Zulip Channel Plugin
by
kagura-agent
· GitHub ↗
· v0.1.0
· MIT-0
57
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install 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 O...
Usage Guidance
What to check before installing:
- Confirm the source repository (https://github.com/kagura-agent/openclaw-zulip) is the expected upstream and review recent commits/maintainer identity. The SKILL.md and package manifest point to that repo.
- Verify and supply only a Zulip bot account with limited permissions. The plugin needs the bot email and API key — prefer a bot with narrowly scoped permissions and rotate the key if possible.
- The plugin stores metadata in ~/.openclaw/data/zulip-metadata.sqlite. If you prefer isolation, run the gateway in a container or change the path in the code/config to a controlled location and ensure backups/permissions are appropriate.
- Audit the package-lock.json dependency list before installing (npm install will pull these). The lockfile in the bundle contains a large set of transitive packages (including AWS/Anthropic-looking entries); confirm these are expected transitives from openclaw dependencies and not additional runtime components you don't want. Consider installing with production-only deps (npm ci --production) if you only need runtime.
- Run tests and basic functional checks in a sandboxed environment first (e.g., a VM or container) and observe network activity to ensure only Zulip endpoints and the expected registries are contacted.
- Because the registry metadata provided with the skill listing omitted required env vars, double-check your OpenClaw integration points (openclaw.plugin.json, SKILL.md, and secret contract files) to ensure the platform will surface prompts for the Zulip credentials and not any unexpected secrets.
If you cannot perform these checks, treat the discrepancy between declared metadata and the code/manifest as a reason to be cautious.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-zulip
Version: 0.1.0
The openclaw-zulip skill bundle is a standard Zulip channel integration for the OpenClaw framework. It implements message long-polling via Zulip's event queue API, topic-to-thread mapping, and a local SQLite-backed metadata store for tracking topic statuses and labels. The code follows OpenClaw SDK patterns for secret management (ZULIP_API_KEY) and inbound/outbound message normalization. No evidence of malicious behavior, data exfiltration, or prompt injection was found; the logic is consistent with the stated purpose of connecting an AI agent to a Zulip organization.
Capability Tags
Capability Assessment
Purpose & Capability
The code, README, and SKILL.md all implement a Zulip channel plugin (topic threading, metadata DB, bot commands, event queue). That functionality aligns with the skill name/description. However the top-level registry metadata in the provided listing claims no required environment variables or credentials, while the bundle includes openclaw.plugin.json that declares channelEnvVars (ZULIP_REALM, ZULIP_EMAIL, ZULIP_API_KEY) and the SKILL.md and code expect a Zulip API key/realm/email. This mismatch between registry metadata and the package manifest is inconsistent and worth verifying.
Instruction Scope
SKILL.md gives straightforward install/config instructions (git clone, add plugin to openclaw.json, add Zulip account config, restart gateway, run tests). The runtime code operates within the expected scope: polling Zulip events, normalizing events, dispatching to OpenClaw runtime, handling /meta commands, and storing metadata in a local SQLite DB. Two items to be aware of: (1) the plugin writes a SQLite DB to the user's home (~/.openclaw/data/zulip-metadata.sqlite), which SKILL.md does not explicitly call out, and (2) the code will long-poll and run continuously for active accounts (expected for a gateway). There are no instructions to read unrelated system files or exfiltrate data to unexpected endpoints beyond the Zulip realm and the declared GitHub repo.
Install Mechanism
There is no formal install spec in the skill bundle; SKILL.md describes cloning the GitHub repo and running npm install/test. The repository provided contains a full package-lock.json and many source files. The lockfile contains a large dependency graph (including many AWS-related and other packages) which increases install footprint — this may be explained by transitive deps from the openclaw dev dependency but should be verified. No downloads from obscure single-use URLs or extractor/install-from-arbitrary-archive behavior were observed. Overall install risk is moderate only because of the unexpectedly large dependency surface in package-lock; prefer to run npm install in a controlled environment and audit dependencies.
Credentials
The plugin legitimately needs Zulip credentials (realm, bot email, apiKey). Those are declared in openclaw.plugin.json and used by the code and SKILL.md. The top-level 'Requirements' summary in the input (which said 'none') is inconsistent with these declarations. I did not find any requests for unrelated credentials or environment variables (no AWS keys or other cloud credentials are requested by the code). Be aware the runtime will accept secrets either via config or environment variables (and includes secret-contract hooks), so verify how your OpenClaw installation will store/provide the bot API key.
Persistence & Privilege
The skill does not request always:true or other elevated platform privileges. It will run as a normal channel plugin (can be started/stopped by OpenClaw) and writes a local SQLite file at ~/.openclaw/data/zulip-metadata.sqlite for metadata persistence — this is within scope for a metadata DB but is persistent filesystem access in the user's home directory and should be noted by operators.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-zulip - After installation, invoke the skill by name or use
/openclaw-zulip - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release
Metadata
Frequently Asked Questions
What is 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 O... It is an AI Agent Skill for Claude Code / OpenClaw, with 57 downloads so far.
How do I install OpenClaw Zulip Channel Plugin?
Run "/install openclaw-zulip" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Zulip Channel Plugin free?
Yes, OpenClaw Zulip Channel Plugin is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Zulip Channel Plugin support?
OpenClaw Zulip Channel Plugin is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Zulip Channel Plugin?
It is built and maintained by kagura-agent (@kagura-agent); the current version is v0.1.0.
More Skills