更新时间:2026-11-16 GMT+08:00
分享

通讯软件集成

飞书集成

本指南将帮助您为果办OfficeAce集成飞书机器人。集成后,您可以通过飞书随时随地与果办OfficeAce进行对话、下发任务(如远程操控电脑执行代码)等。

运作机制:

飞书集成的消息流转路径为:用户在飞书中发送消息 → 飞书服务器通过长连接将消息推送到果办OfficeAce → 果办OfficeAce调用模型进行处理 → 处理结果返回飞书并展示给用户。

步骤一:在果办OfficeAce集成飞书

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“飞书”。
  4. 单击生成二维码按钮,等待二维码生成后,手机使用飞书App扫描二维码,按照飞书提示完成授权对接。

步骤二:在飞书中和果办OfficeAce对话

对接完成后,手机飞书App中会出现一个对话窗口,通过飞书的聊天窗直接和果办OfficeAce对话。如图1所示,在果办OfficeAce的会话列表中出现来自飞书的会话记录,表示对接成功。

图1 在飞书中和果办OfficeAce对话

步骤三:配置个人白名单

当您在飞书群聊中使用果办OfficeAce控制本地电脑时,为了防止他人误操作或恶意控制,请务必开启个人白名单功能。

如果不开启白名单,群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑,存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“飞书”。
  4. 在个人白名单区域,如图2所示,填入open_id和备注(如用户姓名),单击“添加”。

    open_id是飞书中用户的唯一标识,每个用户对应一个open_id。获取方式:在飞书中@机器人,发送/myid即可获取您的open_id。

    图2 配置个人白名单

    设置完成后,群聊内只有您本人“@机器人”才会触发回复。其他成员@机器人的消息将被系统自动忽略,以此确保操作权限的唯一性与安全性。

常用指令

果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表1所示。

表1 特殊前缀指令

命令

说明

/new

新建未命名会话。

/new 标题

新建名为标题的会话。

/where

返回当前所在的会话。

/threads

显示所有会话编号和会话主题。

/use 会话编号

切换到编号对应的会话。

微信集成

本指南将帮助您为果办OfficeAce集成微信Bot。集成后,您可以通过微信给果办OfficeAce下达工作指令并进行对话,实现移动端随时随地的智能体交互。

运作机制:

微信集成的消息流转路径为:用户在微信中发送消息 → 微信ClawBot接收消息并转发至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回微信ClawBot并展示给用户。

前提条件—微信集成

  • 将微信升级至最新版本。
  • 在“设置 > 插件”中检查是否具备“微信ClawBot”功能,如果不具备,请将微信更新至最新版本后重新检查。
图3 升级微信版本、检查微信ClawBot

如果您使用的是HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机、平板等,微信ClawBot功能暂不支持此类设备,请使用其他通讯软件(如飞书、钉钉、小艺)对接,具体请参见飞书集成、钉钉集成、小艺集成。

步骤一:在果办OfficeAce集成微信

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“微信”。
  4. 单击生成二维码按钮,等待二维码生成后,使用微信扫描对接。对接完成后您就可以使用微信与果办OfficeAce进行对话。

步骤二:在微信中和果办OfficeAce对话

对接完成后,在微信聊天列表会多出一个“微信ClawBot”的新联系人,通过微信ClawBot的聊天窗直接和果办OfficeAce对话。如图4所示,在果办OfficeAce的会话列表中出现来自微信的会话记录,表示对接成功。
图4 和果办OfficeAce对话

常用指令

果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表2所示。

表2 特殊前缀指令

命令

说明

/new

新建未命名会话。

/new 标题

新建名为标题的会话。

/where

返回当前所在的会话。

/threads

显示所有会话编号和会话主题。

/use 会话编号

切换到编号对应的会话。

钉钉集成

本指南将帮助您为果办OfficeAce集成钉钉。集成后,您可以通过钉钉给果办OfficeAce下达指令并进行对话,实现移动端随时随地的智能体交互。

  • 使用场景:当您不在电脑旁但仍需使用果办OfficeAce处理任务时,通过钉钉集成可以随时随地通过手机与果办OfficeAce对话,如在外出时安排日程、分析数据、生成报告等。
  • 运作机制:钉钉集成的消息流转路径为:用户在钉钉中发送消息 → 钉钉服务器将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回钉钉并展示给用户。

步骤一:创建钉钉机器人

