bot_setup

Bot 配置引导技能

当用户说「帮我添加飞书机器人」「配置 Discord bot」「连接 Telegram」等时，使用此技能引导用户完成整个配置流程。

核心流程

1. 确认平台 — 询问用户要配置哪个平台
2. 打开浏览器 — 用 browser_use（headed=true）打开对应平台的开发者控制台
3. 引导操作 — 使用 ai_snapshot + act 辅助用户在页面上操作
4. 获取凭据 — 从页面提取 App ID、Secret 等信息
5. 创建 Bot — 调用 manage_bot 的 create action 完成创建
6. 测试连接 — 启动 Bot 并发送测试消息

各平台详细配置步骤

飞书 (Feishu)

所需凭据: app_id, app_secret, webhook_url

步骤 1: 创建应用

• 打开 https://open.feishu.cn/app （国际版: https://open.larksuite.com/app）
• 如果用户未登录，提示用户登录飞书账号
• 点击「创建企业自建应用」
• 填写应用名称和描述

步骤 2: 获取凭据

• 进入应用 → 「凭证与基础信息」页面
• 复制 App ID（格式: cli_xxxxxxxx）
• 复制 App Secret

步骤 3: 启用机器人能力

• 进入「应用能力 > 机器人」
• 开启机器人功能

步骤 4: 配置权限

• 进入「权限管理」
• 搜索并开通以下权限:
  • im:message — 获取与发送消息
  • im:message:send_as_bot — 以机器人身份发送消息
  • im:chat:readonly — 获取群组信息
  • contact:user.id:readonly — 获取用户 ID

步骤 5: 配置事件订阅

• 进入「事件订阅」
• 选择「使用长连接接收事件」（推荐，无需公网 URL）
  • 或设置请求地址: http://<你的IP>:9090/webhook/feishu
• 添加事件: im.message.receive_v1（接收消息）

步骤 6: 发布应用

• 进入「版本管理与发布」
• 创建版本并提交审核
• 审核通过后即可使用

步骤 7: 在 YiYi 创建 Bot

{
  "action": "create",
  "platform": "feishu",
  "name": "我的飞书机器人",
  "config": {
    "app_id": "cli_xxxxxxxx",
    "app_secret": "从页面复制的密钥",
    "webhook_url": "https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx"
  }
}

---

钉钉 (DingTalk)

所需凭据: webhook_url, secret

步骤 1: 创建机器人

• 打开 https://open-dev.dingtalk.com/
• 登录后进入「应用开发 > 机器人」
• 点击「创建机器人」

步骤 2: 获取 Webhook

• 在群设置中添加自定义机器人
• 安全设置选择「加签」，复制 Secret
• 复制 Webhook URL

步骤 3: 在 YiYi 创建 Bot

{
  "action": "create",
  "platform": "dingtalk",
  "name": "我的钉钉机器人",
  "config": {
    "webhook_url": "https://oapi.dingtalk.com/robot/send?access_token=xxx",
    "secret": "SECxxxxxxxx"
  }
}

---

QQ

所需凭据: app_id, client_secret

步骤 1: 创建应用

• 打开 https://q.qq.com/
• 登录 QQ 开放平台
• 创建一个机器人应用

步骤 2: 获取凭据

• 在应用详情中复制 App ID 和 Client Secret
• 配置沙箱或正式环境的频道权限

步骤 3: 在 YiYi 创建 Bot

{
  "action": "create",
  "platform": "qq",
  "name": "我的QQ机器人",
  "config": {
    "app_id": "你的AppID",
    "client_secret": "你的ClientSecret"
  }
}