What makes Feishu Group Chat notable?

995 downloads. Trust evidence available

How should Feishu Group Chat be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Feishu Group Chat

让你的飞书Bot可以在群里与其他（使用了本skill的）Bot/用户聊天。飞书限制了Bot不响应其他Bot的消息，本技能另辟蹊径：让Bot在群中使用用户的身份去@其他Bot，同时添加本Bot姓名为消息前缀，来模拟Bot消息。把你的多个Bot加到一个群里，他们就能相互聊天甚至分配任务了。触发场景：需要在飞书群里...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

995

Updated

Oct 11, 2026

Version

1.1.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 995 downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 995 downloadsadoption · observed Oct 11, 2026
Latest release: 1.1.1release · observed May 28, 2026
Handshake status: UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

Release 1.1.1release
feishu-group-chat v1.1.1 - 新增 config-template.json 模板，简化首次配置流程，避免敏感信息泄露 - 新增/增强脚本 send_group_message.sh：首次运行自动创建 config.json 并提示用户填写，输出方式调整为 shell 变量，便于自动化调用 - 消息“@”格式由2元素升级为3元素（prefix→at→正文），明确顺序要求和空格规范 - 强化用法规范：敏感 ID 配置与版本库隔离、严禁手动拼接 JSON、脚本必用 - 扩展每日聊天自动化相关机制，明确 cron+心跳工作流与图片处理流程 - 补充 config.json 管理和敏感数据处理的安全提醒
Observed May 28, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s17famnx7qw55qapk2kevqzr5x83h38h:feishu-group-chat

Install using `clawhub skill install s17famnx7qw55qapk2kevqzr5x83h38h:feishu-group-chat` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/clear0/feishu-group-chat before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-clear0-feishu-group-chat/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

63,269 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: feishu-group-chat
description: >
  让你的飞书Bot可以在群里与其他（使用了本skill的）Bot/用户聊天。
  飞书限制了Bot不响应其他Bot的消息，本技能另辟蹊径：让Bot在群中使用用户的身份去@其他Bot，同时添加本Bot姓名为消息前缀，来模拟Bot消息。把你的多个Bot加到一个群里，他们就能相互聊天甚至分配任务了。
  触发场景：需要在飞书群里发消息、回复消息、发自拍、闲聊时使用。
---

# 飞书群聊（通用版）

在任何飞书群里发消息和回复聊天对象。

## 配置

`config.json` 包含联系人、群的完整配置。**本文件包含敏感信息（open_id/chat_id），已通过 `.clawhubignore` 排除，不会上传到 GitHub/ClawHub。**

### 首次使用

技能目录下提供 `config-template.json` 模板。首次运行 `send_group_message.sh` 时，脚本会自动将模板复制为 `config.json`，提示用户编辑后重试。

也可以手动复制：
```bash
cp config-template.json config.json
# 编辑 config.json，填入真实的 open_id、chat_id 等信息
```

### 配置格式

```json
{
  "contacts": {
    "ray": {
      "open_id": "ou_xxx",
      "name": "Ray"
    }
  },
  "groups": {
    "moltpool": {
      "chat_id": "oc_xxx",
      "name": "MoltPool",
      "members": ["ray"],
      "at_rules": { "ray": true }
    }
  }
}
```

**字段说明：**
- `contacts`：全局联系人（open_id 全应用唯一，跨群不变）
  - `open_id`：对方的飞书 open_id
  - `name`：对方的名字
- `groups`：群配置
  - `chat_id`：群 ID
  - `members`：该群包含的联系人 key 列表
  - `at_rules`：每个联系人在该群是否需要 @（`true/false`）

身份前缀自动从 agent 的 IDENTITY.md / SOUL.md 读取名称，不需要手动配置。

**添加新群**：在 `groups` 下新增条目，`members` 引用已有的 contact key，配 `at_rules` 即可。

**添加新联系人**：在 `contacts` 下新增，然后加到对应群的 `members` 里。

## 发送铁律

1. **只用 `feishu_im_user_message`** 工具发送
2. **`msg_type` 必须是 `"post"`**（不是 text）
3. **`receive_id_type` 必须是 `"chat_id"`**
4. **`receive_id` 从脚本输出的 `CHAT_ID` 环境变量获取**

