WorkBuddy 操作部署指南

本指南将帮助您通过WorkBuddy的「微信客服号集成」能力将WorkBuddy接入微信，让您可以直接在微信中给电脑上的WorkBuddy发送任务，并接收执行进度与结果。 前提条件 在开始之前，请确保您已满足以下条件： ⚫已在电脑上安装并登录WorkBuddy⚫已开启Claw远程控制功能⚫手机上已经登录一个可正常使用的微信账号 提示 微信接入无需额外创建开放平台应用，也不需要填写App ID、App Secret等开发凭证。整个绑定流程都可以直接在WorkBuddy中完成。 1.打开微信客服号集成 1.1进入Claw设置 1.打开WorkBuddy2.点击右上角头像，进入「Claw设置」3.在集成列表中找到「微信客服号集成」 1.2等待绑定初始化 点击配置后，WorkBuddy会先创建一条用于绑定的客服会话，按钮会短暂显示为「绑定中...」。 2.扫码完成绑定 2.1使用微信扫描二维码 初始化完成后，页面会展示一个二维码。使用手机微信扫描该二维码，即可将当前微信账号与WorkBuddy绑定。 注意 二维码有时效限制。如果二维码过期或扫码失败，请重新点击「配置」生成新的二维码后再试。 2.2确认绑定成功 扫码完成后，WorkBuddy会展示当前已绑定的微信头像和昵称，右侧状态会变为「已绑定」。 如果后续需要更换账号，也可以在这里点击「解绑」后重新绑定。 3.开始使用 绑定完成后，您就可以直接在微信里和WorkBuddy对话，例如： ⚫帮我总结今天桌面上最新的会议记录⚫帮我检查这个项目最近改过的接口有没有明显问题⚫帮我生成一个登录页原型 WorkBuddy会在电脑上自动执行任务，并把执行过程和最终结果同步回微信聊天窗口。 恭喜 如果您已经能在微信里收到WorkBuddy的执行结果，说明微信接入已经完成。 常见问题 1.确认电脑上的WorkBuddy正在运行，且网络连接正常2.关闭当前配置窗口后重新进入「微信客服号集成」3.如果问题仍然存在，重启WorkBuddy后重新绑定 1.确认扫码使用的是您希望绑定的微信账号 2.等待几秒钟让绑定状态同步 3.如果二维码已经失效，请重新生成二维码后再次扫码 微信里发消息没有响应怎么办？ 1.确认电脑上的WorkBuddy仍在运行，且Claw服务未关闭 2.返回「Claw设置」检查微信客服号集成状态是否仍为「已绑定」 3.如有必要，可先解绑后重新扫码绑定 WorkBuddy接入企业微信指南 本指南将帮助您在企业微信中配置WorkBuddy智能机器人，让您可以通过企业微信随时随地远程操控电脑上的WorkBuddy完成编程任务。 前提条件 在开始之前，请确保您已满足以下条件： ⚫已在电脑上安装WorkBuddy，并开启了Claw远程控制功能 ⚫拥有一个可创建智能机器人的企业微信账号 可根据您的账号角色选择不同入口： ⚫管理员：在企业微信管理后台依次点击「管理工具」→「智能机器人」→「创建机器人」，再选择「API模式创建」⚫普通成员：在企业微信客户端依次点击「工作台」→「智能机器人应用」→「创建机器人」→「手动创建」→「API模式创建」 提示 如果您还没有企业微信账号，可以前往企业微信官网免费注册一个企业。 1.创建企业微信智能机器人 1.1选择创建入口 请根据您的账号角色选择对应入口： 1.管理员：打开浏览器，访问企业微信管理后台，使用管理员账号登录后，依次点击「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」 2.普通成员：打开企业微信客户端，进入「工作台」→「智能机器人应用」→「创建机器人」 1.2进入API模式创建流程 进入机器人创建页面后，按以下方式切换到API模式： 1.管理员：在创建页面直接选择「API模式创建」 2.普通成员：如果先进入AI自动生成页面，请点击左下角的「手动创建」，再选择「API模式创建」 以下截图主要以管理后台页面为例，不同入口的界面文案可能略有差异，但后续配置项一致。 进入API模式页面后，请先完成机器人名称、可见范围等公共信息，并点击页面底部的「保存」；保存后，再继续选择具体的接入方式。 关于API模式 企业微信API模式支持两种接入方式，推荐优先使用长连接模式： ⚫长连接模式（推荐）：在WorkBuddy中填写Bot ID和Secret即可完成绑定，配置更简单，无需回填Webhook URL ⚫URL回 调 模 式： 适 用 于 需 要Webhook回 调 的 场 景 ； 需 在WorkBuddy中 填写Token和Encoding-AESKey，生成Webhook URL后再回填到企业微信 下文主流程以长连接模式为例，URL回调模式放在文末作为备选方案。 2.完成长连接接入前的公共配置 2.1填写机器人基本信息 在继续配置长连接之前，请先完成以下公共配置： 配置项说明机器人名称建议填写容易识别的名字，如「WorkBuddy助手」可见范围选择哪些员工、部门或标签可以使用这个机器人 2.2设置可见范围 点击「可见范围」后的「添加」，选择需要使用机器人的成员、部门或标签。 完成以上配置后，请先点击页面底部的「保存」，再在右侧「API配置」区域选择「使用长连接」。 3.使用长连接接入 推荐优先使用长连接模式。它的配置步骤更少，也不需要回填Webhook URL。 3.1在企业微信中获取Bot ID和Secret 1.在「API配置」区域选择「使用长连接」2.复制Bot ID3.点击点击获取获取Secret，并妥善保存 提示 长连接模式不需要再填写URL、Token或Encoding-AESKey。 1.打开WorkBuddy，点击右上角头像菜单中的「Claw设置」 2.在「集成（BETA）」区域找到「企微AIBot集成」，点击「配置」 3.在弹窗中选择「WebSocket长连接」，填入刚才复制的Bot ID和Secret 4.点击「注册」完成绑定 4.开始使用 配置完成后，您就可以在企业微信中直接与机器人对话了。 4.1找到机器人 在企业微信通讯录的「企业创建的」分组下找到刚刚创建的机器人，点击「发消息」即可开始下发任务。 4.2联通后对话效果 发送一条简单消息（例如“你好”）进行联通测试。如果配置正确，WorkBuddy会接收到消息并在企业微信中返回回复。 恭喜 如果机器人能够正常回复，说明您已成功完成WorkBuddy与企业微信的对接！ 5.备选方案：使用URL回调接入 如果您已经在使用Webhook配置，或因网络、部署限制需要通过URL回调接入，可按以下步骤操作。 5.1在企业微信中生成回调凭据 1.在「API配置」区域选择「使用URL回调」 2.点击Token和Encoding-AESKey输入框右侧的「随机获取」 3.保存这两个参数，后续需要在WorkBuddy中使用 重要 请务必保存好Token和Encoding-AESKey，否则后续无法完成注册。 5.2在WorkBuddy中生成Webhook URL 1.打开WorkBuddy，进入「Claw设置」→「企微AIBot集成」→「配置」 2.在注册弹窗中切换到「使用URL回调」 3.填入刚才获取的Token和Encoding-AESKey，点击「注册」 4.注册成功后，复制生成的Webhook URL 5.3回填URL并保存 回到企业微信的机器人创建页面： 1.将刚才复制的Webhook地址粘贴到URL输入框 常见问题 机器人没有响应怎么办？ 请按以下步骤排查： 1.检查WorkBuddy状态：确保电脑上的WorkBuddy正在运行，且Claw服务已开启 2.核对接入方式：确认企业微信与WorkBuddy中选择的是同一种接入方式 3.检 查 凭 据： 长 连 接 模 式 请 核 对Bot ID和Secret；URL回 调 模 式 请 核对Token和Encoding-AESKey 4.检查网络连接：确保电脑能够正常访问网络 URL验证失败怎么办？ 1.确保WorkBuddy处于运行状态 2.检查Claw服务是否已正常启动 3.重新复制Webhook URL，确保没有遗漏或多余字符 4.确认Token和Encoding-AESKey与WorkBuddy中配置的完全一致 长连接注册失败怎么办？ 1.确认企业微信侧已选择「使用长连接」 2.重新复制Bot ID和Secret，避免带入多余空格 3.如Secret已失效，可在企业微信后台重新获取后再次注册 WorkBuddy接入QQ指南 本指南将帮助您将WorkBuddy接入QQ，让您可以通过QQ随时随地远程操控电脑上的 WorkBuddy完成任务。 前提条件 在开始之前，请确保您已满足以下条件： ⚫已在电脑上安装WorkBuddy，并开启了Claw远程控制功能⚫拥有一个已完成实名认证的QQ账号 提示 QQ开放平台要求账号完成实名认证。如未认证，请先在QQ中完成实名认证后再进行后续操作。 1.注册QQ开放平台账号 如果您是首次使用QQ开放平台，需要先完成账号注册和入驻。 1.1访问开放平台 打开浏览器，访问QQ开放平台，点击注册或登录。 1.2设置超级管理员 按照页面提示，为平台设置超级管理员。您可以设置自己或其他人为管理员。 1.3填写主体信息 根据您的实际情况，选择主体类型（企业、个体户或个人）并填写相关信息。以下以个人开发者为例： 1.4完成入驻 提交信息后，完成审核和人脸识别验证，即可成功入驻QQ开放平台。 2.创建QQ机器人 2.1登录开放平台 使用已注册的账号扫码登录QQ开放平台。 2.2选择创建机器人 在资源类型选择页面，点击「机器人」选项。 2.3填写机器人信息 填写机器人的基本信息： 配置项说明 名称机器人的显示名称，建议不要包含特殊符号 头像上传一个机器人头像 描述简单描述机器人的功能 2.4提交审核 确认信息无误后，点击提交。 注意 机器人名称中不要包含特殊符号，否则可能导致创建失败。 2.5等待审核通过 提交后，机器人会出现在您的应用列表中，等待审核通过即可使用。 3.获取应用凭证 3.1进入机器人配置页面 审核通过后，点击机器人图标进入配置页面。 3.2获取AppID和AppSecret 1.在左侧菜单中点击「开发管理」2.复制页面上显示的AppID3.点击AppSecret旁边的「生成」按钮，获取密钥 重要提示 AppSecret只会显示一次，请务必立即保存 如果忘记AppSecret，需要重新生成，之前的密钥会失效 4.在WorkBuddy中配置QQ 将获取的凭证配置到WorkBuddy中： 1.打开WorkBuddy，进入Claw设置2.选择QQ集成3.填入刚才获取的AppID和AppSecret4.点击保存 保存成功后，系统会生成Webhook地址，用于下一步配置。 5.获取并配置Webhook 5.1复制Webhook地址 在WorkBuddy的Claw设置中，找到系统生成的Webhook地址，点击复制。 5.2配置QQ机器人回调地址 1.返回QQ机器人后台2.选择需要配置的机器人 提示 如果您创建了多个机器人，请确保选择正确的机器人进行配置。 3.访问Webhook设置页面 4.在「请求地址」输入框中粘贴Webhook地址 注意 粘贴时需要去掉URL开头的https://，只保留域名和路径部分。 5.点击确认保存配置 5.3添加消息权限 在回调配置页面，勾选所有「单聊」相关的权限，确保机器人能够接收和发送消息。 6.开始使用 配置完成后，您可以通过以下方式开始使用： 6.1进入沙箱测试 1.访问沙箱配置页面 2.点击「沙箱配置」，然后扫描消息