个人中心

⚠️ 一定要从下面这个入口进，不要从 q.qq.com 或 OpenClaw 那种第三方页面 —— 那种入口创建的机器人没有自定义回调地址，永远连不上这里。

1. 打开飞书开放平台
   访问 https://open.feishu.cn/app， 点 「创建企业自建应用」，填名字、上传 LOGO。
2. 启用「机器人」能力
   左侧菜单 → 「添加应用能力」 → 找到 「机器人」 → 点 「添加」/「启用」。 🔴 不启用机器人能力，私聊根本不会有事件。
3. 配置 Webhook 回调地址
   左侧菜单 → 「开发配置」 → 「事件与回调」 → 顶部 Tab 「事件订阅」 → 接收事件方式选 「使用 Webhook 接收事件」（不要选「长连接」），把下面这个地址填进「请求地址」：

   https://example.com/api/feishu/callback 复制

   点保存，飞书发挑战包过来，几秒后应该显示 「校验成功」 ✅。
4. 添加「接收消息」事件
   同页面下方 「已添加事件」 → 点 「添加事件」 → 搜 im.message.receive_v1 或「接收消息」→ 添加。 🔴 添加完后展开 「查看其他权限 ▼」，必须把 im:message:readonly（读单聊消息）也勾上。 默认只勾「群组 @机器人」，私聊就不会触发！
5. 申请 3 个权限
   左侧 「权限管理」，逐个搜索并点「开通权限」：

   • im:message — 读消息
   • im:message:readonly — 读单聊+群组消息
   • im:message:send_as_bot — 以机器人身份发回复

   个人开发者通常立刻通过；企业要管理员审批。状态显示 「已开通」（不是「已申请」）才生效。
6. 创建版本并发布
   左侧 「版本管理与发布」 → 「创建版本」， 版本号写 1.0.0， 「可用范围」选「全部成员」或包含自己的范围，提交发布。 🔴 不发布机器人不能用；可用范围不含自己，飞书里搜不到机器人。
7. 复制 AppID + AppSecret
   左侧 「凭证与基础信息」：

   • App ID：形如 cli_xxxxxxxxxxxx
   • App Secret：点「查看」拿到，只能看一次，错过要重置
8. 填回这里
   回到左边表单 → 渠道选 「飞书机器人」 → 填 AppID + AppSecret → 绑定一个记忆智能体 → 勾「启用连接」→ 点 「保存连接」。
9. 飞书里找到机器人
   飞书 App 顶部 🔍 搜索 → 输入应用名字（不是 OpenClaw 之类的现成机器人）→ 头像是你应用 LOGO 的那个 → 「私信」 或加好友。
10. 发条消息测试
    发 你好。3–15 秒后会看到 AI 智能体的回复。 💡 如果不回复，先看顶部「事件订阅」是否 显示「校验成功」、权限是不是「已开通」、版本是不是「已发布」。

📡 机器人收到消息后，会用你绑定的「记忆智能体」+ 默认免费模型生成回复。 以后可在表单的「自定义配置」里指定具体智能体。

腾讯自 2026 年起对个人开发者 QQ 机器人 关闭了自定义 Webhook 回调， 个人创建的机器人只能走 OpenClaw / Hermes 等官方网关，无法直接接入到 hucheng 服务。

代码层已经写好 Ed25519 签名验证，等腾讯重新开放或你完成企业主体认证后， 在 QQ 机器人开放平台 把回调地址填成 https://example.com/api/qq/callback 复制 即可。

企业微信自建应用 webhook 接入逻辑还没实现。如果你需要这条线， 发消息给管理员安排开发。