## 消息格式

### @ 对方（at=true 时）— 3 元素结构

```json
{
  "zh_cn": {
    "title": "",
    "content": [[
      {"tag": "text", "text": "Vicky: "},
      {"tag": "at", "user_id": "ou_xxx"},
      {"tag": "text", "text": " 正文内容"}
    ]]
  }
}
```

**⚠️ 格式铁律（违反即犯错）：**
1. **顺序**：text(prefix) → at(对方) → text(" " + 正文)，共 3 个元素
2. **工具**：`feishu_im_user_message`，不是 `message`
3. **类型**：`post`，不是 `text`
4. **前缀**：prefix 从 IDENTITY.md 的 Name 自动取（如 `Vicky: `），后跟一个空格再接正文
5. **at 在中间**：prefix 在最前，@ 紧跟其后，正文在最后

### 不 @ 对方（at=false 时）

```json
{
  "zh_cn": {
    "title": "",
    "content": [[
      {"tag": "text", "text": "Vicky: 正文内容"}
    ]]
  }
}
```

### 带图片的消息

图片作为第 4 个元素追加（`{tag: "img", image_key: "img_xxx"}`）。图片通过脚本自动上传。

## 快捷发送脚本

`scripts/send_group_message.sh` 构造消息参数，输出 source-friendly 环境变量：

```bash
# 第一步：用脚本构造参数
source <(bash scripts/send_group_message.sh moltpool ray "你好呀～")
# 带图片：
# source <(bash scripts/send_group_message.sh moltpool ray "看这个" --image /path/to/image.png)
# 只有图片：
# source <(bash scripts/send_group_message.sh moltpool ray "" --image /path/to/image.png)

# 第二步：用 feishu_im_user_message 工具发送
#   action: send
#   receive_id_type: chat_id
#   receive_id: 从 $CHAT_ID 取
#   msg_type: $MSG_TYPE (固定为 post)
#   content: $MSG_CONTENT
# 如有图片（HAS_IMAGE=true），图片已内嵌在 MSG_CONTENT 中，无需额外发送
```

**脚本自动读取** `config.json`，调用方无需关心 open_id/chat_id。

## 每日聊天机制

### 闲聊时段

由 cron 定时任务每天 4:20 自动生成，存储在 `~/.openclaw/workspace/proactivity/chat-schedule.md`：

```markdown
- [ ] 07:00-07:50 | 话题：...
- [x] 12:20-13:10 (📸) | 话题：...（补发 16:53）
- [ ] 18:15-19:05 | 话题：...
```

**心跳中的处理逻辑：**

README.md

# feishu-group-chat

> 让多个飞书 Bot 在同一个群里互相对话。

飞书限制了 Bot 不响应其他 Bot 的消息。本技能另辟蹊径：让 Bot 通过用户身份在群里 @ 其他 Bot，同时加上自己的名字前缀，模拟 Bot 之间的对话。把多个 Bot（都配置了本技能）加到同一个群里，它们就能相互聊天甚至分配任务了。

## ✨ 特性

- 🤖 **多 Bot 对话** — 在飞书群里实现 Bot 之间的互相对话
- 💬 **自动 @ 通知** — 按 `at_rules` 配置自动 @ 对方，确保通知送达
- 🖼️ **图片发送** — 支持发送图片（自动上传并内嵌到消息中）
- 📝 **联系人记忆** — 持久化联系人偏好、风格、话题记忆，个性化聊天
- 🔄 **自动初始化** — 首次使用自动从模板创建配置文件
- 🔒 **隐私安全** — 敏感信息（open_id、chat_id）独立存储，不纳入版本控制

## 快速开始

### 1. 安装

将本技能目录放到 OpenClaw 的 `skills/` 目录下：

```bash
# 通过 ClawHub 安装（推荐）
clawhub install feishu-group-chat

# 或手动 clone
git clone https://github.com/clear0/feishu-group-chat.git ~/.openclaw/workspace/skills/feishu-group-chat
```

### 2. 配置

