多个飞书

Feishu Bot Setup

Automated setup and configuration of Feishu/Lark bots with OpenClaw.

Features

Overview

This skill automates the creation and configuration of multiple Feishu bots, each with:

Prerequisites

Quick Start

1. Prepare Bot Configuration

Create a configuration file with bot details. All fields under personality are customizable:

{
  "bots": [
    {
      "name": "general-assistant",
      "agentId": "feishu-bot-1",
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "encryptKey": "xxx",
      "verificationToken": "xxx",
      "connectionMode": "websocket",
      "personality": {
        "role": "通用助手",
        "tagline": "你的第一接待入口",
        "style": "温和简洁、快速响应",
        "styleDescription": "态度友好，回答简洁明了，快速响应",
        "responsibilities": [
          "常识问答",
          "轻量办公",
          "需求分流",
          "日常兜底"
        ],
        "description": "我是你的全能基础助理，快速响应你的各种需求。",
        "motto": "有问必答，有求必应，做你最贴心的第一入口。",
        "emoji": "🙋"
      }
    }
  ]
}

#### Personality Fields (All Optional, Customizable)

| Field | Description | Example | |-------|-------------|---------| | role | Bot's role name | "数据分析助手" | | tagline | Short tagline | "你的数据专家" | | style | Working style | "严谨、高效" | | styleDescription | Detailed style | "注重数据准确性，逻辑严密" | | responsibilities | List of duties | ["数据分析", "报表生成"] | | description | Self-introduction | "我是数据分析专家..." | | motto | Signature motto | "让数据说话" | | emoji | Bot emoji | "📊" |

You can define ANY role you need - customer service, sales, HR, finance, legal, etc.

2. Run Setup Script

python3 /root/.openclaw/workspace/skills/feishu-bot-setup/scripts/setup_bots.py /path/to/config.json

3. Restart Gateway

openclaw gateway restart

Manual Setup Steps

If you need more control, follow these manual steps:

Step 1: Create Agent

openclaw agents add  --workspace /path/to/workspace --non-interactive

Step 2: Configure Feishu Channel

Edit ~/.openclaw/openclaw.json and add to channels.feishu.accounts:

"": {
  "appId": "cli_xxx",
  "appSecret": "xxx",
  "encryptKey": "xxx",
  "verificationToken": "xxx",
  "domain": "feishu",
  "connectionMode": "websocket",
  "webhookPath": "/webhook/feishu/",
  "dmPolicy": "open",
  "groupPolicy": "open",
  "requireMention": false,
  "reactionNotifications": "off",
  "typingIndicator": true,
  "resolveSenderNames": true
}

Step 3: Bind Agent to Feishu Account

openclaw agents bind --agent  --bind feishu:

Step 4: Create Agent Configuration Files

Create these files in the agent workspace:

Step 5: Restart Gateway

openclaw gateway restart

Role Examples

You can create bots for ANY purpose. Here are some examples:

Customer Service Bot

{
  "role": "客服专员",
  "tagline": "你的贴心客服",
  "style": "耐心细致、专业友好",
  "responsibilities": ["问题解答", "投诉处理", "订单查询", "售后服务"],
  "emoji": "🎧"
}

Sales Assistant Bot

{
  "role": "销售顾问",
  "tagline": "你的销售专家",
  "style": "热情主动、洞察需求",
  "responsibilities": ["产品咨询", "方案推荐", "报价生成", "客户跟进"],
  "emoji": "💼"
}

HR Assistant Bot

{
  "role": "HR助手",
  "tagline": "你的人力资源伙伴",
  "style": "专业严谨、保密可靠",
  "responsibilities": ["政策解答", "请假审批", "入职指引", "福利咨询"],
  "emoji": "👔"
}

Legal Advisor Bot

{
  "role": "法务顾问",
  "tagline": "你的法律助手",
  "style": "严谨审慎、依法依规",
  "responsibilities": ["合同审核", "法律咨询", "风险提示", "合规建议"],
  "emoji": "⚖️"
}

Configuration Reference

Connection Modes

Policies

Troubleshooting

Bot Not Responding

1. Check gateway status: openclaw gateway status 2. Verify bindings: openclaw agents bindings 3. Check logs: openclaw logs --follow 4. Ensure Feishu app is published and events are subscribed

Credential Issues

Resources

1. Prepare Bot Configuration

Create a configuration file with bot details. All fields under personality are customizable:

{
  "bots": [
    {
      "name": "general-assistant",
      "agentId": "feishu-bot-1",
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "encryptKey": "xxx",
      "verificationToken": "xxx",
      "connectionMode": "websocket",
      "personality": {
        "role": "通用助手",
        "tagline": "你的第一接待入口",
        "style": "温和简洁、快速响应",
        "styleDescription": "态度友好，回答简洁明了，快速响应",
        "responsibilities": [
          "常识问答",
          "轻量办公",
          "需求分流",
          "日常兜底"
        ],
        "description": "我是你的全能基础助理，快速响应你的各种需求。",
        "motto": "有问必答，有求必应，做你最贴心的第一入口。",
        "emoji": "🙋"
      }
    }
  ]
}

#### Personality Fields (All Optional, Customizable)

| Field | Description | Example | |-------|-------------|---------| | role | Bot's role name | "数据分析助手" | | tagline | Short tagline | "你的数据专家" | | style | Working style | "严谨、高效" | | styleDescription | Detailed style | "注重数据准确性，逻辑严密" | | responsibilities | List of duties | ["数据分析", "报表生成"] | | description | Self-introduction | "我是数据分析专家..." | | motto | Signature motto | "让数据说话" | | emoji | Bot emoji | "📊" |

You can define ANY role you need - customer service, sales, HR, finance, legal, etc.

2. Run Setup Script

python3 /root/.openclaw/workspace/skills/feishu-bot-setup/scripts/setup_bots.py /path/to/config.json

3. Restart Gateway

openclaw gateway restart

Bot Not Responding

1. Check gateway status: openclaw gateway status 2. Verify bindings: openclaw agents bindings 3. Check logs: openclaw logs --follow 4. Ensure Feishu app is published and events are subscribed

Credential Issues