本指南将帮助您在企业微信中配置 QClaw ，让您可以通过企业微信与 QClaw 完成互联。

一、前置条件

在开始之前，请确保您已满足以下条件：

已在电脑上安装 QClaw

企业微信客户端已安装最新版本

拥有一个可创建智能机器人的企业微信账号

提示：

若在企业微信的工作台中无法搜索到「智能机器人」，请检查企业微信版本并升级。

可根据您的账号角色选择不同入口：

管理员：在企业微信管理后台依次点击「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」，再选择「API 模式创建」

普通成员：在企业微信客户端依次点击「工作台」→「智能机器人应用」→「创建机器人」→「手动创建」→「API 模式创建」

提示：

如果您还没有企业微信账号，可以前往企业微信官网免费注册一个企业。

二、流程指引

整体流程

在企业微信中使用API模式创建机器人 -> 获取BotID和Secret并填入QClaw

详细步骤

1、创建智能机器人，获取Bot ID和Secret

（1）打开企业微信客户端，进入工作台->搜索“智能机器人”，点击创建机器人；

（2）选择手动创建

（3）进入创建页面后，选择API模式创建（底部页面提示「如需使用自有系统获取成员与机器人的聊天并输出回复，可切换至API模式创建」）；

（4）填写机器人名称，建议填写容易识别的名字，如「QClaw 助手」

（5）点击「可使用的成员」后的「修改」，选择需要使用机器人的成员、部门或标签。

（6）在API配置页面，选择连接方式为「使用长连接」；

（7）配置完成后，页面将生成并展示Bot ID，并点击获取Secret（请妥善保存该信息，关联QClaw需使用）；

（8）API模式暂不支持预览与调试，直接保存机器人配置即可。

2、关联企业微信机器人与QClaw

（1）打开 QClaw，点击左下角设置按钮，进入「远控通道」

（2）选择「企业微信」，点击「配置」

（3）在弹窗中选择「WebSocket 长连接」，填入刚才复制的 Bot ID 和 Secret，点击「连接」完成绑定

提示：

连接需要稍等一会哦~

3、开始使用

（1）在企业微信通讯录的「智能机器人」分组下找到刚刚创建的机器人，点击「发消息」即可开始下发任务。

（2）发送一条简单消息（例如“你好”）进行连通测试。如果配置正确，QClaw 会接收到消息并在企业微信中返回回复。

说明：

如果机器人能够正常回复，说明您已成功完成 QClaw与企业微信的对接🎊

三、常见问题

1、机器人没有响应怎么办？

（1）检查 QClaw 状态：确保电脑上的 QClaw 正在运行

（2）核对接入方式：确认企业微信与 QClaw 中选择的是同一种接入方式

（3）检查凭据：长连接模式请核对 Bot ID 和 Secret

（4）检查网络连接：确保电脑能够正常访问网络

2、长连接注册失败怎么办？

（1）确认企业微信侧已选择「使用长连接」

（2）重新复制 Bot ID 和 Secret，避免带入多余空格

（3）如 Secret 已失效，可在企业微信后台重新获取后再次注册