指导在Windows环境下创建并配置飞书机器人,绑定至OpenClaw指定Agent,实现多Agent多角色管理和消息交互。
# feishu_robot_creater(飞书机器人创建) 快速创建飞书机器人并连接到 OpenClaw,绑定专属 Agent。 --- ## 适用环境 - 操作系统:Windows(当前机器) - OpenClaw 版本:`2026.4.26` - 当前工作区:`C:\Users\26462\.openclaw\workspace` - OpenClaw 文档目录:`C:\Users\26462\AppData\Roaming\npm\node_modules\openclaw\docs` - 主人称呼偏好:对用户统一称“主人” - 当前主代理身份:皇帝(总后台 / 主代理) > 本技能已按主人当前机器环境改写:路径、命令风格、Gateway 操作方式均以这台 Windows + OpenClaw 环境为准。 --- ## 这个技能是做什么的 这个技能用于指导或协助创建一个新的飞书机器人,并把它接到 OpenClaw,让该机器人绑定到一个独立 Agent。 适合的场景: - 想给不同用途创建不同飞书机器人 - 想把“工程师 / 客服 / 运营 / 设计师”等角色拆成独立 Agent - 想让新的飞书机器人直接接入当前 OpenClaw 环境 --- ## 命名规则 | 输入(中文) | Agent ID(英文) | Agent Name(中文) | |--------------|------------------|-------------------| | 工程师 | engineer | 工程师 | | 测试机器人 | test-bot | 测试机器人 | | 客服 | customer-service | 客服 | | 运营 | operator | 运营 | | 设计师 | visual-designer | 设计师 | 建议: - `Agent ID` 使用小写英文或连字符 - 尽量避免空格、中文、特殊符号 - 飞书机器人中文名可按业务用途命名 --- ## 完整流程 | 步骤 | 说明 | |------|------| | 1 | 访问创建链接 → 填名称+头像 | | 2 | 获取 App ID + App Secret | | 3 | 检查飞书事件与权限配置 | | 4 | 创建 Agent 工作区结构 | | 5 | 配置 OpenClaw | | 6 | 重启 / 检查 Gateway | | 7 | 验证连接 | --- ## 第 1 步:创建飞书应用 **访问链接**:https://open.feishu.cn/page/openclaw?form=multiAgent **操作步骤**: 1. 打开链接后,点击「创建应用」 2. 输入机器人名称(如:工程师、客服、运营) 3. 选择一个头像(可选) 4. 点击「确定」或「创建」按钮 5. 记住创建的机器人名称,后续配置需要 --- ## 第 2 步:获取凭证 **进入应用后台**: 1. 回到应用列表,点击刚创建的应用 2. 点击左侧菜单「凭证与基础信息」 3. 复制以下信息: - **App ID**(格式:`cli_xxxxxx`) - **App Secret**(点击「获取」按钮后复制) **请保存好这两个凭证,后续配置必须用到。** --- ## 第 3 步:检查飞书事件与权限 在飞书开放平台中确认: 1. **事件订阅** 已开启 2. 已配置接收消息相关事件(至少确认私聊消息接收能力) 3. 应用处于可用状态 4. 如果平台要求补充权限,按飞书控制台提示完成 > 不同版本的飞书后台 UI 会变化,若字段名称略有不同,以当前控制台实际显示为准。 --- ## 第 4 步:创建 Agent 工作区结构 建议在当前用户目录下为新 Agent 建立独立工作区。当前机器可参考: - OpenClaw 主目录:`C:\Users\26462\.openclaw` - Agent 工作区建议路径:`C:\Users\26462\.openclaw\agents\<agent-id>` ### 4.1 创建目录结构(PowerShell) 将 `<agent-id>` 替换为实际 Agent ID: ```powershell $agentId = "<agent-id>" $base = "C:\Users\26462\.openclaw\agents\$agentId" New-Item -ItemType Directory -Force -Path "$base\agent" | Out-Null New-Item -ItemType Directory -Force -Path "$base\.learnings" | Out-Null New-Item -ItemType Directory -Force -Path "$base\memory" | Out-Null New-Item -ItemType Directory -Force -Path "$base\skills" | Out-Null ``` ### 4.2 创建 MEMORY.md(重要) 建议初始化记忆文件: ```powershell $agentId = "<agent-id>" $botName = "<机器人名称>" $memoryPath = "C:\Users\26462\.openclaw\agents\$agentId\memory\MEMORY.md" @" # MEMORY.md - $botName ## 基础信息 - 名称:$botName - Agent ID:$agentId - 创建时间:$(Get-Date -Format 'yyyy-MM-dd') ## 用户信息 (待填写) ## 偏好习惯 (待填写) ## 工作状态 - 状态:已配置,待首次对话 - 技能:无 "@ | Set-Content -Path $memoryPath -Encoding UTF8 ``` > 是否“必须”创建该文件,取决于 Agent 设计;但实际使用中,提前建好 `memory\MEMORY.md` 更稳妥。 --- ## 第 5 步:配置 OpenClaw ### 推荐原则 - 优先参考本机 OpenClaw 文档与当前版本行为 - 不使用旧教程里的 macOS/Linux 路径 - 不使用手工 `kill` 进程替代 Gateway 重启 ### 5.1 Agent 配置思路 需要让 OpenClaw 知道这个新 Agent 的: - `id` - `name` - `workspace` - (如有需要)对应的 agent 目录 当前机器推荐工作区路径形态: ```text C:\Users\26462\.openclaw\agents\<agent-id> ``` ### 5.2 Feishu 账号配置思路 需要为飞书渠道补充: - `appId` - `appSecret` - `botName` - `enabled` - 该机器人与 Agent 的绑定关系 ### 5.3 绑定配置思路 目标是让: - 飞书账号 `<agent-id>` - 路由到 Agent `<agent-id>` > 由于不同 OpenClaw 版本的配置结构可能存在扩展字段,实际填写时建议以当前本机文档和现有配置格式为准。 --- ## 第 6 步:检查并重启 Gateway 当前环境下,优先使用 OpenClaw 官方子命令: ```powershell openclaw gateway status openclaw gateway restart ``` 如果只是检查状态: ```powershell openclaw status ``` > 不推荐使用旧文档中的 `ps | grep | kill` 流程;那套做法属于旧环境思路,在当前 Windows + OpenClaw 场景下并不合适。 --- ## 第 7 步:验证连接 **测试方法**: 1. 打开飞书,搜索机器人名称 2. 给机器人发送一条消息(如:`你好`) 3. 如果收到回复,说明连接成功 **常见问题**: - 如果没有回复,先检查 `openclaw gateway status` - 检查 App ID 和 App Secret 是否正确 - 检查飞书后台事件订阅与权限 - 检查 Agent 与飞书账号的绑定是否一致 --- ## 快速检查清单 - [ ] 访问创建链接并创建应用 - [ ] 获取并保存 App ID - [ ] 获取并保存 App Secret - [ ] 检查飞书事件与权限 - [ ] 创建 Agent 目录结构 - [ ] 初始化 `memory\MEMORY.md` - [ ] 配置 Agent 信息 - [ ] 配置 Feishu 账号信息 - [ ] 配置绑定关系 - [ ] 执行 `openclaw gateway restart` - [ ] 测试发送消息验证连接 --- ## 命名参考 | 用途 | Agent ID | 中文名 | |------|----------|--------| | 代码开发 | engineer | 工程师 | | 内容创作 | content-helper | 内容助手 | | 热点追踪 | hot-tracker | 热点追踪 | | 数据采集 | collector | 采集员 | | 视觉设计 | visual-designer | 设计师 | | 平台运营 | operator | 运营 | | 客服 | customer-service | 客服 | | 审核 | reviewer | 审核员 | | 知识库 | knowledge-integrator | 知识库 |
don't have the plugin yet? install it then click "run inline in claude" again.