Kocoro企业微信集成配置指南
通过企业微信「智能机器人」的 API 模式，将 Kocoro 中的智能体接入企业微信，让团队成员可以在单聊或群聊中直接与你的智能体对话。 全流程约 3 分钟。
开始前的准备
- 一个企业微信「超级管理员」账号，或拥有「管理工具」权限的子管理员账号。
- 已安装并完成初始化的 Kocoro，并至少创建一个智能体。
- 一台保持运行的 Mac，用于承载长连接（无需公网 IP 或域名）。
- 1
进入企业微信「智能机器人」管理页面
使用管理员账号登录企业微信管理后台，依次点击左侧导航栏的「安全与管理」→「管理工具」，在右侧「智能专区 AI」分类下点击「智能机器人」卡片。
- 需要使用企业微信「超级管理员」或拥有「管理工具」权限的子管理员账号。
- 管理后台地址：https://work.weixin.qq.com/wework_admin/
图 1：在「安全与管理 → 管理工具」中找到「智能机器人」入口。 - 2
选择「手动创建」
在「智能机器人」页面点击「创建机器人」按钮。在弹出的「你需要一个什么样的机器人」对话框左下角，选择「手动创建」。
- 请勿使用对话框中的「AI 自动生成」方式，否则不会出现后续 API 模式所需的配置项。
图 2：在创建机器人弹窗左下角点击「手动创建」。 - 3
切换到「API 模式创建」
进入「创建智能机器人」配置页后，将右侧设置面板滚动到最底部，在「保存 / 取消」按钮上方找到提示文字，点击「API 模式创建」链接。
- API 模式下机器人将由 Kocoro 接管对话生成，因此页面上的「插件」「工作流」「欢迎语」等设置无需填写。
图 3：将右侧设置面板滚动到最底部，点击「API 模式创建」。 - 4
选择长连接并复制 Bot ID 与 Secret
在「API 配置」区域，「连接方式」选择「使用长连接」（无需配置域名或公网 IP）。然后复制下方自动生成的「Bot ID」，并点击「Secret」右侧的「点击获取」生成密钥并复制。
- 请将 Secret 妥善保存，关闭页面后将无法再次查看，只能重新生成。
- 记得在页面顶部为机器人设置「可见范围」并点击「保存」，否则成员无法在企业微信中与机器人对话。
图 4：选择「使用长连接」，复制「Bot ID」和点击获取后的「Secret」。 - 5
在 Kocoro 中添加企业微信机器人
打开 Kocoro，进入「能力 → 集成」页面，找到「企业微信」连接器并点击「+ 添加机器人」。在弹窗中将上一步复制的内容分别填入「机器人 ID」（Bot ID）与「机器人密钥」（Secret），选择要响应消息的「智能体」，可选填一个便于识别的「显示名称」，最后点击「注册机器人」即可完成接入。
- 注册成功后，机器人会立即通过长连接接入 Kocoro —— 在企业微信中向该机器人发送消息，即可由所选智能体生成回复。
- 可在「集成」页面随时点击「刷新」查看连接状态，或点击垃圾桶图标移除机器人。
图 5：在 Kocoro「集成」页中填入 Bot ID 与 Secret，完成机器人注册。
完成！下一步
注册成功后，可见范围内的成员即可在企业微信中向机器人发送消息， 由所选智能体接管回复。如需让机器人响应群聊，请在企业微信群中点击右上角「···」→「群机器人」，将该机器人添加到群中。
- 修改可见范围、回复智能体或显示名称：返回 Kocoro「集成」页面进行调整。
- Secret 泄漏或丢失：回到企业微信管理后台对应机器人的「API 配置」区域重新生成 Secret，再在 Kocoro 中更新即可。
- 机器人无响应：确认 Mac 已启动 Kocoro 且未休眠，并在「集成」页点击「刷新」检查连接状态。