引言
随着 AI Agent 快速普及,数字员工不再是大企业的专属。飞书作为团队日常协作工作台,如果能接入具备工具调用与长期记忆能力的 AI 智能体,就能把大量重复、低价值的办公任务交给 AI 自动处理。OpenClaw 开源 Agent 框架支持多通道对接、自定义技能与独立工作空间,让我们可以在飞书里快速构建专属数字员工。
本文从零开始,带你完成 OpenClaw 部署、飞书应用与 Webhook 对接、Agent 角色配置,手把手实现一个常驻飞书的数字员工。无需复杂基建,你可以按需扩展能力:文档阅读、多维表格读写、定时消息推送、会议纪要整理等,让 AI 真正融入团队日常协作,释放人力专注高价值工作。
安装openclaw
- 打开Windows PowerShell
#安装脚本会自动检测操作系统、安装 Node(如果缺失)、安装 OpenClaw 并启动初始配置iwr-useb https://openclaw.ai/install.ps1|iex- 验证安装
openclaw--version- 安装后台守护进程
openclaw gateway install
在这里插入代码片- 打开web控制面板,非必要
openclaw dashboard#浏览器访问 `http://127.0.0.1:18789` 进入管理后台OpenClaw- 初始配置与 Gateway 启动
openclaw onboard#向导会引导你完成:选择模型提供商(如 OpenRouter、Anthropic、Ollama 等)、粘贴 API 密钥、配置 Gateway 运行位置等。#也可以先跳过,后面再安装- 启动 Gateway
openclaw gatewaystart- 检查 Gateway 状态
openclaw gateway status接入飞书
登录飞书开放平台:打开 https://open.feishu.cn,用飞书账号登录。
创建企业自建应用:点击“开发者后台” → “创建企业内部应用”,填写应用名称(如“OpenClaw多Agent”)和描述。
获取 App ID 和 App Secret:进入应用的基础信息页面,可以看到 App ID 和 App Secret,这两个是后续接入 OpenClaw 的关键凭证。
开启机器人能力:在“应用能力”中找到“机器人”卡片并开启。
配置权限:在“权限管理”中,至少添加以下权限(我是直接把所有权限都开启了):
im:message(读取和发送消息)
im:message.group_at_msg(接收群聊中@机器人的消息)
im:chat(获取群组信息)事件回调选择WebSocket 长连接模式,不需要公网回调地址,内网服务器也可运行
发布应用:在“版本管理与发布”中创建版本并提交审核(企业内部应用通常可以快速通过)。
运行飞书渠道设置向导
openclaw channels login--channel feishu查看日志,确认飞书渠道已连接
openclaw logs--follow配置飞书群组访问策略(关键步骤)
# 允许所有群组,但仍然需要 @机器人 才会响应openclaw configsetchannels.feishu.groupPolicy"open"openclaw configsetchannels.feishu.requireMention true重启 Gateway
openclaw gateway restart搭建 OPC 多角色团队
每个 Agent 拥有独立的工作区、启动文件(bootstrap files)和会话存储
| 文件 | 用途 |
|---|---|
| AGENTS.md | 操作指令 + “记忆” |
| SOUL.md | 人格、边界、语气 |
| IDENTITY.md | 名称/风格/emoji |
| USER.md | 用户画像 + 称呼偏好 |
| BOOTSTRAP.md | 首次运行仪式(完成后删除) |
| MEMORY.md | 长期记忆文件(可选) |
创建 Agent 团队 ,根据自己公司需求创建Agent,技术开发公司角色设计
| 角色 | 核心职责 | 可委派给 |
|---|---|---|
| 项目总监 | 进度把控、资源协调、最终交付 | 产品经理、设计师、后端、前端、QA |
| 产品经理 | 需求分析、PRD撰写、功能定义 | 设计师、后端、前端、QA |
| UI/UX设计师 | 界面设计、交互原型、设计规范 | 后端、前端、QA |
| 后端开发 | API设计、数据库、业务逻辑 | 前端、QA |
| 前端开发 | 页面实现、交互逻辑、接口对接 | QA |
| QA工程师 | 测试用例、验收测试、Bug跟踪 | 无 |
创建各个角色Agent
# 创建项目总监(作为协调者)openclaw agents add tech-lead--workspace ~/.openclaw/agents/tech-lead--non-interactive# 创建产品经理openclaw agents add product-manager--workspace ~/.openclaw/agents/product-manager--non-interactive# 创建UI/UX设计师openclaw agents add designer--workspace ~/.openclaw/agents/designer--non-interactive# 创建后端开发openclaw agents add backend-dev--workspace ~/.openclaw/agents/backend-dev--non-interactive# 创建前端开发openclaw agents add frontend-dev--workspace ~/.openclaw/agents/frontend-dev--non-interactive# 创建QA工程师openclaw agents add qa-engineer--workspace ~/.openclaw/agents/qa-engineer--non-interactive配置各个角色的核心文件,路径一般在:C:\Users\用户名\.openclaw\agents
每个角色都需要配置,例如:项目总监tech-lead
AGENTS.md
# tech-lead## 角色技术团队项目总监。## 必须执行的动作收到任何开发需求后,你必须按以下顺序执行,不得跳过: 1.**立即调用 create_goal 工具**,参数 description 为用户需求原文,assignees 为["backend-dev"]。 2.**立即调用 sessions_send 工具**,参数 target 为"backend-dev",message 包含任务摘要。 3.只有在两个工具都调用成功后,才用文本回复用户。## 禁止-禁止在未调用 create_goal 的情况下回复用户。-禁止用“我已派发”“已分配”等文字描述来代替工具调用。-禁止只回复文本而不执行工具。## 不负责不写代码、不做需求分析、不做设计、不做测试。SOUL.md
# Identity你是技术开发团队的项目总监,负责统筹全局、协调资源、把控进度。 你的核心目标是确保项目按时、高质量地交付。# Communication Style-简洁、结构化,优先使用列表和表格-汇报时先给结论,再给细节-不冗长客套,直接进入正题-遇到风险时明确标注,不隐瞒# Rules-不代替用户做重大技术决策,提供选项和影响分析-不直接执行专业角色的工作-任务分派前确认各角色的可用性-定期输出进度摘要,保持信息透明-不因进度压力而降低质量标准# Context-团队角色:产品经理、UI/UX设计师、后端开发、前端开发、QA工程师-协作方式:通过 AGENTS.md 中定义的交接规则进行任务流转-交付标准:功能完整、经过测试、符合需求规格其他的角色也需要配置,如果不知道要配置什么内容可以直接让AI直接生成
需要在 OpenClaw 配置中启用 Agent 间通信
openclaw configsettools.agentToAgent.enabled true openclaw configsettools.agentToAgent.allow'["tech-lead", "product-manager", "designer", "backend-dev", "frontend-dev", "qa-engineer"]'开启会话可见性,实现Agent间记忆共享
openclaw configsettools.sessions.visibility"all"openclaw gateway restart验证基础配置
- 查看所有Agent及其绑定关系
openclaw agents list--bindings- 检查渠道连接状态
openclaw channels status--probe- 检查Gateway运行状态
openclaw gateway status绑定飞书群组
创建一个总群,并添加机器人
点击添加机器人按钮,选择刚刚创建好的机器人
添加好机器人之后,后续可以通过@机器人,给他发送指令
将Agent与飞书群绑定
- 点击群设置,划到最底部,将群会话ID复制出来
- Agent绑定飞书
openclaw agents bind--agent tech-lead--bind feishu:<项目总群ID>可以创建多个飞书群,并绑定到对应的Agent,例如:可以在飞书中创建产品群,并添加飞书的机器人绑定到产品经理的Agent,就可以在聊天窗口中@机器人发送指令,让他处理产品相关的需求。
- 将你的群ID加入允许列表
openclaw configsetchannels.feishu.groupAllowFrom'["oc_项目总群ID", "oc_产品群ID"]'- 确保需要@机器人才响应(推荐保持开启)
openclaw configsetchannels.feishu.requireMention true#重启getewayopenclaw gateway restart#确认每个Agent的 agentId 与 peer.id(群ID)正确匹配openclaw agents list--bindings配置Deepseek模型,其他模型也可以
第一步:获取 DeepSeek API 密钥
访问 https://platform.deepseek.com/api_keys。
登录后,在左侧菜单栏点击 API keys,然后点击 创建 API key。
为密钥命名(例如 OpenClaw),创建后立即复制生成的密钥(格式通常为 sk-…),关闭页面后将无法再次查看。
第二步:安装 DeepSeek 官方插件
openclaw plugins install @openclaw/deepseek-provider openclaw gateway restart第三步:配置 Provider 并设置 API Key
openclaw onboard--auth-choice 换成你的Deepseek API Key注意:如果openclaw版本过低,可能会报错,更新一下openclaw版本(执行openclaw update)或者手动配置Deepseek模型
如果openclaw update更新失败,用下面的方式更新
- 停止 Gateway
openclaw gateway stop- 升级 OpenClaw
npm install-g openclaw@latest- 验证版本
openclaw--version- 运行 Doctor 修复配置
openclaw doctor--fix- 启动 Gateway
openclaw gatewaystart手动配置 DeepSeek(兼容旧版本)
1.安装插件
openclaw plugins install @openclaw/openai-completions- 编辑 openclaw.json 添加 Provider,openclaw.json在openclaw安装目录下,默认在:C:\Users\用户名.openclaw,在 models.providers 下添加 DeepSeek 配置:
"deepseek":{"baseUrl":"https://api.deepseek.com","api":"openai-completions","apiKey":"sk-你的DeepSeek密钥","models":[{"id":"deepseek-v4-flash","name":"DeepSeek V4 Flash"},{"id":"deepseek-v4-pro","name":"DeepSeek V4 Pro"}]}- 设置默认模型
openclaw modelssetdeepseek/deepseek-v4-flash- 验证配置
openclaw config validate openclaw models list--provider deepseek openclaw gateway restart完成了,在飞书中发送 @openclaw 帮我开发一个简单的用户登录功能,然后在控制台查看日志中是否能收到