A framework for building multi-agent collaboration systems on Feishu by managing cross-bot user identity mapping and task relay.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-agent-relay
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 feishu-agent-relay 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 Feishu Agent Relay?
This skill provides a robust architecture for orchestrator-specialist agent systems within the Feishu (Lark) ecosystem. It specifically addresses the technical challenge of Feishu open_id isolation, where the same user is assigned different identifiers across various bot applications. By utilizing Openclaw Skills, developers can implement a centralized mapping system that allows a coordinator bot to delegate tasks to specialized agents who can then message users directly.
The framework supports two distinct deployment patterns: a zero-configuration Single-User mode for personal productivity and a Multi-User mode for team-based environments. This ensures that whether you are building a personal assistant or a complex corporate workflow, the identity management and relay protocols remain consistent and reliable.
Feishu Agent Relay Use Cases
- Managing multiple specialized Feishu bots through a single coordinator entry point.
- Implementing proactive messaging where specialist agents contact users based on relayed tasks.
- Synchronizing user identities across different Feishu applications using Openclaw Skills.
- Building internal team productivity tools that require multi-bot coordination and task delegation.
How Feishu Agent Relay Works
- A user initiates contact with a Coordinator Agent via Feishu DM.
- The Coordinator identifies the user through either auto-registration in Single-User mode or manual ID entry in Multi-User mode.
- The Coordinator relays the task to a Specialist Agent using the sessions_send protocol, passing only the internal User ID rather than a bot-specific open_id.
- The Specialist Agent queries the user-mapping.json table to retrieve its specific open_id required to communicate with that user.
- The Specialist Agent sends a proactive direct message to the user to complete the specialized workflow.
Feishu Agent Relay Setup
To get started with this skill within your Openclaw Skills environment, follow these steps:
- Set your preferred deployment mode:
export DEPLOYMENT_MODE=single-user
- Initialize the mapping table structure:
cat > user-mapping.json << 'EOF'
{
"version": "1.0",
"users": {},
"agents": {}
}
EOF
- Configure your Feishu Bot applications (Coordinator and Specialists) in the Feishu Developer Console, ensuring correct event subscriptions and permissions are granted.
- Deploy the mapping API using the provided mapping-api.js script to manage the user-to-bot relationship data.
Feishu Agent Relay Data Schema & Taxonomy
The skill manages identity data through a structured JSON schema to resolve ID isolation issues.
| Object | Property | Description |
|---|---|---|
users |
userid |
The unique internal identifier (e.g., "me" or a username). |
users |
name |
The human-readable name of the user. |
botOpenIds |
agentId |
A map where keys are Agent names and values are their specific Feishu open_ids. |
agents |
agentConfig |
Metadata defining the role and access of each specialist agent. |
Feishu Agent Relay Advanced Features
- Dual-mode deployment support for both personal (Single-User) and organizational (Multi-User) contexts.
- Automatic user registration logic in Single-User mode to provide a zero-config experience for Openclaw Skills users.
- Specialized session relay patterns using sessionKey (agent:name:main) to prevent identifier leakage between bots.
- Proactive DM capabilities allowing background agents to initiate user contact without prior user input to that specific bot.
- Built-in error handling for common Feishu API issues like cross-app open_id mismatches.
SKILL.md
Loading
Related Openclaw Skills
index1
A persistent AI memory system providing coding agents with hybrid search, code indexing, and cognitive fact recording across sessions.
index1 Doctor
A specialized diagnostic utility that verifies the technical health, dependencies, and model configuration of index1 environments.
Agent-Weave
A master-worker agent cluster framework designed for parallel task execution and distributed AI workflows.
Voice.ai Voice Agents
A comprehensive tool for building, managing, and deploying professional conversational voice agents via the Voice.ai Agent API.
Braingit
A deterministic utility for creating automated git snapshot commits specifically for Markdown files within a repository.
Subagent Watchdog
A reliability tool that monitors AI subagent runs by enforcing completion markers within defined deadlines.
Featured*
