ZeroClaw集成消息通道

更新时间:
复制为 MD 格式

本文介绍如何将ZeroClaw服务集成到钉钉、飞书、QQ等消息通道,实现在群聊或单聊中通过自然语言直接与ZeroClaw交互。

前提条件

配置消息渠道前,需参考以下步骤或部署ZeroClaw镜像文档购买并配置ZeroClaw应用镜像的轻量应用服务器,若已完成可跳过此步骤。

购买并配置ZeroClaw应用镜像的轻量应用服务器

步骤一、购买ZeroClaw套餐

重要

如果已购买轻量应用服务器,可以跳过此步骤,以重置系统的方式部署ZeroClaw(重置系统时选择应用镜像下的ZeroClaw镜像),但重置系统会清除轻量应用服务器上的系统盘数据,请根据需要做好数据备份。具体操作,请参见重置系统

  1. 购买预装ZeroClaw应用的轻量应用服务器

  2. 轻量应用服务器页面,预置了资源配置,如要更改配置项,请参考下面内容。

    • 实例:内存必须2GiB及以上,可以根据需求切换套餐。

    • 地域:默认北京

    • 购买配置:默认12个月,可以根据自己的需求切换时长。

步骤二、配置ZeroClaw

  1. 轻量应用服务器-控制台,单击服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. ZeroClaw使用步骤区域中,单击端口放通下的一键放通,可开放ZeroClaw服务运行端口的防火墙。

    重要
    • 为了防止恶意扫描与定向攻击,ZeroClaw 在初始化时不使用固定的默认端口,而是自动生成一个随机端口,可在控制台查看ZeroClaw的端口号

  3. 单击配置ZeroClaw下的初始化配置百炼API key。

    目前支持配置两种类型的百炼API Key:

    • Coding Plan 套餐专属 API Key(推荐):采用固定月费模式,提供月度请求额度,超出时段限额的调用会报错且不计费用,可避免产生超出预期的费用。

      Coding Plan 目前支持 qwen3.5-pluskimi-k2.5MiniMax-M2.5glm-5等模型。
    • Token用量计费的百炼API Key。

    API Key配置方式包括系统推荐手动输入。系统推荐会列出百炼Coding PlanAPI Key(成本可控),及离服务器最近的百炼模型服务的API Key(时延较低)。若需使用其他地域或者其他账号的API Key可选择手动输入。

    • 系统推荐(下拉选择)

      选择完成后单击下一步

      轻量应用服务器所在地域

      系统推荐的百炼API Key对应地域

      Coding PlanAPI key对应地域

      中国内地地域

      华北2(北京)

      华北2(北京)

      美国及欧洲地域

      美国(弗吉尼亚)

      中国香港及其他亚洲地域

      新加坡

    • 手动输入

      单击按钮切换至手动输入,输入百炼API Key并选择该API Key对应地域,单击下一步

      image

      重要

      手动配置需确保选择的API Key对应地域正确,否则会导致模型无法正常调用。

  4. 访问WebUI面板。

    1. 访问WebUI面板区域下的生成Pairing Code区域单击执行命令,获取并复制ZeroClaw WebUI的配对码。

    2. 访问Web UI面板区域下的获取WebUI面板地址单击执行命令,获取并访问网站地址并输入配对码,即可与 ZeroClaw 的 Agent 对话。

控制台支持与多种主流消息渠道集成。

集成钉钉

本节介绍如何将ZeroClaw与钉钉集成,实现在钉钉群聊或单聊中与ZeroClaw交互。

1. 创建钉钉应用

  1. 选择或创建组织。

    选择组织

    访问钉钉开放平台,登录时会出现如下提醒。请选择有开发者权限的组织,或者选择某个组织后,获取开发者权限

    image

    创建组织

    若无可用组织,请使用钉钉移动端钉钉扫描下方二维码,会跳转至创建组织页面创建一个新组织。

    image

    钉钉移动客户端版本需≥6.5.45。
  2. 访问钉钉开放平台,在开发者后台,在一键自动创建OpenClaw机器人处点击立即创建。image.png

  3. 平台已自动预设OpenClaw机器人信息,可根据业务需要修改配置后,单击确定进行创建。

    如需创建多个应用建议在创建时修改机器人名称或者图标,方便后续区分。

    image.png

  4. 在创建成功后,复制并保存应用的Client IDClient Secret。

    窗口关闭后仍可进入已创建的应用在左侧导航栏单击凭证与基础信息中查看Client IDClient Secret。

    image.png

