# 通讯软件集成
 #### 飞书集成
本指南将帮助您为果办OfficeAce集成飞书机器人。集成后，您可以通过飞书随时随地与果办OfficeAce进行对话、下发任务（如远程操控电脑执行代码）等。
**运作机制：**
飞书集成的消息流转路径为：用户在飞书中发送消息 → 飞书服务器通过长连接将消息推送到果办OfficeAce → 果办OfficeAce调用模型进行处理 → 处理结果返回飞书并展示给用户。
#### 步骤一：在果办OfficeAce集成飞书
1. 登录果办OfficeAce。
2. 在界面左下角，单击用户名称或用户头像，选择"设置"，在设置面板左侧导航栏中选择"连接通讯软件"。
3. 在通讯软件列表中选择"飞书"。
4. 单击生成二维码按钮，等待二维码生成后，手机使用飞书App扫描二维码，按照飞书提示完成授权对接。
 
#### 步骤二：在飞书中和果办OfficeAce对话
对接完成后，手机飞书App中会出现一个对话窗口，通过飞书的聊天窗直接和果办OfficeAce对话。如[图1]所示，在果办OfficeAce的会话列表中出现来自飞书的会话记录，表示对接成功。
图1在飞书中和果办OfficeAce对话   
![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785213526.png "点击放大")
#### 步骤三：配置个人白名单
当您在飞书群聊中使用果办OfficeAce控制本地电脑时，为了防止他人误操作或恶意控制，请务必开启个人白名单功能。
![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/warning_3.0-zh-cn.png)
如果不开启白名单，群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑，存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。
1. 登录果办OfficeAce。
2. 在界面左下角，单击用户名称或用户头像，选择"设置"，在设置面板左侧导航栏中选择"连接通讯软件"。
3. 在通讯软件列表中选择"飞书"。
4. 在个人白名单区域，如[图2]所示，填入open_id和备注（如用户姓名），单击"添加"。
   
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
   open_id是飞书中用户的唯一标识，每个用户对应一个open_id。获取方式：在飞书中@机器人，发送/myid即可获取您的open_id。
   图2配置个人白名单   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814053109.png "点击放大")
   设置完成后，群聊内只有您本人"@机器人"才会触发回复。其他成员@机器人的消息将被系统自动忽略，以此确保操作权限的唯一性与安全性。
   
   
 
#### 常用指令
果办OfficeAce支持通过特殊前缀指令控制会话，常用指令如下[表1]所示。
 表1特殊前缀指令 
| 命令          | 说明              |
|:---|:---|
| /new         | 新建未命名会话。          |
| /new *标题*   | 新建名为*标题*的会话。     |
| /where       | 返回当前所在的会话。       |
| /threads      | 显示所有会话编号和会话主题。 |
| /use *会话编号* | 切换到编号对应的会话。      |
   