本步骤内容仅供参考,实际请以钉钉文档为准。

  1. 创建应用。

    1. 登录钉钉开发者后台。

      创建钉钉应用需要钉钉账号有开发者权限。请提前联系组织管理员获取钉钉开放平台的开发权限,具体操作请参见获取开发者权限。

    2. 在左侧导航栏中,选择“钉钉应用”,在钉钉应用页面单击“创建应用”。

    3. 在弹出的窗口中填写“应用名称”、“应用描述”后,单击“保存”。
      图5 创建应用

  2. 添加机器人能力。应用创建成功后,会自动跳转至“添加应用能力”页面,选择添加机器人。

    图6 添加机器人

  3. 配置机器人信息。打开机器人配置,填写以下信息。

    表3 参数说明

    参数

    说明

    机器人名称

    机器人在钉钉中显示的名称

    机器人简介

    简要描述机器人的功能,便于用户了解用途

    机器人描述

    详细描述机器人的能力和使用方式

    消息预览图

    上传一张机器人消息预览图

    图7 配置机器人信息

  4. 发布机器人。配置完成后,在页面下方单击“发布”。

    图8 发布机器人

  5. 配置应用权限。

    为保证机器人能正常收发消息,需要在“权限管理”中配置相关权限。

    依次搜索并开通以下权限:Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。权限说明如表4所示。

    表4 权限说明

    权限名称

    用途

    Card.Streaming.Write

    允许机器人发送流式卡片消息,用于实时展示回复内容

    Card.Instance.Write

    允许机器人创建和更新交互式卡片,用于消息展示和交互

    qyapi_robot_sendmsg

    允许机器人通过API发送消息,用于向用户推送回复

    图9 开通机器人权限

  6. 创建并发布应用版本。

    1. 在左侧导航栏中选择“版本管理与发布”,并“创建新版本”。
      图10 创建新版本
    2. 填写版本号、版本描述,并选择应用可用范围后单击“保存”并按提示进行发布。
      图11 发布版本

  7. 获取应用凭证。

    在“凭证与基础信息”页面获取Client ID、Client Secret,用于步骤二:在果办OfficeAce集成钉钉配置果办OfficeAce的对接信息。

    Client ID和Client Secret是钉钉应用的鉴权凭证。在步骤二:在果办OfficeAce集成钉钉中,Client ID对应填写至“App Key”字段,Client Secret对应填写至“App Secret”字段。

    Client Secret属于敏感凭证,请妥善保管,切勿泄露或提交至公开代码仓库。

    图12 获取凭证信息

步骤二:在果办OfficeAce集成钉钉

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“钉钉”。
  4. 填写步骤一:创建钉钉机器人中获取的Client ID填写至“App Key”、将Client Secret填写至“App Secret”。
  5. 填写完成后单击“测试连接”,连接成功后单击“保存配置”。

    如果测试连接失败,请检查:①Client ID和Client Secret是否填写正确且未多余空格;②钉钉应用是否已成功发布;③三项权限是否已全部开通。

步骤三:配置个人白名单

当您在飞书群聊中使用果办OfficeAce控制本地电脑时,为了防止他人误操作或恶意控制,请务必开启个人白名单功能。

如果不开启白名单,群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑,存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“飞书”。
  4. 在个人白名单区域,如图13所示,填入open_id和备注(如用户姓名),单击“添加”。

    open_id是飞书中用户的唯一标识,每个用户对应一个open_id。获取方式:在飞书中@机器人,发送/myid即可获取您的open_id。

    图13 配置个人白名单

    设置完成后,群聊内只有您本人“@机器人”才会触发回复。其他成员@机器人的消息将被系统自动忽略,以此确保操作权限的唯一性与安全性。

常用指令

果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表5所示。

表5 特殊前缀指令

命令

说明

/new

新建未命名会话。

/new 标题

新建名为标题的会话。

/where

返回当前所在的会话。

/threads

显示所有会话编号和会话主题。

/use 会话编号

切换到编号对应的会话。

小艺集成

本指南将帮助您在果办OfficeAce中集成小艺智能助手。集成后,无论您使用的是手机还是平板,都能通过小艺APP,以语音或手动输入的方式,轻松体验跨终端的任务执行。

  • 使用场景:当您在移动场景下需要通过语音快速操作果办OfficeAce时,例如开车时语音安排日程、开会间隙用手机生成报告,小艺集成让您无需打字即可完成办公任务。
  • 运作机制:小艺集成的消息流转路径为:用户通过小艺APP发送语音/文字消息 → 小艺开放平台将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回小艺并展示给用户。

