Zulip Integration for Openclaw

A powerful integration for interacting with the Zulip chat platform using Python and REST API to automate team communication workflows.

suky57
v1.0.2
Feb 16, 2026
0
1.8k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install zulip

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install zulip using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Zulip Integration?

The Zulip integration for Openclaw Skills allows developers and AI agents to seamlessly interact with Zulip organizations. It provides a robust interface to read and send messages, manage direct conversations, and navigate stream-based topics. By leveraging the official Python client and REST API, this skill empowers teams to build sophisticated bots and automated communication loops within their existing chat infrastructure.

This tool is essential for organizations looking to integrate Openclaw Skills into their daily developer operations and project management workflows. Whether you are managing public streams or private mentions, this skill provides the programmatic control needed for modern chat-ops and real-time collaboration. By utilizing the provided helper scripts, users can quickly perform complex chat operations without writing boilerplate code.

Zulip Integration Use Cases

  • Monitoring specific Zulip streams or topics for real-time updates and automated triggers.
  • Sending automated deployment notifications, system alerts, or CI/CD status updates to team channels.
  • Managing direct message conversations for personalized user interactions and support bots.
  • Searching message history to extract historical data or track project progress across different streams.
  • Automating user management and organization-level communication tasks to streamline onboarding workflows.

How Zulip Integration Works

  1. The skill authenticates with the Zulip server using a bot email and API key stored in a local configuration file (~/.config/zulip/zuliprc).
  2. It utilizes the official Python Zulip client to establish a secure connection to the specified organization site.
  3. Users or agents invoke the helper scripts or Python methods to perform operations like fetching messages or listing active streams.
  4. The skill processes Zulip-flavored Markdown to ensure messages are formatted correctly within the chat interface, supporting bolding, code blocks, and mentions.
  5. Advanced operations like file uploads and message reactions are handled through specific API endpoints to provide a rich and interactive user experience within the Openclaw Skills ecosystem.

Zulip Integration Setup

1. Install Python Client

pip install zulip

2. Create Configuration File

Create a file at ~/.config/zulip/zuliprc with the following content:

[api]
[email protected]
key=YOUR_API_KEY_HERE
site=https://example.zulipchat.com

3. Verify Connection

Run the following command to ensure Openclaw Skills can communicate with your Zulip instance:

python scripts/zulip_client.py streams

Zulip Integration Data Schema & Taxonomy

The skill interacts with several primary data entities within the Zulip ecosystem to maintain structured communication:

Entity Description Key Attributes
Message The core content unit for communication. ID, Sender, Stream/Topic, Content (Markdown), Timestamp
Stream A channel for group conversation. Name, ID, Description, Privacy Status
User An organization member or bot. User ID, Email, Full Name, Status
Reaction Emoji interactions on specific messages. Message ID, Emoji Name, User ID
Narrow A search or filter parameter for messages. Operator (stream, topic, sender), Operand

Zulip Integration Advanced Features

  • Multi-format message retrieval including stream-based, private, and mention-specific narrows for precise data fetching.
  • Programmatic file uploads allowing agents to share documents, logs, and assets directly within channels.
  • Interactive support via emoji reactions (adding and removing) to provide automated feedback on messages.
  • Robust error handling and rate limit management to ensure reliable performance under high-volume communication loads.
  • Full support for Zulip-specific Markdown, including user mentions and stream linking, to maintain native chat experiences.
  • Extensible Python methods for searching messages and retrieving user IDs by email within the Openclaw Skills environment.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*