#### 微信集成
本指南将帮助您为果办OfficeAce集成微信Bot。集成后，您可以通过微信给果办OfficeAce下达工作指令并进行对话，实现移动端随时随地的智能体交互。
**运作机制：**
微信集成的消息流转路径为：用户在微信中发送消息 → 微信ClawBot接收消息并转发至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回微信ClawBot并展示给用户。
#### 前提条件---微信集成
- 将微信升级至最新版本。
- 在"设置 \> 插件"中检查是否具备"微信ClawBot"功能，如果不具备，请将微信更新至最新版本后重新检查。
图3升级微信版本、检查微信ClawBot   
![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785053586.png "点击放大")
![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
如果您使用的是HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机、平板等，微信ClawBot功能暂不支持此类设备，请使用其他通讯软件（如飞书、钉钉、小艺）对接，具体请参见[飞书集成]、[钉钉集成]、[小艺集成]。
#### 步骤一：在果办OfficeAce集成微信
1. 登录果办OfficeAce。
2. 在界面左下角，单击用户名称或用户头像，选择"设置"，在设置面板左侧导航栏中选择"连接通讯软件"。
3. 在通讯软件列表中选择"微信"。
4. 单击生成二维码按钮，等待二维码生成后，使用微信扫描对接。对接完成后您就可以使用微信与果办OfficeAce进行对话。
 
#### 步骤二：在微信中和果办OfficeAce对话
对接完成后，在微信聊天列表会多出一个"微信ClawBot"的新联系人，通过微信ClawBot的聊天窗直接和果办OfficeAce对话。如[图4]所示，在果办OfficeAce的会话列表中出现来自微信的会话记录，表示对接成功。
图4和果办OfficeAce对话   
![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814173025.png "点击放大")
#### 常用指令
果办OfficeAce支持通过特殊前缀指令控制会话，常用指令如下[表2]所示。
 表2特殊前缀指令 
| 命令          | 说明              |
|:---|:---|
| /new         | 新建未命名会话。          |
| /new *标题*   | 新建名为*标题*的会话。     |
| /where       | 返回当前所在的会话。       |
| /threads      | 显示所有会话编号和会话主题。 |
| /use *会话编号* | 切换到编号对应的会话。      |
   
 #### 钉钉集成
本指南将帮助您为果办OfficeAce集成钉钉。集成后，您可以通过钉钉给果办OfficeAce下达指令并进行对话，实现移动端随时随地的智能体交互。
- **使用场景**：当您不在电脑旁但仍需使用果办OfficeAce处理任务时，通过钉钉集成可以随时随地通过手机与果办OfficeAce对话，如在外出时安排日程、分析数据、生成报告等。
- **运作机制**：钉钉集成的消息流转路径为：用户在钉钉中发送消息 → 钉钉服务器将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回钉钉并展示给用户。
 
 #### 步骤一：创建钉钉机器人
本步骤内容仅供参考，实际请以[钉钉文档](https://open.dingtalk.com/document/development/create-dingtalk-intelligent-agent-application)为准。
1. 创建应用。 
   1. 登录[钉钉开发者后台](https://open-dev.dingtalk.com/fe/app?#/corp/app)。
      创建钉钉应用需要钉钉账号有开发者权限。请提前联系组织管理员获取钉钉开放平台的开发权限，具体操作请参见[获取开发者权限](https://open.dingtalk.com/document/orgapp/obtain-developer-permissions)。
      
   
   2. 在左侧导航栏中，选择"钉钉应用"，在钉钉应用页面单击"创建应用"。 ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785216528.png "点击放大")
      
   
   3. 在弹出的窗口中填写"应用名称"、"应用描述"后，单击"保存"。
      图5创建应用   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814296019.png "点击放大") 
   
   
   
   
2. 添加机器人能力。应用创建成功后，会自动跳转至"添加应用能力"页面，选择添加机器人。 
   图6添加机器人   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785056598.png "点击放大")
   
   
3. 配置机器人信息。打开机器人配置，填写以下信息。 
   表3参数说明 
   | 参数    | 说明                 |
   |:---|:---|
   | 机器人名称 | 机器人在钉钉中显示的名称        |
   | 机器人简介 | 简要描述机器人的功能，便于用户了解用途 |
   | 机器人描述   | 详细描述机器人的能力和使用方式   |
   | 消息预览图 | 上传一张机器人消息预览图        |
      
   图7配置机器人信息   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814176107.png "点击放大")
   
   
4. 发布机器人。配置完成后，在页面下方单击"发布"。 
   图8发布机器人   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785216530.png "点击放大")
   
   
5. 配置应用权限。 
   为保证机器人能正常收发消息，需要在"权限管理"中配置相关权限。
   依次搜索并开通以下权限：Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。权限说明如[表4]所示。
    表4权限说明 
   | 权限名称                  | 用途                      |
   |:---|:---|
   | Card.Streaming.Write | 允许机器人发送流式卡片消息，用于实时展示回复内容  |
   | Card.Instance.Write   | 允许机器人创建和更新交互式卡片，用于消息展示和交互 |
   | qyapi_robot_sendmsg  | 允许机器人通过API发送消息，用于向用户推送回复  |
      
   图9开通机器人权限   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814296021.png "点击放大")
   
   
