通讯软件集成
飞书集成
本指南将帮助您为果办OfficeAce集成飞书机器人。集成后,您可以通过飞书随时随地与果办OfficeAce进行对话、下发任务(如远程操控电脑执行代码)等。
运作机制:
飞书集成的消息流转路径为:用户在飞书中发送消息 → 飞书服务器通过长连接将消息推送到果办OfficeAce → 果办OfficeAce调用模型进行处理 → 处理结果返回飞书并展示给用户。
步骤一:在果办OfficeAce集成飞书
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“飞书”。
- 单击生成二维码按钮,等待二维码生成后,手机使用飞书App扫描二维码,按照飞书提示完成授权对接。
步骤二:在飞书中和果办OfficeAce对话
对接完成后,手机飞书App中会出现一个对话窗口,通过飞书的聊天窗直接和果办OfficeAce对话。如图1所示,在果办OfficeAce的会话列表中出现来自飞书的会话记录,表示对接成功。
步骤三:配置个人白名单
当您在飞书群聊中使用果办OfficeAce控制本地电脑时,为了防止他人误操作或恶意控制,请务必开启个人白名单功能。
如果不开启白名单,群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑,存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“飞书”。
- 在个人白名单区域,如图2所示,填入open_id和备注(如用户姓名),单击“添加”。
open_id是飞书中用户的唯一标识,每个用户对应一个open_id。获取方式:在飞书中@机器人,发送/myid即可获取您的open_id。
设置完成后,群聊内只有您本人“@机器人”才会触发回复。其他成员@机器人的消息将被系统自动忽略,以此确保操作权限的唯一性与安全性。
常用指令
果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表1所示。
微信集成
本指南将帮助您为果办OfficeAce集成微信Bot。集成后,您可以通过微信给果办OfficeAce下达工作指令并进行对话,实现移动端随时随地的智能体交互。
运作机制:
微信集成的消息流转路径为:用户在微信中发送消息 → 微信ClawBot接收消息并转发至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回微信ClawBot并展示给用户。
前提条件—微信集成
- 将微信升级至最新版本。
- 在“设置 > 插件”中检查是否具备“微信ClawBot”功能,如果不具备,请将微信更新至最新版本后重新检查。
步骤一:在果办OfficeAce集成微信
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“微信”。
- 单击生成二维码按钮,等待二维码生成后,使用微信扫描对接。对接完成后您就可以使用微信与果办OfficeAce进行对话。
步骤二:在微信中和果办OfficeAce对话
常用指令
果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表2所示。
钉钉集成
本指南将帮助您为果办OfficeAce集成钉钉。集成后,您可以通过钉钉给果办OfficeAce下达指令并进行对话,实现移动端随时随地的智能体交互。
- 使用场景:当您不在电脑旁但仍需使用果办OfficeAce处理任务时,通过钉钉集成可以随时随地通过手机与果办OfficeAce对话,如在外出时安排日程、分析数据、生成报告等。
- 运作机制:钉钉集成的消息流转路径为:用户在钉钉中发送消息 → 钉钉服务器将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回钉钉并展示给用户。
步骤一:创建钉钉机器人
本步骤内容仅供参考,实际请以钉钉文档为准。
- 创建应用。
- 添加机器人能力。应用创建成功后,会自动跳转至“添加应用能力”页面,选择添加机器人。 图6 添加机器人
- 配置机器人信息。打开机器人配置,填写以下信息。
表3 参数说明 参数
说明
机器人名称
机器人在钉钉中显示的名称
机器人简介
简要描述机器人的功能,便于用户了解用途
机器人描述
详细描述机器人的能力和使用方式
消息预览图
上传一张机器人消息预览图
图7 配置机器人信息
- 发布机器人。配置完成后,在页面下方单击“发布”。 图8 发布机器人
- 配置应用权限。
为保证机器人能正常收发消息,需要在“权限管理”中配置相关权限。
依次搜索并开通以下权限:Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。权限说明如表4所示。
表4 权限说明 权限名称
用途
Card.Streaming.Write
允许机器人发送流式卡片消息,用于实时展示回复内容
Card.Instance.Write
允许机器人创建和更新交互式卡片,用于消息展示和交互
qyapi_robot_sendmsg
允许机器人通过API发送消息,用于向用户推送回复
图9 开通机器人权限
- 创建并发布应用版本。
- 在左侧导航栏中选择“版本管理与发布”,并“创建新版本”。 图10 创建新版本
- 填写版本号、版本描述,并选择应用可用范围后单击“保存”并按提示进行发布。
- 在左侧导航栏中选择“版本管理与发布”,并“创建新版本”。
- 获取应用凭证。 在“凭证与基础信息”页面获取Client ID、Client Secret,用于步骤二:在果办OfficeAce集成钉钉配置果办OfficeAce的对接信息。
Client ID和Client Secret是钉钉应用的鉴权凭证。在步骤二:在果办OfficeAce集成钉钉中,Client ID对应填写至“App Key”字段,Client Secret对应填写至“App Secret”字段。
Client Secret属于敏感凭证,请妥善保管,切勿泄露或提交至公开代码仓库。
图12 获取凭证信息
步骤二:在果办OfficeAce集成钉钉
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“钉钉”。
- 填写步骤一:创建钉钉机器人中获取的Client ID填写至“App Key”、将Client Secret填写至“App Secret”。
- 填写完成后单击“测试连接”,连接成功后单击“保存配置”。
如果测试连接失败,请检查:①Client ID和Client Secret是否填写正确且未多余空格;②钉钉应用是否已成功发布;③三项权限是否已全部开通。
步骤三:配置个人白名单
当您在飞书群聊中使用果办OfficeAce控制本地电脑时,为了防止他人误操作或恶意控制,请务必开启个人白名单功能。
如果不开启白名单,群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑,存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“飞书”。
- 在个人白名单区域,如图13所示,填入open_id和备注(如用户姓名),单击“添加”。
open_id是飞书中用户的唯一标识,每个用户对应一个open_id。获取方式:在飞书中@机器人,发送/myid即可获取您的open_id。
设置完成后,群聊内只有您本人“@机器人”才会触发回复。其他成员@机器人的消息将被系统自动忽略,以此确保操作权限的唯一性与安全性。
常用指令
果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表5所示。
小艺集成
本指南将帮助您在果办OfficeAce中集成小艺智能助手。集成后,无论您使用的是手机还是平板,都能通过小艺APP,以语音或手动输入的方式,轻松体验跨终端的任务执行。
- 使用场景:当您在移动场景下需要通过语音快速操作果办OfficeAce时,例如开车时语音安排日程、开会间隙用手机生成报告,小艺集成让您无需打字即可完成办公任务。
- 运作机制:小艺集成的消息流转路径为:用户通过小艺APP发送语音/文字消息 → 小艺开放平台将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回小艺并展示给用户。
前提条件—小艺集成
已具备HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机或平板。
步骤一:创建小艺智能体
本步骤内容仅供参考,实际请以小艺开放平台文档为准。
- 创建或选择智能体。 登录小艺开放平台,选择已有智能体。如果没有智能体,请单击“新建智能体”创建新智能体。图14 新建智能体
- 配置智能体基本信息。
在创建智能体界面中,滚动鼠标,在界面右侧区域依次配置智能体基本信息,参数说明如表6所示,配置完成后单击“确认创建”。
以配置智能体开发模式为例,配置区域如图15所示。 - 选择编排模式并获取凭证。
- 进入智能体界面后,选择编排模式为“OpenClaw”模式。根据当前是否已有可用凭证,后续操作有所不同。
- 在弹出的“新建凭证”对话框中,输入Key名称,例如“01”,服务平台选择“Web端(JS API)”,创建完成后单击“保存”,保存后界面如图18所示,单击
复制Key和安全密钥,并记录保存,保存后单击“关闭窗口”。
凭证创建成功后,密钥仅在弹窗内临时展示。请务必及时复制Key(即Access Key,简称AK)和安全密钥(即Secret Key,简称SK)并妥善保存,关闭弹窗后无法再次查看。
- Secret Key属于敏感凭证,请勿泄露。
- 如果凭证可能已泄露,请立即在小艺开放平台重新创建凭证,重新创建后原凭证将立即失效,已使用原凭证的服务需同步更新。
- 获取Agent ID并配置小艺智能体开场白。 复制并记录agentId,并配置智能体的开场白,例如“我是您的办公助手,帮您轻松应对各种办公场景。”,如图19中的①②所示。
- 配置测试白名单。
- 上架智能体。 勾选用户组,单击界面右上方的“上架”,在弹出的对话框中单击“发布真机测试”,如图22的①②③所示。
步骤二:在果办OfficeAce集成小艺
步骤三:在小艺中和果办OfficeAce对话
常用指令
果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表7所示。
企业微信集成
当您在企业环境中使用企业微信办公时,通过集成可以在企业微信中直接与果办OfficeAce对话,无需切换应用。
运作机制:
企业微信集成的消息流转路径为:用户在企业微信发送消息 → 企微云平台通过长连接将消息推送到果办OfficeAce → 果办OfficeAce调用智能体处理 → 处理结果流式推回企业微信展示给用户。
前提条件
- 果办OfficeAce:已安装1.8.0及以上版本的果办OfficeAce。
- 企业微信账号:拥有一个可创建智能机器人的企业微信账号。
步骤一:在果办OfficeAce绑定企业微信智能机器人
果办OfficeAce提供两种绑定方式,您可以根据实际需求选择其一。
方式一:快速扫码
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“企业微信”。
- 选择“快速扫码”。
- 单击“生成二维码”,等待二维码生成后,使用企业微信扫描对接。 扫码后,可选择以下两种操作之一完成绑定:
- 创建智能机器人:依次单击“一键创建智能机器人”、“确认授权”,完成对接后单击“前往使用”即可与果办OfficeAce进行对话。 图25 创建智能机器人
图26 确认授权
- 绑定已有智能机器人:单击“绑定已有智能机器人”,选择需要绑定的机器人后单击“确认授权”,完成对接后单击“前往使用”即可与果办OfficeAce进行对话。 图28 绑定已有机器人
图29 选择需绑定的机器人
图30 确认授权
图31 绑定完成
- 创建智能机器人:依次单击“一键创建智能机器人”、“确认授权”,完成对接后单击“前往使用”即可与果办OfficeAce进行对话。
方式二:手动配置
前置准备:获取企业微信智能机器人的Bot ID和Secret。
- 新建智能机器人
通过API模式(长连接)创建的智能机器人,支持被动回复多条消息、主动向用户发消息,支持接收/发送“文字、图片、图文混排、音频、视频、文件”格式消息。
本步骤内容仅供参考,实际请以企业微信文档为准。
- 打开企业微信客户端,进入“工作台 > 智能机器人”,单击“创建机器人 > 手动创建”。
- 进入创建页面后,选择“API模式创建”。
- 在API配置页面,选择连接方式为“使用长连接”。
- 配置完成后,页面将自动生成并展示Bot ID和Secret,妥善保存该信息。
- 补充配置机器人可见范围,其余项保持默认即可,API模式暂不支持预览与调试,直接保存机器人配置。
- 已有机器人
本步骤内容仅供参考,实际请以企业微信文档为准。
- 打开企业微信客户端,进入“通讯录 > 智能机器人”。
- 进入目标机器人详情页,单击“API设置”,即可查看并复制Bot ID和Secret;
在果办OfficeAce中配置:
- 登录果办OfficeAce。
- 在界面左下角,单击用户名称或用户头像,选择“设置”,在设置面板左侧导航栏中选择“连接通讯软件”。
- 在通讯软件列表中选择“企业微信”。
- 选择“手动配置”。
- 输入智能机器人的Bot ID和Bot Secret,填写完成后单击“测试连接”,连接成功后单击“保存”完成对接。
步骤二:在企业微信中和果办OfficeAce对话
绑定完成后,在企业微信中找到果办OfficeAce集成的机器人的单聊或群聊入口。
在单聊中直接发送消息与果办OfficeAce对话。
在群聊中通过@机器人发送消息,果办OfficeAce智能体处理后将流式回复。
在果办OfficeAce的会话列表中会出现来自企业微信的会话记录,表示对接成功。
常用指令
果办OfficeAce支持通过特殊前缀指令控制会话,常用指令如下表8所示。

