前提条件—小艺集成

已具备HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机或平板。

步骤一:创建小艺智能体

本步骤内容仅供参考,实际请以小艺开放平台文档为准。

  1. 创建或选择智能体。

    登录小艺开放平台,选择已有智能体。如果没有智能体,请单击“新建智能体”创建新智能体。
    图14 新建智能体

  2. 配置智能体基本信息。

    在创建智能体界面中,滚动鼠标,在界面右侧区域依次配置智能体基本信息,参数说明如表6所示,配置完成后单击“确认创建”。

    以配置智能体开发模式为例,配置区域如图15所示。
    图15 配置智能体开发模式
    表6 参数说明

    参数

    说明

    是否必填

    示例

    开发模式

    选择智能体的开发模式。

    此处选择OpenClaw模式。OpenClaw模式是一种开放灵活的智能体接入与构建方式,开发者可通过该模式接入OpenClaw工具 ,快速创建个性化智能体。该模式适用于个性化助手、自动化服务、场景化应用等多样化需求。

    是

    OpenClaw模式

    智能体名称

    智能体的标识名称。

    是

    xiaoyi-clawee

    一句话描述

    简要描述智能体功能。

    是

    AI办公助手

    支持的设备和系统

    选择智能体支持的设备类型和系统版本。

    是

    手机-HarmonyOS、手机-HarmonyOS Next

  3. 选择编排模式并获取凭证。

    1. 进入智能体界面后,选择编排模式为“OpenClaw”模式。根据当前是否已有可用凭证,后续操作有所不同。
      • 未创建过凭证:单击“点击新建凭证”,如图16所示。
        图16 新建凭证
      • 已创建过凭证但未及时保存密钥:可单击“小艺开放平台凭证”重新创建,如图16所示。
        图17 重新创建凭证
    2. 在弹出的“新建凭证”对话框中,输入Key名称,例如“01”,服务平台选择“Web端(JS API)”,创建完成后单击“保存”,保存后界面如图18所示,单击复制Key和安全密钥,并记录保存,保存后单击“关闭窗口”。

      凭证创建成功后,密钥仅在弹窗内临时展示。请务必及时复制Key(即Access Key,简称AK)和安全密钥(即Secret Key,简称SK)并妥善保存,关闭弹窗后无法再次查看。

      • Secret Key属于敏感凭证,请勿泄露。
      • 如果凭证可能已泄露,请立即在小艺开放平台重新创建凭证,重新创建后原凭证将立即失效,已使用原凭证的服务需同步更新。
      图18 新建凭证

  4. 获取Agent ID并配置小艺智能体开场白。

    复制并记录agentId,并配置智能体的开场白,例如“我是您的办公助手,帮您轻松应对各种办公场景。”,如图19中的①②所示。
    图19 配置开场白

  5. 配置测试白名单。

    1. 在左侧导航,选择“测试白名单”,单击界面右上方的“新建用户组”,在弹出的弹框中输入用户组名例如“01”,输入完成后单击“保存”,保存后如图20所示。
      图20 创建用户组
    2. 在用户组所属的操作列,单击“管理用户”,在弹出的弹框中单击“邀请用户”,输入用户手机号码或邮箱,如图21所示,输入完成后单击“确定”,并根据界面提示完成后续弹框信息的确认。
      图21 邀请白名单用户

  6. 上架智能体。

    勾选用户组,单击界面右上方的“上架”,在弹出的对话框中单击“发布真机测试”,如图22的①②③所示。
    图22 上架智能体

步骤二:在果办OfficeAce集成小艺

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“小艺”。
  4. 填写应用凭证,具体如下,填写完成后单击“测试连接”,连接成功后单击“保存配置”。

    如果测试连接失败,请检查:①Agent ID、AK、SK是否填写正确且无多余空格;②小艺智能体是否已成功上架;③凭证的服务平台是否选择了“Web端(JS API)”。

    • Agent ID:请填写步骤4中获取的agentId。
    • Access Key (AK):请填写步骤3中获取的Key。
    • Secret Key (SK):请填写步骤3中获取的安全密钥。