6. 创建并发布应用版本。 
   1. 在左侧导航栏中选择"版本管理与发布"，并"创建新版本"。
      图10创建新版本   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785056600.png "点击放大") 
   
   2. 填写版本号、版本描述，并选择应用可用范围后单击"保存"并按提示进行发布。
      
      图11发布版本   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814176109.png "点击放大") 
   
   
   
   
7. 获取应用凭证。 
   在"凭证与基础信息"页面获取Client ID、Client Secret，用于[步骤二：在果办OfficeAce集成钉钉]配置果办OfficeAce的对接信息。
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
   Client ID和Client Secret是钉钉应用的鉴权凭证。在[步骤二：在果办OfficeAce集成钉钉]中，Client ID对应填写至"App Key"字段，Client Secret对应填写至"App Secret"字段。
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/caution_3.0-zh-cn.png)
   Client Secret属于敏感凭证，请妥善保管，切勿泄露或提交至公开代码仓库。
   图12获取凭证信息   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785216532.png "点击放大")
   
   
 
 #### 步骤二：在果办OfficeAce集成钉钉
1. 登录果办OfficeAce。
2. 在界面左下角，单击用户名称或用户头像，选择"设置"，在设置面板左侧导航栏中选择"连接通讯软件"。
3. 在通讯软件列表中选择"钉钉"。
4. 填写[步骤一：创建钉钉机器人]中获取的Client ID填写至"App Key"、将Client Secret填写至"App Secret"。
5. 填写完成后单击"测试连接"，连接成功后单击"保存配置"。 
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
   如果测试连接失败，请检查：①Client ID和Client Secret是否填写正确且未多余空格；②钉钉应用是否已成功发布；③三项权限是否已全部开通。
   
   
 
#### 步骤三：配置个人白名单
当您在飞书群聊中使用果办OfficeAce控制本地电脑时，为了防止他人误操作或恶意控制，请务必开启个人白名单功能。
![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/warning_3.0-zh-cn.png)
如果不开启白名单，群聊中的任何成员都可以通过@机器人触发果办OfficeAce操作您的电脑，存在严重的安全风险。强烈建议在群聊场景下务必配置白名单。
1. 登录果办OfficeAce。
2. 在界面左下角，单击用户名称或用户头像，选择"设置"，在设置面板左侧导航栏中选择"连接通讯软件"。
3. 在通讯软件列表中选择"飞书"。
4. 在个人白名单区域，如[图13]所示，填入open_id和备注（如用户姓名），单击"添加"。
   
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
   open_id是飞书中用户的唯一标识，每个用户对应一个open_id。获取方式：在飞书中@机器人，发送/myid即可获取您的open_id。
   图13配置个人白名单   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785056602.png "点击放大")
   设置完成后，群聊内只有您本人"@机器人"才会触发回复。其他成员@机器人的消息将被系统自动忽略，以此确保操作权限的唯一性与安全性。
   
   
 
#### 常用指令
果办OfficeAce支持通过特殊前缀指令控制会话，常用指令如下[表5]所示。
 表5特殊前缀指令 
| 命令          | 说明              |
|:---|:---|
| /new         | 新建未命名会话。          |
| /new *标题*   | 新建名为*标题*的会话。     |
| /where       | 返回当前所在的会话。       |
| /threads      | 显示所有会话编号和会话主题。 |
| /use *会话编号* | 切换到编号对应的会话。      |
   
 #### 小艺集成
本指南将帮助您在果办OfficeAce中集成小艺智能助手。集成后，无论您使用的是手机还是平板，都能通过小艺APP，以语音或手动输入的方式，轻松体验跨终端的任务执行。
- **使用场景**：当您在移动场景下需要通过语音快速操作果办OfficeAce时，例如开车时语音安排日程、开会间隙用手机生成报告，小艺集成让您无需打字即可完成办公任务。
- **运作机制**：小艺集成的消息流转路径为：用户通过小艺APP发送语音/文字消息 → 小艺开放平台将消息推送至果办OfficeAce → 果办OfficeAce调用智能体进行处理 → 处理结果返回小艺并展示给用户。
 