首次运行 `send_group_message.sh` 时，脚本会自动从 `config-template.json` 创建 `config.json`，你需要编辑它：

```json
{
  "contacts": {
    "ray": {
      "open_id": "ou_xxxxxxxxxxx",
      "name": "Ray"
    }
  },
  "groups": {
    "mygroup": {
      "chat_id": "oc_xxxxxxxxxxx",
      "name": "My Group",
      "members": ["ray"],
      "at_rules": { "ray": true }
    }
  }
}
```

**字段说明：**

| 字段 | 说明 |
|------|------|
| `contacts` | 全局联系人列表（open_id 跨群唯一） |
| `groups` | 群配置，`members` 引用 contacts 的 key |
| `at_rules` | 每个联系人在该群是否需要 @（`true/false`） |

Agent 的名字前缀会自动从 `IDENTITY.md` 或 `SOUL.md` 的 `Name` 字段读取，无需手动配置。

### 3. 授权

本技能依赖用户 OAuth 授权。首次使用前请确保已授权飞书权限：

- `im:message` — 以用户身份发送消息
- `im:message:readonly` — 读取群消息
- `im:resource` — 上传图片

推荐使用 `feishu_oauth_batch_auth` 一次性授权所有权限。

## 使用方式

### 发送消息

```bash
# 第一步：用脚本构造参数
source <(bash scripts/send_group_message.sh <群标识> <联系人key> "消息内容")

# 带图片
source <(bash scripts/send_group_message.sh <群标识> <联系人key> "看这个" --image /path/to/image.png)

# 只发图片
source <(bash scripts/send_group_message.sh <群标识> <联系人key> "" --image /path/to/image.png)

# 第二步：用 feishu_im_user_message 工具发送
#   action: send
#   receive_id_type: chat_id
#   receive_id: $CHAT_ID
#   msg_type: $MSG_TYPE (固定为 post)
#   content: $MSG_CONTENT
```

### 消息格式

脚本自动处理消息格式，无需手动拼 JSON：

- **@ 对方**（at=true）：`前缀 → @对方 → 正文`
- **不 @**（at=false）：`前缀 + 正文`
- **带图片**：图片作为 `img` 标签内嵌在 post 消息中

## 文件结构

```
feishu-group-chat/
├── SKILL.md              # 技能完整文档（Agent 阅读）
├── README.md             # 本文件
├── CHANGELOG.md          # 更新日志
├── PERMISSIONS.md        # 权限需求说明
├── LICENSE               # MIT-0 许可证
├── config-template.json  # 配置模板（纳入版本控制）
├── config.json           # 实际配置（⚠️ 已排除版本控制）
├── .gitignore
├── .clawhubignore
├── scripts/
│   └── send_group_message.sh   # 消息构造脚本
└── memories/
    └── contacts/
        ├── _template.md  # 联系人记忆模板
        └── *.md          # 联系人记忆文件（⚠️ 已排除版本控制）
```

## 心跳集成

本技能设计为与 OpenClaw 心跳机制配合使用：

- **聊天检查**：每次心跳检查群里是否有新消息需要回复
- **闲聊时段**：由 cron 定时任务生成，心跳按时段触发主动聊天
- **📸 照片时段**：标记了 `(📸)` 的时段会额外生成生活照片

详细配置请参考 [SKILL.md](./SKILL.md)。

## 📸 照片生成（可选）

本技能支持在闲聊时段自动生成 Bot 的生活照片并发送到群里。如果你需要这个功能，需要额外准备：

### 1. 文生图模型

需要一个支持文生图的模型。推荐使用 **MiniMax image-01**（支持 character reference，能保持人物五官一致性）：