步骤三:在小艺中和果办OfficeAce对话

  1. 在用户终端(例如手机)打开小艺APP,在小艺APP的对话列表中,找到步骤一创建的智能体,如图23所示。

    图23 查找智能体

  2. 单击智能体,通过聊天窗直接和果办OfficeAce对话,支持语音和手动输入。如图24所示,果办OfficeAce中显示来自小艺的会话信息,表示对接成功。

    如需指定某个智能体处理任务,可以直接输入@+智能体名称,指定智能体进行对话。

    图24 在小艺中和果办OfficeAce对话

常用指令

果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表7所示。

表7 特殊前缀指令

命令

说明

/new

新建未命名会话。

/new 标题

新建名为标题的会话。

/where

返回当前所在的会话。

/threads

显示所有会话编号和会话主题。

/use 会话编号

切换到编号对应的会话。

企业微信集成

当您在企业环境中使用企业微信办公时,通过集成可以在企业微信中直接与果办OfficeAce对话,无需切换应用。

运作机制:

企业微信集成的消息流转路径为:用户在企业微信发送消息 → 企微云平台通过长连接将消息推送到果办OfficeAce → 果办OfficeAce调用智能体处理 → 处理结果流式推回企业微信展示给用户。

前提条件

  • 果办OfficeAce:已安装1.8.0及以上版本的果办OfficeAce。
  • 企业微信账号:拥有一个可创建智能机器人的企业微信账号。

步骤一:在果办OfficeAce绑定企业微信智能机器人

果办OfficeAce提供两种绑定方式,您可以根据实际需求选择其一。

方式一:快速扫码

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“企业微信”。
  4. 选择“快速扫码”。
  5. 单击“生成二维码”,等待二维码生成后,使用企业微信扫描对接。

    扫码后,可选择以下两种操作之一完成绑定:
    • 创建智能机器人:依次单击“一键创建智能机器人”、“确认授权”,完成对接后单击“前往使用”即可与果办OfficeAce进行对话。

      可在图27修改智能机器人的名称。

      图25 创建智能机器人
      图26 确认授权
      图27 创建完成
    • 绑定已有智能机器人:单击“绑定已有智能机器人”,选择需要绑定的机器人后单击“确认授权”,完成对接后单击“前往使用”即可与果办OfficeAce进行对话。
      图28 绑定已有机器人
      图29 选择需绑定的机器人
      图30 确认授权
      图31 绑定完成

方式二:手动配置

前置准备:获取企业微信智能机器人的Bot ID和Secret。

  • 新建智能机器人

    通过API模式(长连接)创建的智能机器人,支持被动回复多条消息、主动向用户发消息,支持接收/发送“文字、图片、图文混排、音频、视频、文件”格式消息。

    本步骤内容仅供参考,实际请以企业微信文档为准。

    1. 打开企业微信客户端,进入“工作台 > 智能机器人”,单击“创建机器人 > 手动创建”。
    2. 进入创建页面后,选择“API模式创建”。
    3. 在API配置页面,选择连接方式为“使用长连接”。
    4. 配置完成后,页面将自动生成并展示Bot ID和Secret,妥善保存该信息。
    5. 补充配置机器人可见范围,其余项保持默认即可,API模式暂不支持预览与调试,直接保存机器人配置。
  • 已有机器人

    本步骤内容仅供参考,实际请以企业微信文档为准。

    1. 打开企业微信客户端,进入“通讯录 > 智能机器人”。
    2. 进入目标机器人详情页,单击“API设置”,即可查看并复制Bot ID和Secret;

在果办OfficeAce中配置:

  1. 登录果办OfficeAce。
  2. 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
  3. 在通讯软件列表中选择“企业微信”。
  4. 选择“手动配置”。
  5. 输入智能机器人的Bot ID和Bot Secret,填写完成后单击“测试连接”,连接成功后单击“保存”完成对接。

步骤二:在企业微信中和果办OfficeAce对话

绑定完成后,在企业微信中找到果办OfficeAce集成的机器人的单聊或群聊入口。

在单聊中直接发送消息与果办OfficeAce对话。

在群聊中通过@机器人发送消息,果办OfficeAce智能体处理后将流式回复。

在果办OfficeAce的会话列表中会出现来自企业微信的会话记录,表示对接成功。

常用指令

果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表8所示。

表8 特殊前缀指令

命令

说明

/new

新建未命名会话。

/new 标题

新建名为标题的会话。

/where

返回当前所在的会话。

/threads

显示所有会话编号和会话主题。

/use 会话编号

切换到编号对应的会话。

相关文档