Feishu Agent Relay - Multi-Bot Collaboration — Feishu 代理 Relay - Multi-机器人 Collaboration

Feishu 代理 Relay 🚨 安装ation: Choose Your Mode First!

⚠️ BEFORE 设置UP: You must choose a 部署ment mode!

Mode For User ID 设置up Security Single-User Personal use Auto ("me") ✅ 5 min ✅ High Multi-User Teams Manual entry ⚠️ 30 min ⚠️ Low Quick Decision 图形界面de

Choose Single-User Mode if:

✅ Only YOU will use the 机器人s ✅ Personal productivity 系统 ✅ Want ZERO manual configuration ✅ Want fastest 设置up (5 minutes)

📖 图形界面de: references/single-user-设置up.md

Choose Multi-User Mode if:

✅ Multiple people will use the 系统 ✅ Team or organization ✅ Need to 追踪 different users ✅ Planning to 添加 verification later

📖 图形界面de: references/feishu-机器人-设置up.md

⚠️ 导入ant Limitations

Read this before using the 技能:

• Manual User ID Registration ⚠️ SECURITY LIMITATION (Multi-User Mode Only)

Current flow requires users to manually enter their User ID:

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

⚠️ Risks:

❌ No 身份 verification - 系统 trusts whatever user types ❌ 身份 spoofing possible - User could clAIm another person's ID ❌ Human error - Users may mistype their ID ❌ No 审计 trAIl - Cannot prove who actually registered ❌ NOT production-ready - Internal/personal use ONLY

✅ Acceptable for:

Personal projects (use Single-User Mode!) Small team internal 工具s 测试 and prototyping

❌ NOT acceptable for:

Production 系统s External-facing 应用s Security-sensitive operations

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

• Multiple Feishu 机器人s Required 🔧 设置UP REQUIRED

This 技能 requires multiple Feishu 机器人 应用s:

机器人 Type Quantity Example Names Coordinator 1 协调员 Specia列出s 2+ 技术专家，产品专家

📖 设置up 图形界面de: references/feishu-机器人-设置up.md

⚡ Single-User Mode: Zero Configuration

Recommended for personal use!

# 1. 设置 环境 variable 导出 部署MENT_MODE=single-user

# 2. 创建 empty m应用ing table (no users needed) cat > user-m应用ing.json << 'EOF' { "version": "1.0", "users": {}, "代理s": { ... } } EOF

# 3. Contact any 机器人 - auto-registers you! # That's it! No manual User ID entry needed.

How it works:

First contact: 机器人 auto-registers you as userid "me" All 机器人s: Automatically 追踪 your open_id Relay: Uses hardcoded userid "me" (no queries needed) Security: No 身份 spoofing risk (only you)

📖 Full 图形界面de: references/single-user-设置up.md

👥 Multi-User Mode: Manual Configuration

For teams and organizations.

# 1. 设置 环境 variable 导出 部署MENT_MODE=multi-user

# 2. Each user must register: User → 机器人: "你好" 机器人 → User: "请告诉我您的 User ID" User → 机器人: "我的 user ID 是：zhangsan"

⚠️ Security 警告: Manual User ID entry has NO verification. Internal use only!

📖 Full 图形界面de: references/feishu-机器人-设置up.md

Quick 启动

This 技能 enables multi-代理 collaboration on Feishu where:

Users contact a coordinator 机器人 Coordinator relays tasks to specia列出 机器人s Specia列出s proactively message users User → Coordinator 机器人 → 会话s_发送 → Specia列出 机器人 → User (proactive DM) (userid only) queries m应用ing

📋 设置up 检查列出 Phase 1: Feishu 机器人 Configuration (~30 minutes) 创建 Feishu Developer Account 创建 Coordinator 机器人 + Specia列出 机器人s 配置 权限s 配置 Event Subscriptions Test Each 机器人

📖 图形界面de: references/feishu-机器人-设置up.md

Phase 2: Choose 部署ment Mode Single-User: 设置 部署MENT_MODE=single-user Multi-User: 设置 部署MENT_MODE=multi-user 初始化 m应用ing table 部署 m应用ing API

📖 Single-User 图形界面de: references/single-user-设置up.md

Phase 3: 测试 (~15 minutes) Test first contact (auto-register or manual) Test relay flow Test proactive message 验证 m应用ing table When to Use This 技能

Use when:

✅ Multiple Feishu 机器人s working to获取her ✅ Users contact one 机器人, 接收 响应s from different 机器人s ✅ Cross-机器人 user 身份 management needed ✅ Specia列出 机器人s proactively message users

Don't use for:

❌ Single-机器人 scenarios ❌ Production without verification (multi-user) ❌ External-facing 应用s Architecture ┌─────────────────┐ │ User │ │ (Feishu DM) │ └────────┬────────┘ │ 1. User contacts coordinator ▼ ┌─────────────────┐ 2. Coordinator identifies user │ Coordinator │ (auto or manual) │ 代理 │ │ (编排器) │ 3. Relay via 会话s_发送 └────────┬────────┘ (userid only) │ ▼ ┌─────────────────┐ 4. Specia列出 queries m应用ing │ Specia列出 │ for own open_id │ 代理 │ └────────┬────────┘ 5. 发送 proactive DM │ ▼ ┌─────────────────────────┐ │ user-m应用ing.json │ │ userid → open_id map │ └─────────────────────────┘

Critical Concept: Feishu open_id Isolation

Each 机器人 has different open_id for the same user:

Same user (userid: user_demo_001): ├─ Coordinator 机器人: ou_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ├─ Tech Expert 机器人: ou_bbbb