#### 前提条件---小艺集成
已具备HarmonyOS NEXT、HarmonyOS 5.0及以上版本的手机或平板。
 #### 步骤一：创建小艺智能体
本步骤内容仅供参考，实际请以[小艺开放平台文档](https://developer.huawei.com/consumer/cn/doc/service/developer-guide-0000002469667881)为准。
1. 创建或选择智能体。 
   登录[小艺开放平台](https://developer.huawei.com/consumer/cn/hag/abilityportal/#/agentHome/workSpace/agent)，选择已有智能体。如果没有智能体，请单击"新建智能体"创建新智能体。
   图14新建智能体   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814176111.png "点击放大")
   
   
2. 配置智能体基本信息。 
   在创建智能体界面中，滚动鼠标，在界面右侧区域依次配置智能体基本信息，参数说明如[表6]所示，配置完成后单击"确认创建"。
   以配置智能体开发模式为例，配置区域如[图15]所示。
   图15配置智能体开发模式   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785216534.png "点击放大")
    表6参数说明 
   | 参数         | 说明                                                                                                                                                          | 是否必填 | 示例                             |
   |:---|:---|:---|:---|
   | 开发模式      | 选择智能体的开发模式。 此处选择OpenClaw模式。OpenClaw模式是一种开放灵活的智能体接入与构建方式，开发者可通过该模式接入OpenClaw工具 ，快速创建个性化智能体。该模式适用于个性化助手、自动化服务、场景化应用等多样化需求。 | 是    | OpenClaw模式                     |
   | 智能体名称     | 智能体的标识名称。                                                                                                                                                    | 是   | xiaoyi-clawee                  |
   | 一句话描述    | 简要描述智能体功能。                                                                                                                                                     | 是    | AI办公助手                         |
   | 支持的设备和系统 | 选择智能体支持的设备类型和系统版本。                                                                                                                                           | 是      | 手机-HarmonyOS、手机-HarmonyOS Next |
      
   
   
3. 选择编排模式并获取凭证。
   
   1. 进入智能体界面后，选择编排模式为"OpenClaw"模式。根据当前是否已有可用凭证，后续操作有所不同。
      - **未创建过凭证** ：单击"点击新建凭证"，如[图16]所示。
        图16新建凭证   
        ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814296025.png "点击放大") 
      
      - **已创建过凭证但未及时保存密钥** ：可单击"小艺开放平台凭证"重新创建，如[图16]所示。
        图17重新创建凭证   
        ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785056604.png "点击放大") 
       
   
   2. 在弹出的"新建凭证"对话框中，输入Key名称，例如"01"，服务平台选择"Web端（JS API）"，创建完成后单击"保存"，保存后界面如[图18]所示，单击![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814176113.png)复制Key和安全密钥，并记录保存，保存后单击"关闭窗口"。
      ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/caution_3.0-zh-cn.png)
      凭证创建成功后，密钥仅在弹窗内临时展示。请务必及时复制Key（即Access Key，简称AK）和安全密钥（即Secret Key，简称SK）并妥善保存，关闭弹窗后无法再次查看。
      - Secret Key属于敏感凭证，请勿泄露。
      
      - 如果凭证可能已泄露，请立即在[小艺开放平台](https://developer.huawei.com/consumer/cn/hag/abilityportal/#/agentHome/workSpace/agent)重新创建凭证，重新创建后原凭证将立即失效，已使用原凭证的服务需同步更新。
       
      图18新建凭证   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785216538.png "点击放大") 
   
   
   
   
4. 获取Agent ID并配置小艺智能体开场白**。**
   
   复制并记录agentId，并配置智能体的开场白，例如"我是您的办公助手，帮您轻松应对各种办公场景。"，如[图19]中的①②所示。
   图19配置开场白   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814296029.png "点击放大")
   
   
5. 配置测试白名单。 
   1. 在左侧导航，选择"测试白名单"，单击界面右上方的"新建用户组"，在弹出的弹框中输入用户组名例如"01"，输入完成后单击"保存"，保存后如[图20]所示。
      图20创建用户组   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785056608.png "点击放大") 
   
   2. 在用户组所属的操作列，单击"管理用户"，在弹出的弹框中单击"邀请用户"，输入用户手机号码或邮箱，如[图21]所示，输入完成后单击"确定"，并根据界面提示完成后续弹框信息的确认。
      图21邀请白名单用户   
      ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814176119.png "点击放大") 
   
   
   
   
6. 上架智能体。 
   勾选用户组，单击界面右上方的"上架"，在弹出的对话框中单击"发布真机测试"，如[图22]的①②③所示。
   图22上架智能体   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785216544.png "点击放大")
   
   
 
#### 步骤二：在果办OfficeAce集成小艺
1. 登录果办OfficeAce。
2. 在界面左下角，单击用户名称或用户头像，选择"设置"，在设置面板左侧导航栏中选择"连接通讯软件"。
3. 在通讯软件列表中选择"小艺"。
4. 填写应用凭证，具体如下，填写完成后单击"测试连接"，连接成功后单击"保存配置"。 
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
   如果测试连接失败，请检查：①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查找智能体   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002814296035.png "点击放大")
   
   
2. 单击智能体，通过聊天窗直接和果办OfficeAce对话，支持语音和手动输入。如[图24]所示，果办OfficeAce中显示来自小艺的会话信息，表示对接成功。
   
   ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
   如需指定某个智能体处理任务，可以直接输入@+智能体名称，指定智能体进行对话。
   图24在小艺中和果办OfficeAce对话   
   ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002785056614.png "点击放大")
   
   
 
#### 常用指令
果办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进行对话。
     ![](https://support.huaweicloud.com/usermanual-officeace/public_sys-resources/note_3.0-zh-cn.png)
     可在[图27]修改智能机器人的名称。
     图25创建智能机器人   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002787170602.png "点击放大")
     图26确认授权   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002787010678.png "点击放大")
     图27创建完成   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002816130133.png "点击放大") 
   
   - 绑定已有智能机器人：单击"绑定已有智能机器人"，选择需要绑定的机器人后单击"确认授权"，完成对接后单击"前往使用"即可与果办OfficeAce进行对话。
     图28绑定已有机器人   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002816250059.png "点击放大")
     图29选择需绑定的机器人   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002815990351.png "点击放大")
     图30确认授权   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002786711206.png "点击放大")
     图31绑定完成   
     ![](https://support.huaweicloud.com/usermanual-officeace/zh-cn_image_0000002786871350.png "点击放大") 
    
   
   
 
**方式二：手动配置**
**前置准备：获取企业微信智能机器人的Bot ID和Secret。**
- 新建智能机器人 通过API模式（长连接）创建的智能机器人，支持被动回复多条消息、主动向用户发消息，支持接收/发送"文字、图片、图文混排、音频、视频、文件"格式消息。
  本步骤内容仅供参考，实际请以[企业微信文档](https://open.work.weixin.qq.com/help2/pc/21677)为准。
  1. 打开企业微信客户端，进入"工作台 \> 智能机器人"，单击"创建机器人 \> 手动创建"。
  
  2. 进入创建页面后，选择"API模式创建"。
  
  3. 在API配置页面，选择连接方式为"使用长连接"。
  
  4. 配置完成后，页面将自动生成并展示Bot ID和Secret，妥善保存该信息。
  
  5. 补充配置机器人可见范围，其余项保持默认即可，API模式暂不支持预览与调试，直接保存机器人配置。
   
- 已有机器人 本步骤内容仅供参考，实际请以[企业微信文档](https://open.work.weixin.qq.com/help2/pc/21663)为准。
  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 *会话编号* | 切换到编号对应的会话。      |
   
