小艺集成

前提条件

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

步骤一：创建小艺智能体

1. 登录小艺开放平台，选择已有智能体。如果没有智能体，可以单击“新建智能体”。
   图1 新建智能体
   

2. 在弹出的对话框中，配置智能体基本信息，示例如下，配置完成后单击“创建”，如图2所示。
   • 智能体名称：xiaoyi-clawee
   • 一句话描述：AI办公助手
   • 支持的设备和系统：手机-HarmonyOS、手机-HarmonyOS Next
   • 智能体分类：实用工具/工具
     图2 配置智能体基本信息
     

3. 进入智能体界面后，选择编排模式为“OpenClaw”模式，单击“点击新建凭证”，如图3所示。
   图3 新建凭证
   

   若已创建凭证，但凭证密钥未保存，可单击“小艺开放平台凭证”重新创建，如图3所示。

   图4 新建凭证
   

4. 在弹出的“新建凭证”对话框中，输入Key名称，例如“01”，创建完成后单击“保存”，保存后界面如图5所示，单击复制Key和安全密钥，并记录保存，保存后单击“关闭窗口”。
   图5 新建凭证
   

5. 在左侧导航，选择“智能体”，单击智能体名称，如图6中的①②所示。
   图6 进入智能体界面
   

6. 在智能体编排界面，复制并记录agentID，并配置智能体的开场白，例如“我是您的办公助手，帮您轻松应对各种办公场景。”，如图7中的①②所示。
   图7 配置开场白
   

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

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

步骤二：在OfficeClaw集成小艺

1. 登录OfficeClaw。
2. 在左侧导航栏中选择“渠道”，在渠道列表中选择“小艺”。
3. 填写应用凭证，具体如下，填写完成后单击“测试连接”，连接成功后单击“保存配置”。
   • Agent ID：请填写步骤6中获取的agentID。
   • Access Key (AK)：请填写步骤4中获取的Key。
   • Secret Key (SK)：请填写步骤4中获取的安全密钥。

4. 重启OfficeClaw使配置生效。

步骤三：开始使用

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

2. 单击智能体，通过聊天窗直接和OfficeClaw对话，支持语音和手动输入。如图12所示，OfficeClaw中显示和小艺的会话信息表示对接成功。
   图12 在小艺中和OfficeClaw对话
   

常见问题

• 为什么在小艺APP中没找到对话列表？

  此功能仅支持HarmonyOS NEXT或HarmonyOS 5.0及以上版本，请检查设备系统版本。若当前为HarmonyOS 4及更早版本，不支持该功能，建议更换设备或升级系统。

• 为什么在小艺APP的对话列表中没有找到创建的智能体？

  小艺APP服务未完全加载。请尝试彻底关闭并重启小艺APP，重新进入后查看。

• 在小艺APP的智能体与OfficeClaw对话未收到回复？

  OfficeClaw的对接配置尚未生效。完成OfficeClaw与小艺的对接设置后，请务必重启OfficeClaw应用以激活配置。