如何养这只AI龙虾 🦞 — OpenClaw × 飞书集成指南

🦞

🎙️ Toastmasters演讲展示

🦞

如何养这只AI龙虾

OpenClaw × 飞书 集成指南

1 / 10

OpenClaw基础·概念解析

第一章

OpenClaw 是什么？

一个 AI 网关平台，把 AI 能力无缝接入你的日常聊天工具 💬

🤖

Agent（分身）

你的专属AI助手

每个分身独立配置，拥有独立的workspace和技能集

🌐

Gateway（网关）

消息路由中枢

端口18789，负责消息接收与分发，连接平台与AI

🛠️

Skills（技能）

可扩展的能力模块

生成海报、发送文件、数据分析……持续扩展

📂

Workspace（工作空间）

独立工作目录

每个分身有独立的文件和上下文环境

🌍 支持多平台接入：飞书 · 微信 · Discord · 更多……

2 / 10

架构解析·消息路由

第二章

消息怎么流转？

📱

飞书用户

发送消息

›

☁️

飞书服务器

云端中转

›

🔗

WebSocket

长连接

›

🦞

OpenClaw

Gateway :18789

›

🤖

Agent分身

路由匹配

›

🧠

AI模型

GLM / GPT…

🔄 AI回复原路返回

⚠️ 必须用长连接（WebSocket），不要用 Webhook！长连接才能保持实时双向通信。

3 / 10

数据流向·双向交互

第三章

双向数据交互

📱 飞书端

💬发送消息

📩接收AI回复

📎上传文件

🖼️接收图片内容

⟷

🦞 OpenClaw端

📨接收并解析消息

🧠调用AI模型处理

📄读写处理文件

✨生成回复内容

4 / 10

飞书配置·权限管理

第四章

飞书权限配置 🔑

✅ im:message 发送和接收消息（基础能力）

✅ im:message.group_at_msg 接收群聊 @ 消息，让机器人响应群里的呼叫

            ⭐
            im:message.p2p_msg
            接收私聊消息
            必须开通！不开通=私聊静默
          

✅ im:message:send_as_bot 以机器人身份发送消息到飞书

5 / 10

飞书配置·事件订阅

第四章（续）

更多权限 & 事件订阅 📋

✅ im:chat 获取群组信息，支持群聊场景

✅ im:resource 上传/下载图片和文件资源

✅ contact:user.base 获取用户基本信息（昵称、头像等）

📬 事件订阅

📬

im.message.receive_v1

接收消息事件 — 触发AI响应的核心事件

🔌 连接模式务必选择「长连接 WebSocket」模式，不要选 Webhook

6 / 10

服务器配置·核心结构

第五章

openclaw.json 核心结构 ⚙️

📋 agents

"id": "gc-ano" | "workspace": "/path/to/workspace"

📱 channels.feishu.accounts

"appId": "cli_xxxxxxxx"
"appSecret": "xxxxxxxxxx"
"botName": "GC-Ano"

🔀 bindings

"type": "route"
"agentId": "gc-ano"
"match": { channel: "feishu", accountId: "..." }

⚠️ CLI限制

channels add 不支持 --appId 参数，必须手动编辑 JSON 文件

⚠️ 进程管理

Gateway 用 systemd 托管，切勿用 nohup 启动，避免僵尸进程

7 / 10

激活流程·配对连接

第六章

配对激活 🤝

1

📱

在飞书找到机器人
发送任意消息

›

2

🔢

机器人回复
8位配对码
GY99WLBW

›

3

💻

服务器端执行
审批命令

›

4

🎉

配对成功！
开始AI对话

$ openclaw pairing approve feishu <配对码>

8 / 10

GC团队·分身家族

第七章

GC 分身家族 👨‍👩‍👧‍👦

🦞

GC-Ano

PR团队专属

🦞

OpenClaw

Gateway 主分身
端口 18789

🦞

GC-Yunduan

GC成员

🦞

GC-Cindy

GC成员

🦞

GC-Julie

GC成员

9 / 10

总结·展望

🦞

养好这只龙虾

🔗

飞书无缝集成
随时随地使用

📈

技能系统可扩展
持续进化成长

💡

从聊天到办公
全面赋能团队

让 AI 为你工作！

感谢聆听 · GC Toastmasters · Warren

10 / 10