A specialized bridge skill for connecting Session Messenger with n8n workflows and OpenClaw agents for secure, automated messaging.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install session-openclaw-bridge
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install session-openclaw-bridge 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 Session OpenClaw Bridge?
The Session OpenClaw Bridge is a technical utility designed to manage the integration between Session Messenger, n8n orchestration, and OpenClaw agents. It serves as the connective tissue that allows an AI agent to communicate over the Session protocol by managing the relay side of the architecture. By utilizing Openclaw Skills like this, developers can ensure their agents remain reachable via secure, decentralized messaging platforms.
This skill focuses on the n8n and relay configuration, providing the logic for polling messages, filtering senders, and routing responses. It is essential for developers looking to deploy a production-ready messaging bot that maintains high security standards while leveraging the power of modern LLM agents.
Session OpenClaw Bridge Use Cases
- Setting up a new Session Messenger relay for an AI agent.
- Repairing broken n8n workflows that handle message polling and delivery.
- Validating relay health and endpoint compatibility for secure messaging.
- Implementing automated image and file exchange via the Session protocol.
- Packaging custom communication protocols for distribution on ClawHub.
How Session OpenClaw Bridge Works
- The skill initializes by reading the reference n8n workflow template to establish the polling logic.
- It triggers a validation script to probe the relay endpoints including
/health,/poll, and/send. - Upon successful validation, it configures a cron trigger within n8n to fetch new messages based on the last sequence ID.
- Incoming messages are filtered by sender and passed to the OpenClaw endpoint for response generation.
- The resulting AI reply is delivered back to the Session network via the relay's
/sendPOST endpoint.
Session OpenClaw Bridge Setup
To deploy the bridge, ensure your relay is active and then execute the following steps:
- Verify your relay health and API compatibility:
python3 scripts/validate_relay.py
Import the provided n8n workflow template from
references/openclaw-session-relay-workflow.jsoninto your n8n instance.Package the skill for deployment or publication:
scripts/package_skill.py /home/openclaw/.openclaw/workspace/skills/session-openclaw-bridge
Session OpenClaw Bridge Data Schema & Taxonomy
The skill utilizes a structured approach to manage the bridge state and metadata:
| Component | Path/Key | Description |
|---|---|---|
| Workflow Template | references/openclaw-session-relay-workflow.json |
The core n8n logic for polling and routing. |
| Health Schema | /health |
Returns ok, sessionId, inboundEnabled, and lastSeq. |
| Release Tracking | references/release.md |
Tracks versioning (e.g., 0.1.0) for ClawHub compatibility. |
| Polling API | /poll?since=<seq> |
Fetches message queue from the relay. |
Session OpenClaw Bridge Advanced Features
- Support for image and file attachments via dedicated
/attachmentendpoints. - Mismatch detection to identify if the deployed relay build is outdated compared to the Openclaw Skills requirements.
- Automated packaging for ClawHub with synchronized versioning across the skill and the relay project.
- Secure sender filtering to prevent unauthorized users from interacting with the AI agent.
SKILL.md
Loading
Related Openclaw Skills
Gemini CLI Integration
A bridge for utilizing the local Gemini CLI to perform secondary model reasoning, content generation, and structured data tasks on Linux hosts.
Lawyer Six Steps
A professional legal assistant skill implementing the Chinese Lawyer Six-Step Method to generate comprehensive case analysis reports.
Team Tasks
A sophisticated coordination framework for managing multi-agent development pipelines through shared JSON task files and centralized AGI dispatch.
n8n Workflow Management
A comprehensive management tool for n8n to programmatically create, test, and optimize automated workflows.
Hair Salon Promo Video
A specialized AI video agent designed to turn salon transformations and stylist expertise into high-conversion social media marketing content.
Educational Code Commenter
Automatically turns any source code file into a comprehensive learning resource by adding deep, context-aware educational comments.
Featured*