```yaml
# 在 OpenClaw 配置中添加图片生成模型
# 以 MiniMax 为例
imageGeneration:
  provider: minimax
  mod

_meta.json

{
  "ownerId": "kn78ytgncd7wqvg8vns5n45sk182twzq",
  "slug": "feishu-group-chat",
  "version": "1.1.1",
  "publishedAt": 1779929943878
}

CHANGELOG.md

# Changelog

## v2.1.0 (2026-05-27)

### 新增
- **config-template.json**：示例配置模板，新用户首次使用时自动从模板创建 config.json
- **脚本自动初始化**：send_group_message.sh 检测到 config.json 不存在时自动从模板复制
- **.clawhubignore 完善**：排除 config-template.json、memories/、token 缓存等隐私/非必要文件

### 优化
- **隐私信息脱敏**：config.json、memories/ 已完全排除版本控制，发布包不含任何 open_id/chat_id
- **SKILL.md 文档更新**：补充自动初始化说明

## v2.0.0 (2026-05-20)

### 破坏性变更
- **敏感信息分离**：`config.json` 不再包含 open_id / chat_id，拆分到 `secrets.json`（不纳入版本控制）
- **脚本输出格式**：从 JSON 输出改为 source-friendly 环境变量（`CHAT_ID`, `MSG_TYPE`, `MSG_CONTENT`, `HAS_IMAGE`, `IMAGE_KEY`）
- **消息格式统一**：at=true 时固定为 3 元素结构 `text(prefix) → at(对方) → text(正文)`

### 新增
- **每日聊天机制**：闲聊时段（cron 生成）+ 聊天检查（心跳）+ 📸照片时段
- **secrets.json**：敏感信息独立存储，脚本自动合并 config.json + secrets.json
- **图片内嵌**：图片作为 `img` 标签内嵌在 post 消息中，无需额外发送

### 优化
- **脚本通用化**：`send_group_message.sh` 替代专用 `chat_to_ray.sh`，支持任意群和联系人
- **SKILL.md 文档补全**：合入聊天检查、闲聊时段、照片生成等近期新功能的完整文档
- **HEARTBEAT.md 更新**：统一使用新脚本路径和调用方式

## v1.1.0 (2026-04-18)

### 新增
- **记忆管理系统**：联系人记忆全局共享（`memories/contacts/`），按时间增量更新
- **消息来源识别**：sender_id + 前缀双重判断
- **认识新朋友机制**：遇到未知群/联系人时先征求用户同意
- **首次使用权限检查**：自动检测飞书 OAuth 权限

### 优化
- **配置结构升级**：contacts 全局共享 + 群引用
- **快捷脚本**：`send_group_message.sh` 支持图片上传

## v1.0.0 (2026-03-28)

### 初始功能
- 基础群消息发送和回复
- @ 对方通知
- 简单配置结构

PERMISSIONS.md

# 权限需求

本技能核心依赖：**用户 OAuth 授权（User Access Token）**

`feishu_im_user_message` 以用户身份发消息，必须用户先完成 OAuth 授权，否则所有发送操作都会失败。

## 授权方式

- **推荐**：`feishu_oauth_batch_auth` — 一次性授权所有已开通的用户权限
- **单次授权**：用户在飞书中点击应用授权弹窗完成

## 必需的用户权限（User Access Token scope）

| 权限 | 用途 | 对应操作 |
|------|------|---------|
| `im:message` | 以用户身份发送群消息 | `feishu_im_user_message` |
| `im:message:readonly` | 读取群消息历史 | `feishu_im_user_get_messages` |
| `im:chat` | 搜索消息、获取群信息 | `feishu_im_user_search_messages` |
| `im:resource` | 上传图片 | 脚本调用 `/im/v1/images` |

## 首次使用检查

其他 agent 首次使用本技能时，**必须先确认用户已 OAuth 授权**：

1. 尝试调用 `feishu_im_user_message` 发送一条测试消息
   - 成功 → 用户已授权，权限就绪
   - 失败且提示授权 → **必须先调用 `feishu_oauth_batch_auth`**，提示用户完成授权后重试
2. 可选：尝试 `feishu_im_user_get_messages` 读取群消息
3. 可选：如需发图，用脚本上传测试图片

## 授权失败时的降级策略

| 权限缺失 | 降级行为 |
|---------|---------|
| OAuth 未授权 | **技能完全不可用**，必须先授权 |
| `im:message` | 无法发送消息 |
| `im:message:readonly` | 无法读取群消息，跳过群监控 |
| `im:resource` | 降级为纯文字模式，不发图片 |
| `im:chat` | 无法搜索消息，仅能按群获取 |

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular