首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >CloudQ企业微信智能机器人接入指南

CloudQ企业微信智能机器人接入指南

原创
作者头像
Smart Advisor
修改2026-03-27 11:51:02
修改2026-03-27 11:51:02
6140
举报

CloudQ 是全球首款多云治理领域🦞

🚀 整个接入过程只需 3 步,约 2 分钟即可完成。

准备工作

在开始之前,请确认你已具备:

  • ✅ 一个腾讯云账号(已开通智能顾问服务)
  • ✅ 一个企业微信账号(管理员或普通成员均可)
  • ✅ 欢迎加入交流群随时沟通

第一步:创建企业微信智能机器人

你需要先在企业微信中创建一个 API 模式的智能机器人,获取 Bot IDSecret

1.1 进入创建入口

根据你的角色选择对应入口:

角色

操作路径

管理员

浏览器打开企业微信管理后台 → 登录 →「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」

普通成员

打开企业微信客户端 →「工作台」→「智能机器人」→「创建机器人」

1.2 选择 API 模式创建

  • 管理员:在创建页面直接选择「API 模式创建
  • 普通成员:如进入了 AI 自动生成页面,点击左下角「手动创建
  • 右下角再选择「API 模式创建

1.3 获取 Bot ID 和 Secret

💡 进入后先填写机器人名称(如“CloudQ 助手”)、可见范围等基本信息。

准备工作

在 API 配置区域:

  1. 选择「使用长连接
  2. 复制 Bot ID(页面直接显示)
  3. 点击「点击获取」生成 Secret,并立即保存

⚠️ 重要:Secret 仅显示一次,请务必妥善保存。如果丢失,需要重新获取。

详细图文步骤也可参考:企业微信智能机器人创建指南

第二步:在腾讯云智能顾问控制台配置 CloudQ

2.1 打开配置页面

访问 CloudQ 配置页面

在左侧导航栏中点击「CloudQ配置」,进入「Claw 设置」页面。

在「集成(BETA)」区域,找到「企微 AIBot 集成」,点击右侧的「配置」按钮。

2.2 填写机器人凭据

在弹出的「注册企微 AIBot 通道」窗口中:

  1. 连接方式保持默认「WebSocket 长连接
  2. 填入第一步获取的 Bot ID(必填)
  3. 填入第一步获取的 Secret(必填)
  4. 点击「注册

注册成功后,企微 AIBot 集成的状态会变为「已连接」(绿色标签)。

2.3 配置免密登录(选填,推荐)

🔑 配置后,CloudQ 在对话中返回的控制台链接将支持一键免登录访问,无需再手动登录腾讯云。

在注册窗口中,还有两个选填字段:

字段

说明

腾讯云帐号 SecretId

你的腾讯云 API 密钥 ID

腾讯云帐号 SecretKey

你的腾讯云 API 密钥 Key

获取方式:登录 腾讯云 API 密钥管理,新建或复制已有密钥。

📌 关于自动创建的角色说明配置 SecretId / SecretKey 后,系统会在你的腾讯云账号下自动创建一个名为 Advisor_FederationLogin 的 CAM 角色,用于生成免密登录链接。该角色仅绑定以下两个策略:• QcloudAdvisorFullAccess — 智能顾问访问权限• QcloudTAGFullAccess — 标签服务访问权限此角色不会获取你账号下的其他资源权限,可放心使用。如不再需要,可在 CAM 角色管理 中手动删除该角色。

第三步:开始使用

配置完成后,在企业微信中即可使用 CloudQ:

打开企业微信,在通讯录「企业创建的」分组下找到你创建的机器人

点击「发消息」,发送任意内容(如“你好”)验证连接

收到回复即表示接入成功 🎉

你可以这样使用 CloudQ

试试说

CloudQ 会做什么

“帮我做一次架构评估”

对你的云上架构进行卓越架构评估,返回健康评分和风险摘要

“我有哪些高风险项?”

列出当前高风险和中风险项的详细信息

“我的 CVM 配置合理吗?”

AI 分析你的云服务器配置,给出优化建议

常见问题

机器人没有响应?

  1. 确认企微侧机器人已创建且选择了「使用长连接」模式
  2. 确认控制台侧状态显示为「已连接」
  3. 检查 Bot ID 和 Secret 是否复制正确(注意前后空格)
  4. 如果 Secret 已失效,在企微管理后台重新获取后,到控制台重新配置

免密链接不生效?

  1. 确认 SecretId 和 SecretKey 填写正确
  2. 确认你的腾讯云账号有创建 CAM 角色的权限(需要主账号或有 cam:CreateRole 权限的子账号)
  3. 如果之前手动删除过 Advisor_FederationLogin 角色,重新配置即可自动创建

想更换机器人怎么办?

在配置页面点击「解绑」,然后重新点击「配置」填入新的 Bot ID 和 Secret 即可。

联系我们

如在接入过程中遇到问题,可通过以下方式获取帮助:

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 准备工作
  • 第一步:创建企业微信智能机器人
    • 1.1 进入创建入口
    • 1.2 选择 API 模式创建
    • 1.3 获取 Bot ID 和 Secret
  • 准备工作
  • 第二步:在腾讯云智能顾问控制台配置 CloudQ
    • 2.1 打开配置页面
    • 2.2 填写机器人凭据
    • 2.3 配置免密登录(选填,推荐)
  • 第三步:开始使用
    • 你可以这样使用 CloudQ
  • 常见问题
    • 机器人没有响应?
    • 免密链接不生效?
    • 想更换机器人怎么办?
  • 联系我们
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档