RoxyClaw 配置教程

提示

RoxyClaw 是 Roxy浏览器的 AI 机器人助手，可通过 Telegram 或飞书/Lark 接收指令并执行已授权任务。如果您在客户端中找不到 RoxyClaw，说明当前版本、账户或所在地区还没有开通该功能。

使用前准备

开始配置前，请确认：

• Roxy浏览器和所需浏览器内核已经更新。
• 当前团队已开通 RoxyClaw，并授予您相应权限。
• Roxy浏览器客户端在任务期间保持登录和运行。
• 已准备一个测试账号，用于验证远程操作。

在 RoxyClaw 页面点击右上角的启动 RoxyClaw进入配置流程。

连接 Telegram

Telegram 配置步骤较少，适合先完成基础验证。

第 1 步：创建机器人

1. 在 Telegram 中搜索官方机器人 @BotFather。
2. 发送 /newbot。
3. 按提示设置机器人显示名称。
4. 设置以 bot 结尾的机器人用户名，例如 my_roxy_bot。

第 2 步：保存 Bot Token

机器人创建成功后，BotFather 会返回 HTTP API Token。复制 Token 并保存到安全位置，不要发送到群聊、工单或截图中。

凭证安全

Bot Token 可以控制您的 Telegram 机器人。若 Token 泄露，请立即在 BotFather 中撤销并重新生成，再更新 RoxyClaw 配置。

第 3 步：填写 RoxyClaw 配置

1. 返回 RoxyClaw 的 Telegram 配置页。
2. 将 Bot Token 粘贴到对应字段。
3. 按页面提示打开机器人会话并获取 Chat ID。
4. 将 Chat ID 填入对应字段并保存。

第 4 步：测试连接

在 Telegram 中向机器人发送一条低风险测试消息，例如“列出当前可用功能”。确认机器人能收到消息并返回结果后，再测试打开一个非正式账号。

连接飞书 / Lark

飞书/Lark 需要创建企业自建应用，适合由团队管理员配置。

第 1 步：创建自建应用

1. 打开飞书开放平台开发者后台。
2. 使用有权限的管理员账号登录。
3. 点击创建自建应用，填写应用名称和描述。

第 2 步：开启机器人能力

进入应用详情页，在「添加能力」中开启机器人。

第 3 步：配置事件与权限

在「事件订阅」中添加：

im.message.receive_v1

在「权限管理」中申请：

im:message
im:message:send_as_bot

不同飞书/Lark 版本的权限名称可能略有差异。如果找不到同名权限，请搜索「接收消息」和「以应用身份发送消息」，再按开放平台的权限说明选择。

第 4 步：发布应用

创建应用版本并按企业流程提交审核或发布。应用未发布、未安装到目标组织或权限未批准时，机器人无法正常收发消息。

第 5 步：填写应用凭证

在「凭证与基础信息」中复制 App ID 和 App Secret，填入 RoxyClaw 的飞书/Lark 配置页并保存。

凭证安全

App Secret 属于敏感凭证。不要写入公开文档、聊天消息或代码仓库；泄露后应立即在开放平台重置。

第 6 步：测试连接

在飞书/Lark 中向机器人发送低风险测试消息，确认消息接收和回复正常。若无响应，请依次检查应用是否发布、机器人是否安装、事件是否订阅、权限是否通过以及凭证是否正确。

日常使用

配置完成后，可以从消息平台提交清晰、范围明确的任务，例如：

• “列出当前可以访问的账号。”
• “启动测试分组中的第一个账号。”
• “在测试账号中打开指定网址，并返回页面标题。”
• “采集当前页面的公开商品信息并生成表格草稿。”

首次执行新类型任务时，只选择一个测试账号。确认结果符合预期后，再逐步扩大账号范围。

停止使用或更换负责人

不再使用某个平台时，应在 RoxyClaw 中关闭对应集成，并在 Telegram BotFather 或飞书开放平台撤销旧凭证。团队成员离职时，还应在团队管理中回收其分组和 AI 功能权限。

注意事项

远程指令可能影响多个账号。涉及发布、删除、支付、修改登录信息或批量操作时，应明确目标范围，并在执行前保留人工确认。