2. 在轻量应用服务器控制台配置钉钉应用

  1. 返回轻量应用服务器-控制台,单击配置了Zeroclaw的服务器卡片中的实例ID,在服务器概览页面单击应用详情页签。

  2. 通道配置 > 钉钉中填入复制的钉钉应用的Client IDClient Secret,并单击应用,等待命令执行成功。

3. 测试机器人

你可以创建群聊或在已有群聊中添加机器人,在钉钉群中@机器人进行对话,或通过搜索的方式与机器人私聊进行测试。

群聊

  1. 进入钉钉群群设置页面,点击机器人卡片区域,在机器人管理页面,点击添加机器人。在添加机器搜索文本框中输入目标机器人名称,并选中要添加的机器人。点击添加,完成后再点击完成添加image

  2. 在钉钉群中@机器人进行交流互动。也可以在钉钉的搜索栏中,输入机器人名称后,在功能页检索到对应机器人,进行私聊互动。

私聊

  1. 在钉钉上方搜索框中搜索创建的机器人名称,并单击机器人的头像进行私聊。image

  2. 进入私聊页面后,直接与机器人对话即可。

集成飞书

本节介绍如何将ZeroClaw与飞书集成,实现在飞书群聊或单聊中与ZeroClaw交互。

1. 创建飞书应用

  1. 访问飞书开放平台,单击创建企业自建应用,填写应用名称和描述,选择应用图标,单击创建

  2. 左侧导航栏单击凭证与基础信息页面,复制App ID(格式如 cli_xxx)和App Secret

  3. 左侧导航栏单击 权限管理 页面,点击批量导入/导出权限 按钮,粘贴权限 JSON 配置,单击下一步,确认新增权限,单击申请开通

    JSON配置文件内容

    {
      "scopes": {
        "tenant": [
          "aily:file:read",
          "aily:file:write",
          "application:application.app_message_stats.overview:readonly",
          "application:application:self_manage",
          "application:bot.menu:write",
          "cardkit:card:write",
          "contact:user.employee_id:readonly",
          "corehr:file:download",
          "docs:document.content:read",
          "event:ip_list",
          "im:chat",
          "im:chat.access_event.bot_p2p_chat:read",
          "im:chat.members:bot_access",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.group_msg",
          "im:message.p2p_msg:readonly",
          "im:message:readonly",
          "im:message:send_as_bot",
          "im:resource",
          "sheets:spreadsheet",
          "wiki:wiki:readonly"
        ],
        "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
      }
    }
  4. 左侧导航栏中单击添加应用能力,选择按能力添加页签,找到机器人卡片,单击配置

  5. 配置事件订阅。

    1. 轻量应用服务器控制台,进入目标实例详情页,在应用详情 > 通道配置 > 飞书区域,填入之前获取的App IDApp Secret,并单击应用

    2. 在飞书开放平台左侧导航栏单击事件与回调,在事件配置页签中单击订阅方式,选择使用 长连接 接收事件,单击保存

    3. 在事件配置页面,单击添加事件,搜索事件im.message.receive_v1(接收消息),单击确认添加

  6. 版本管理与发布 页面创建版本,填写应用版本号更新说明,单击保存,提交审核并发布。

2. 配置机器人

可以创建群聊或在已有群聊中添加机器人,在飞书群中@机器人进行对话,或通过搜索的方式与机器人私聊进行测试。

若需在外部群中使用机器人,可参考配置文档机器人支持外部群和外部用户单聊
  1. 按照添加路径添加机器人:··· > 设置 > 群机器人 > 添加机器人

  2. 单击机器人头像,单击发送消息,可向机器人私发一条消息。

image

集成QQ

本节介绍如何将ZeroClawQQ集成,实现在QQ机器人单聊中与ZeroClaw交互。

1. 创建QQ机器人

  1. 前往腾讯QQ开放平台官网。在下方的龙虾专用入口单击去使用。image

  2. 在手机登录区域,扫描二维码登录QQ账号。

  3. 单击创建机器人,生成新的QQ机器人。保存机器人的AppIDAppSecret

    重要

    请妥善保管复制的密钥信息,QQ机器人的AppSecret(机器人密钥)不支持明文保存,首次查看或忘记AppSecret(机器人密钥)需要重新生成。

2. 在控制台配置channel

应用详情 > 通道配置 > QQ中填入创建机器人获取App IDApp Secret,单击应用

3. 方案验证

前往QQ与创建好的机器人对话。

image