Bot Secret 和 AI 网关密钥不要发到群聊、放进截图或填写在本页。
跟着做，一步步让机器人工作
从零启动你的
企业微信机器人
不用先弄懂技术架构。跟随下面的交互演示，完成安装、配置和第一次回复；需要全天在线，再选择最后一步。
从准备到第一条回答点击阶段或播放按钮。演示不会真的创建机器人，也不会修改配置。
01 / 07
Desktop 会自动完成机器人激活，不需要发送链接或等待负责人批准。
本机运行依赖电脑；线上由独立服务维持，Desktop 退出后仍能回答。
遇到问题再看这里
按情形展开，不必从头读完所有说明。
需要自己安装 Codex 吗？
不需要。Desktop 会先使用电脑上已有的 Codex；没有时，在你点击“启动本机运行”或运行检查里的“一键准备 Codex”后，从 Robot 服务获取并校验安装包，放进 Desktop 自己的目录，不改电脑上的其他 Codex。首次准备的文件较大，请保持网络连接并稍等。
如果选择“AI 网关密钥”，不需要额外登录 Codex；若选择“宿主 Codex”，仍需已有可用的宿主登录。线上运行使用线上独立环境，不下载到你的电脑。
自动准备失败时查看 Desktop 给出的错误明细；需要手动排障再看官方安装文档 ↗。
macOS 或 Windows 安装被拦截
先确认安装包来自 Robot Desktop 产品页。
- macOS：把 App 拖入“应用程序”。首次打不开时，先尝试打开一次，再到“系统设置 → 隐私与安全 → 安全性”点击“仍要打开”。
- Windows：确认来源后按 SmartScreen“更多信息 → 仍要运行”，并接受 UAC；安装器受企业策略限制时可用便携 ZIP。
- 不要关闭系统整体安全防护。
企微里找不到“智能机器人”
普通成员从企业微信“工作台 → 智能机器人”进入；管理员也可从管理后台“安全与管理 → 管理工具 → 智能机器人”进入。
确认创建的是手动创建的 API 模式智能机器人，不是群 Webhook，也不是企业微信自建应用。没有入口时请管理员确认权限。
机器人需要使用企业微信文档
如果要让机器人读取或操作企业微信文档，创建时还需在企业微信的机器人配置里授权对应的文档能力，并按实际用途选择授权范围，确认后保存。
不使用企业微信文档的机器人无需勾选；不要为了测试而开放无关文档权限。
AI 网关和宿主 Codex 怎么选？
推荐 AI 网关密钥：在 Desktop 点击“获取密钥”，创建后粘贴，再从支持对话的模型中选择。新建 Profile 默认是 gpt-4.1-mini，也支持直接输入模型 ID。
电脑已安装并登录 Codex CLI 时，也能选“宿主 Codex”。线上运行必须使用可托管的 AI 网关密钥，不能依赖本机登录状态。
启动后没有收到回复
- 先看“运行概览”：本机运行中、线上运行中，还是状态未知。
- 检查企业微信机器人的可见范围、消息权限和长连接配置。
- 数据服务失败时连接网络或检查网络访问，再点“重新检查”。
- 断线时查看“日志记录”；本机机器人可用
robot-desktop-cli doctor --json获取脱敏诊断。
关闭 Desktop 后机器人会停吗？
只关窗口：本机机器人留在后台。彻底退出或电脑关机：本机机器人停止。线上运行：Desktop 退出、断网或关机都不会停；重新打开会从线上恢复状态。
仍然显示等待负责人审批
新版服务默认批准激活申请。若仍停在等待页，先取消等待并重新点击“启动本机运行”；仍未恢复时说明当前请求命中了旧版服务，请联系管理员确认服务版本。
安全边界：同一个 Bot 同一时间只有一份运行权。本机与线上不能同时运行；线上机器人不读取本机硬盘，Desktop 也不监督线上进程。