Feishu Agent Relay

# Feishu Agent Relay

## 🚨 Installation: Choose Your Mode First!

**⚠️ BEFORE SETUP: You must choose a deployment mode!**

| Mode | For | User ID | Setup | Security |
|------|-----|---------|-------|----------|
| **Single-User** | Personal use | Auto ("me") | ✅ 5 min | ✅ High |
| **Multi-User** | Teams | Manual entry | ⚠️ 30 min | ⚠️ Low |

### Quick Decision Guide

**Choose Single-User Mode if:**
- ✅ Only YOU will use the Bots
- ✅ Personal productivity system
- ✅ Want ZERO manual configuration
- ✅ Want fastest setup (5 minutes)

📖 **Guide:** [references/single-user-setup.md](references/single-user-setup.md)

**Choose Multi-User Mode if:**
- ✅ Multiple people will use the system
- ✅ Team or organization
- ✅ Need to track different users
- ✅ Planning to add verification later

📖 **Guide:** [references/feishu-bot-setup.md](references/feishu-bot-setup.md)

---

## ⚠️ Important Limitations

**Read this before using the skill:**

### 1. Manual User ID Registration ⚠️ SECURITY LIMITATION (Multi-User Mode Only)

**Current flow requires users to manually enter their User ID:**

```
User → Bot: "你好"
Bot → User: "请告诉我您的 User ID（工号/用户名）"
User → Bot: "我的 user ID 是：user_demo_001"  ← ⚠️ MANUAL STEP - NO VERIFICATION
```

**⚠️ Risks:**
- ❌ **No identity verification** - System trusts whatever user types
- ❌ **Identity spoofing possible** - User could claim another person's ID
- ❌ **Human error** - Users may mistype their ID
- ❌ **No audit trail** - Cannot prove who actually registered
- ❌ **NOT production-ready** - **Internal/personal use ONLY**

**✅ Acceptable for:**
- Personal projects (use Single-User Mode!)
- Small team internal tools
- Testing and prototyping

**❌ NOT acceptable for:**
- Production systems
- External-facing applications
- Security-sensitive operations

**🔧 Single-User Mode avoids this:** No manual ID entry needed!

---

### 2. Multiple Feishu Bots Required 🔧 SETUP REQUIRED

This skill requires **multiple Feishu Bot app...

# Feishu Agent Relay Skill

**Multi-Agent Collaboration System for Feishu (Lark)**

[![ClawHub](https://img.shields.io/badge/platform-clawhub-blue)](https://clawhub.com)
[![OpenClaw](https://img.shields.io/badge/openclaw-skill-green)](https://openclaw.ai)
[![Version](https://img.shields.io/badge/version-1.2-orange)](https://clawhub.com/skills/feishu-agent-relay)

---

## 🎯 What It Does

Enable **multiple Feishu Bots to work together** as a coordinated team:

- **Coordinator Bot** receives user messages
- **Specialist Bots** (tech/product experts) provide domain expertise
- **Automatic task relay** between Bots
- **Proactive messaging** from specialists to users

**Key innovation:** Solves Feishu open_id isolation problem - each Bot has different open_id for the same user.

---

## 🚀 Quick Start

### Single-User Mode (Personal Use - 5 minutes)

```bash
# 1. Install skill from ClawHub
# 2. Set environment variable
export DEPLOYMENT_MODE=single-user

# 3. Contact any Bot - auto-configures!
# That's it! No manual setup needed.
```

### Multi-User Mode (Teams - 30 minutes)

```bash
# 1. Install skill from ClawHub
# 2. Set environment variable
export DEPLOYMENT_MODE=multi-user

# 3. Create 3+ Feishu Bots (coordinator + specialists)
# 4. Each user registers their User ID
```

---

## 📋 Features

### ✅ Deployment Modes

| Mode | For | Setup | Security |
|------|-----|-------|----------|
| **Single-User** | Personal use | 5 min, zero-config | ✅ High |
| **Multi-User** | Teams | 30 min, manual | ⚠️ Internal only |

### ✅ Core Capabilities

- **User Identity Mapping** - Cross-Bot user resolution
- **Task Relay** - Coordinator → Specialist routing
- **Proactive Messaging** - Specialists can DM users
- **Auto-Registration** - Single-user mode (zero-config)
- **Manual Registration** - Multi-user mode (with warnings)

### ✅ Documentation

- **SKILL.md** - Complete usage guide (13KB)
- **single-user-setup.md** - Personal use guide (12KB)
- **feishu-bot-setup.md** - Team setu...