本文主要介绍如何为 ArkClaw 集成机器人消息渠道，集成后即可通过对应机器人与 ArkClaw 进行对话，ArkClaw 也可以通过机器人能力帮助您进行文档创建、日程创建等操作。

说明

消息渠道支持通过多个入口（如下图2处）进行配置，本文仅介绍信息更完整的入口①的操作方式。

## 飞书：集成飞书机器人 ### 步骤一：集成飞书机器人仅需您使用飞书 APP 扫码授权，ArkClaw 即可快速帮助您新建飞书机器人，并自动将其与 ArkClaw 进行集成。

注意

若您的 ArkClaw 已配置飞书机器人，原有机器人信息将被新建机器人信息覆盖。

1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。 2. 在左侧切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2caf49612759eff7bfccea76d28d09cb.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7043e0196bb41e00d9bf1a08f0aa477a.png) 4. 首次绑定渠道选择“链接到飞书”，此处演示为首次绑定消息渠道。

说明

非绑定首个消息渠道选择“添加”按钮，选择对应的消息渠道。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ba03368af225c2cc56fb2768f546eca4.png) 5. 在弹窗中单击“生成二维码”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_056da19cc955d3ba5ebd5cc1d0bacdfb.png) 6. 待二维码生成后，请按需勾选“同时连接飞书 CLI”，并请使用您手机中安装的飞书 APP 扫描二维码。

说明

请使用具备 ArkClaw Enterprise 使用权限的飞书账号扫码创建机器人应用，如：您的企业飞书账号具备使用 ArkClaw 企业版的权限，但您使用个人飞书账号扫码创建飞书机器人，创建成功后您将无法正常通过此飞书机器人使用 ArkClaw。

飞书 CLI 是飞书官方提供的命令行工具，ArkClaw 可通过飞书 CLI 提供的丰富的命令及 AI Agent Skills 帮助您更便捷地管理和操作飞书，包括飞书消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议、Markdown 等核心业务域。了解更多

若您不希望在配置消息渠道时启用飞书 CLI，可在后续使用过程中自行启用。了解更多

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a71c916a8e341053b7fe2f42d2001cfa.png) 7. 填写机器人名称。 * **创建新的机器人**：单击“立即创建”按钮开始创建新的机器人并配置流程。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1bc2212b3d5343b2a6063d6850e9149d.png) * **使用已有机器人**：单击“已有应用”按钮，并选择需要使用的机器人，如果已有机器人缺少相关权限需要您授权，在授权界面您可点击相关权限的“查看”按钮查看 ArkClaw 关联的飞书机器人所需的权限，确认无误后点击“确认”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7abe59815e9348f5c752953fa64577f6.jpg)

注意

扫码后，请在 10 分钟内完成填写机器人名称并进行创建操作。若操作超时，请重新扫描二维码创建机器人。

8. 回显如下所示时，表示 ArkClaw 已完成飞书机器人配置，可关闭消息渠道配置界面。

注意

配置过程中，ArkClaw 由于需要重启网关，请耐心等待。若长时间无响应，建议您恢复 ArkClaw 出厂设置后重新根据本步骤指引配置机器人信息。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3c4e3dc3a756d0738ec0430e6b4a769a.png) 9. 若您勾选了“同时连接飞书 CLI”，请授权链接飞书 CLI。 1. 单击“打开授权页面”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ab4bdf3bde0157f750b4a3747cf889f0.png) 2. 在授权页面中确认权限信息，并单击“开通并授权”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c89397cf54abaa66bbc786405aecdced.png) 3. 当页面显示“开通并授权成功”时，表示您的 ArkClaw 已成功链接飞书 CLI。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7daf7610513d83e4989a5a04df8c47b7.png) 10. 回到您的飞书 APP 中，单击“打开应用”按钮，即可通过飞书机器人与 ArkClaw 进行对话。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d16f8b2e2819a3da90d61e28e023db56.png)

说明

通过 Arkclaw 创建的飞书机器人带有 ArkClaw 标识。您可使用创建飞书机器人的账号登录飞书开发者平台，在应用描述中查看此机器人关联的 ArkClaw 实例 ID 信息。

### 步骤二：开启机器人长连接（可选）

说明

在 ArkClaw 中配置机器人信息后，如果您希望飞书机器人能持续接收消息、后台稳定运行不中断，请参考此部分内容开启机器人长连接；如果您只是偶尔使用此飞书机器人，也可以不用开启。

1. 登录 [飞书开发者平台](https://open.larkoffice.com/app?lang=zh-CN)。 2. 选择“企业自建应用”页签，并单击您创建的飞书开放应用。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ee895f1f3bd3fa3c0f201895612fe51b.png) 3. 在左侧目录树选择“开发配置 \> 事件与回调”，在事件配置与回调配置中开启长连接。 **步骤一：事件配置操作流程** 1. 选择“事件配置”页签，单击“订阅方式”旁的编辑按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c600e17924027f801d14e0f26139e9ae.png) 2. 选择“使用 **长连接** 接收事件”，并单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f1a689fd1a096e874bdb4a4355c899ad.png) 3. 在“已添加事件”区域，单击“添加事件”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e15635ae9baec480e2fa89546e4336cc.png) 4. 在添加事件对话框中，选择“应用身份订阅”页签，搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件，单击“确认添加”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bb0980c27f03101039747ccd72f15878.png) 5. **（可选）** 若您期望将机器人添加到聊天群组中使用，可参考如下操作指引开通获取群组消息权限。否则，请跳过本步骤。

注意

由于OpenClaw是个人AI助手，在群聊场景下可能存在凭证泄露等风险，请谨慎使用。

**开通“获取群组消息”权限流程** 1. 在“已添加事件”模块中，单击“接收消息”事件“所需权限”列的“查看其它权限”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_924b24c010673a4bae47b9f652dac8b9.png) 2. 单击“获取群组中所有消息（敏感权限）”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_713700bfcbb23bfff272fcf55a938072.png) 3. 在弹窗中单击“开通权限”按钮，申请开通。 **步骤二：回调配置操作流程** 1. 选择“回调配置”页签，单击“订阅方式”旁的编辑按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_854a4ec4031019ba11d48ab6c3438806.png) 2. 选择“使用 **长连接** 接收回调”，并单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_130cf2011c8b9dcd30e81e41f9b602ee.png) 3. 在“已订阅的回调”区域，单击“添加回调”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ea7c1a20359f42e5cd026b07e2ce05d5.png) 4. 在添加回调对话框中，选择“卡片”页签，并勾选“卡片回传交互”，单击“确认添加”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f5f0d888fa1e24d1d54d5de250f584e2.png) 4. 开启长连接后，请再次新建机器人版本并发布，确保当前配置修改生效。 1. 单击顶部的“创建版本”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d835d52967d51bdcb6446254e04ee4b.png) 2. 按需配置应用版本号、默认能力及更新说明等信息。[了解更多](https://open.larkoffice.com/document/best-practices/intro-to-custom-app-review)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0d5aed2b0fec9906af56a0284f656c75.png) 3. 单击页面底部的“保存”按钮，创建版本。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f5e63e15c8b10e13cc1be20b93841fd1.png) 4. 单击页面右上角的“确认发布”按钮，完成应用发布。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_25550af4ea9aea79198c7c75d756f36f.png) 5. 至此，您已完成全部操作，可以通过飞书机器人与 ArkClaw 进行对话。 ## 个人微信：集成个人微信机器人仅需使用微信 APP 扫码，ArkClaw 即可快速帮助您集成微信机器人。

注意

若您的 ArkClaw 已配置微信机器人，原有机器人信息将被新建机器人信息覆盖。

1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。 2. 切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2caf49612759eff7bfccea76d28d09cb.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7043e0196bb41e00d9bf1a08f0aa477a.png) 4. 首次绑定渠道选择“链接到微信”，此处演示为非绑定首个消息渠道，单击“添加”按钮，选择“微信”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9d21e3b56cfa1d28803c4529f70d5890.png) 5. 单击“立即执行”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_469045fa28c71200074a5553b445fd04.png) 6. ArkClaw 将在终端中进行初始化，并为您生成授权二维码。

注意

在完成微信机器人对接流程前，请勿关闭页面。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_073357c468ef5e2a3aa71586fb6b5d58.png) 7. 启用微信 ClawBot 插件。 1. 请使用您手机中安装的微信 APP 扫描二维码。 2. 若扫码后提示“当前微信版本较低”字样，请根据页面指引更新微信后再次扫码。

注意

若更新微信版本后扫码仍提示“当前微信版本较低”，请等待 1 ～ 3 分钟，重新生成二维码并进行扫码操作。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_285442f95f53b5e8b8380870a52dc59c.png) 3. 点击“连接”按钮，确认启用微信 ClawBot 插件。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1b676929e1ff7ecf2a61716940c4681a.png) 8. 授权后，ArkClaw 将自动为您配置微信机器人信息。

注意

配置过程中，ArkClaw 由于需要重启网关，请耐心等待。若长时间无响应，建议您恢复 ArkClaw 出厂设置后重新根据本步骤指引配置机器人信息。

回显如下所示时，表示 ArkClaw 已完成微信机器人配置，可关闭终端界面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_857263321f7564a0ee619ba1a530ccfa.png) 9. 回到您的微信 APP 中，即可通过微信机器人与 ArkClaw 进行对话了。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c0ec5298609ac960fc8ab643ab63c656.png) ## 企业微信：集成企业微信机器人 ### 方式一：快速创建并集成机器人如果您需要新建企业微信机器人并使用，请参考此部分操作创建并获取企业微信机器人信息，仅需使用企业微信 APP 扫码授权，ArkClaw 即可快速帮助您新建企业微信机器人，并自动将其与 ArkClaw 进行集成。

注意

若您的 ArkClaw 已配置了企业微信机器人，原有机器人信息将被新建的机器人覆盖。

注意

扫码后，请在 1 分钟内 开始机器人创建流程。若操作超时，请重新扫描二维码创建机器人。

1. 请点击“一键创建智能机器人”按钮，开始创建机器人流程。 2. 点击“确认授权”按钮，授予机器人获取聊天信息、日程等权限。 3. 按需调整机器人名称，点击“前往使用”按钮进入对话页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_74b8780056d02a15c2497d53739f484c.png) 8. 机器人创建成功后，ArkClaw 将自动为您配置新建机器人信息。

注意

配置过程中，ArkClaw 由于需要重启网关，请耐心等待。若长时间无响应，建议您恢复 ArkClaw 出厂设置后重新根据本步骤指引配置机器人信息。

当渠道中展示“企业微信”配置，表示 ArkClaw 已完成企业微信机器人配置，您就可以通过企业微信机器人与 ArkClaw 进行对话了。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2db26d0095a9dc4391b62caf78931b9c.png) ### 方式二：集成已有机器人若您期望使用已有企业微信机器人，参考此部分配置，将已有机器人的“连接方式”调整为“使用长连接”并获取其 Bot ID 与 Secret 信息。 #### 步骤一：修改机器人配置 1. 使用有企业管理员权限的账号登录 [企业微信官网](https://work.weixin.qq.com/)，在左侧目录树选择“安全与管理 \> 管理工具”，单击“智能机器人”卡片。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b710815fa54b1631f6529ffbf9ad5cc9.png) 2. 在智能机器人页面左侧导树中选择“管理”，单击目标机器人进入机器人详情页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a99c64414bd728b0d148ec1843cb9b5a.png) 3. 单击“编辑”按钮，配置机器人。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_56c09f80d48a5f939a2989949840ff9a.png) 4. 直接滑动至页面底部，单击“API 模式创建”按钮切换创建模式。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a353e13ef922400e4969a7d8a3defa61.png) 5. 连接方式选择“使用长连接”，单击 Secret 处的“点击获取”按钮生成 Secret 信息，复制并保存 Bot ID 和 Secret 信息，单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0b0e1d51ee2fdec119244d21b4cc4dc4.png) #### 步骤二：在 ArkClaw 中配置企业微信机器人信息 1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键，进入 ArkClaw 会话页面。 2. 切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2caf49612759eff7bfccea76d28d09cb.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7043e0196bb41e00d9bf1a08f0aa477a.png) 4. 首次绑定渠道选择“链接到企业微信”，此处演示为非绑定首个消息渠道，单击“添加”按钮，选择“企业微信”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e925a855283a08d9e8a3824497cb96ac.png) 5. 单击“手动配置”按钮，输入待关联的企业应用机器人的信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_734eb73be2011f082dec7b2701f6b9ce.png)

注意

配置过程中 ArkClaw 由于需要重启网关，请耐心等待。若长时间无响应，建议您恢复 ArkClaw 出厂设置后重新根据本步骤指引配置机器人信息。

6. 当渠道中展示“企业微信”配置，表示 ArkClaw 已完成企业微信机器人配置，您就可以通过企业微信机器人与 ArkClaw 进行对话了。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2db26d0095a9dc4391b62caf78931b9c.png) ## 钉钉：集成钉钉机器人 ### 方式一：快速创建并集成机器人仅需您使用钉钉扫码授权，ArkClaw 即可快速帮助您新建钉钉机器人，并自动将其与 ArkClaw 进行集成。

注意

若您的 ArkClaw 已配置钉钉机器人，原有机器人信息将被新建机器人信息覆盖。

1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键，进入 ArkClaw 会话页面。 2. 切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2caf49612759eff7bfccea76d28d09cb.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7043e0196bb41e00d9bf1a08f0aa477a.png) 4. 首次绑定渠道选择“链接到钉钉”，此处演示为非绑定首个消息渠道，单击“添加”按钮，选择“钉钉”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_18cc53d88cd0226838e84ba6c0fdd125.png) 5. 单击“生成二维码”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4078f66b5e916c1312bfc9e97e5aa59e.png) 6. 等待自动生成二维码。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_39ec096e262ae974bf441fdfb1a49e13.png) 7. 在手机端打开钉钉 APP 扫描二维码，根据指引创建机器人。 1. 点击“创建”按钮，创建一个新的钉钉机器人。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_14e0f2837d3427806a8e1da819f9dd9f.jpg) 2. 点击“打开机器人”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cf50284c42df33ee450d2803ca6b8cf6.png) 8. 出现配置成功提示信息，表示您已成功在 ArkClaw 中配置机器人信息，您可以通过钉钉机器人与 ArkClaw 进行对话了。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5e8ac8fca39e5186e8f57f1aab779df8.png) ### 方式二：集成已有机器人 #### 步骤一：**创建并配置钉钉机器人**

说明

若您已有钉钉机器人，请跳过步骤1：创建钉钉应用，完成其它配置操作。

**步骤1：创建钉钉应用** 1. 登录[钉钉开放平台](https://open-dev.dingtalk.com/fe/app?hash=%23%2Fcorp%2Fapp#/corp/app)，在应用开发页签下左侧目录树中，选择“企业内部应用 \> 钉钉应用”，在页面右上角单击“创建应用”按钮。

说明

创建钉钉应用需要您的钉钉账号有开发者权限。您可以联系您的组织管理员获取钉钉开放平台的开发权限。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_216da8d513f91dbeecea50a8c997d7a2.png) 2. 配置应用名称、图标等信息后，单击“保存”按钮。 **步骤2：授予应用发送卡片消息权限** 1. 登录[钉钉应用控制台](https://open-dev.dingtalk.com/fe/app)，单击前文创建的应用名称，进入其详情页。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6dcf529cf1fcdb357b2e20f7673f3155.png) 2. 在左侧目录树选择“开发配置 \> 权限管理”，在搜索框中输入`Card`，勾选“互动卡片实例写权限”与“AI卡片流式更新权限”，单击“批量申请”按钮完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4c73bb1c901d5c10731fc0b3633efb91.png) 3. 在搜索框中输入`qyapi_robot_sendmsg`，单击“企业内机器人发送消息权限”右侧操作列的“立即开通”按钮完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d72b2ca25e9ed37d5fa9d1e17586de2e.png) **步骤3：配置钉钉机器人** 1. 在左侧目录树选择“应用能力 \> 添加应用能力”，单击“机器人”卡片的“添加”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2398813e5bb760dbcd9945d98715393a.png) 2. 在机器人配置页面，打开机器人配置开关。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f5c31b5548d563936005c1dc37394cd0.png) 3. 配置其他必填信息，并将“消息接收模式”调整为“Stream 模式”，然后单击“发布”按钮，保存配置。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7582f6e2e0dff55c027a73d9ff0c4853.png) 4. 在弹窗中单击“发布”按钮，完成编辑。

说明

发布后，请保持“机器人配置”选项为开启状态。

**步骤4：发布应用版本使配置生效** 1. 在左侧目录树选择“应用发布 \> 版本管理与发布”，并单击“创建新版本”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ba89cbac14941984521215cb4a1473e6.png) 2. 按需配置应用版本号、可见范围等信息后，单击“保存”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_91c6ca228efe9659a91c3cbbf3aceb05.png) 3. 在弹窗中单击“确认发布”按钮，发布应用版本。 **步骤5：获取机器人 Client ID 与 Client Secret** 1. 在左侧目录树选择“基础信息 \> 凭证与基础信息”。 2. 复制 Client ID 和 Client Secret。

说明

获取的 Client ID 和 Client Secret 将用于配置 ArkClaw，请妥善保存。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a09dbd48bbf727bc8fb3f3d1913da671.png) #### 步骤二：在 ArkClaw 中配置钉钉机器人信息 1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键，进入 ArkClaw 会话页面。 2. 切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2caf49612759eff7bfccea76d28d09cb.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7043e0196bb41e00d9bf1a08f0aa477a.png) 4. 首次绑定渠道选择“链接到钉钉”，此处演示为非绑定首个消息渠道，单击“添加”按钮，选择“钉钉”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_18cc53d88cd0226838e84ba6c0fdd125.png)

注意

配置过程中 ArkClaw 由于需要重启网关，请耐心等待。若长时间无响应，建议您恢复 ArkClaw 出厂设置后重新根据本步骤指引配置机器人信息。

5. 单击“生成二维码”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4078f66b5e916c1312bfc9e97e5aa59e.png) 6. 等待自动生成二维码。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_39ec096e262ae974bf441fdfb1a49e13.png) 7. 在手机端打开钉钉 APP 扫描二维码，根据指引创建机器人。 1. 点击“选择已有机器人”按钮，使用已有钉钉机器人。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_14e0f2837d3427806a8e1da819f9dd9f.jpg) 2. 选择需要使用的机器人。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5ca5b68a167d2e9e0a30136d9d091d9e.jpg) 8. 表示您已成功在 ArkClaw 中配置机器人信息，您可以通过钉钉机器人与 ArkClaw 进行对话了。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5e8ac8fca39e5186e8f57f1aab779df8.png) ## 集成 Microsoft Teams 机器人 ### 方式一：自动创建并集成机器人仅需登录 Microsoft Teams 账号并完成授权，ArkClaw 即可通过 Teams CLI 帮助您自动创建 Microsoft Teams 机器人并将其与 ArkClaw 进行集成。适用于无需自定义 Azure Bot 配置的场景。

注意

若您的 ArkClaw 已配置了 Microsoft Teams 机器人，原有机器人信息将被新建的机器人覆盖。

1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键，进入 ArkClaw 会话页面。 2. 切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1e8e9dcc5a7029df1875c87003332a70.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”或页面中的“配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4e1f94d203501c3a06ccfd962f98bf2c.png) 4. 选择“连接到 Microsoft Teams”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5503cbd723612a3220c2abc2e96dd961.png) 5. 选择“自动配置”并自定义您的 Microsoft Teams 机器人名称，单击“立即执行”按钮。

说明

若未配置 Microsoft Teams 机器人名称，ArkClaw 将按ArkClaw-xxxxx规则为您的机器人命名。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d53822b2f5077c4a509f642dffc431e1.png) 6. 待 ArkClaw 完成环境准备后，将为您展示 Microsoft 登录地址（Sign\-in URL）及授权代码（Code）。

注意

在完成所有配置步骤前，请勿关闭终端界面。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_749ea85720a26b9dbe210d5b57d87f33.png) 7. 使用浏览器打开终端中展示的`Sign-in URL`，并填写您在终端中获取的授权代码（Code），单击“下一步”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f0b269bbfa66bd379d258eb56dc0642a.png) 8. 根据指引，登录您的 Microsoft 账户。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2a8d532abedeb5da0181531a31e032ed.png) 回显如下所示时，表示您已成功完成授权，可关闭当前浏览器页面，回到 ArkClaw 终端页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_de3e3de19850ccad0f8fd8af77ea9013.png) 9. 添加新建的 Microsoft Teams 机器人至您的 Teams。 1. 单击 ArkClaw 终端回显的`Install URL`。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1646115a3a405e2d39321fa1f882898b.png) 2. 单击“打开 Microsoft Teams”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0f79abde7661dea5f6c7863453ae6e7b.png) 3. 单击“添加”按钮，将机器人添加到您的 Teams 聊天中。 10. 至此，您已完成个人会话接入，与 Teams 机器人私聊即可与 ArkClaw 进行对话。

注意

如需在团队中使用机器人，请继续完成团队会话接入。否则，可忽略后续配置步骤，并关闭 ArkClaw 终端界面。

11. 在团队中使用 Teams 机器人。 1. 下载机器人文件。

注意

您可以将机器人文件压缩包分享给同组织的其他成员，对方上传后即可通过该机器人与您的 ArkClaw 进行对话。适用于将您的 ArkClaw 作为组织内通用智能助手场景，例如财务报销、流程审批等。

1. 单击 ArkClaw 终端回显的 `DEVELOPER_PORTAL_URL`。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ce8a50cd69036284d9c270189ff05993.png) 2. 在左侧目录树选择“Configure \> App package editor”，单击“Download”按钮下载机器人文件压缩包。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8c9f7ea8b51aba697b01257db08e29f2.png) 3. 在 Microsoft Teams 团队频道中添加机器人。 1. **（可选）** 创建团队频道。在“聊天”中选择“Teams 和频道 \> 查看所有频道”，在查看所有频道页面单击右上角“创建团队”创建一个团队。

说明

如果已有团队频道，可跳过此步骤。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_efc2d456f53c1586e721543549528f39.png) 2. 在“聊天 \> Teams 和频道”下单击目标团队下的目标频道名称（需要使用 Teams 机器人的频道），在频道下单击“在频道中发布”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_394ef60aefea4f65f26e2f75933b16e5.png) 3. 在消息框中输入“@”选择“获取代理和机器人”，在弹出的对话框中单击“获取更多应用”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ef90d301545ccae711ab72c3f1c48827.png) 4. 单击最下方“管理你的应用”，选择“上载应用 \> 上传自定义应用”，上传您在上一步中获得的机器人文件压缩包。 5. 上传成功后，单击“添加”按钮，并在添加窗口下方选择目标频道名称，单击“转到”按钮跳转至频道发布的“帖子”页签下。 6. 单击输入框中的“继续草稿”，然后在消息框中输入“@”选择“获取代理和机器人”，在弹出的对话框中选择您上传的机器人。 4. 至此，您与团队成员就可以在团队频道中通过 Teams 机器人与 ArkClaw 对话了。 ### 方式二：手动创建并集成机器人如需使用已有机器人，或需要自定义 Bot 权限、配置，可参考本方式完成接入。 #### 步骤一：创建并配置 Azure Bot 1. 进入 [Azure 应用注册页面](https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade)，单击“New registration”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ef386e2738392d3d1d3e14a185fe72f5.png) 2. 配置应用 Name，Supported account type 选择“Single tenant only”，Redirect URI 选择“Web”实际 URL 先不填写，单击“Register”按钮，完成创建。

说明

“Single tenant only”表示当前创建的 APP 可以被相同租户的所有账号访问。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1fbfa113579e2dde36e8abc3716ba6e3.png) 3. 应用创建完成后，复制并记录 **Application (client) ID ** 和 **Directory (tenant) ID**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0f950e2e5ba918342720c9c102b2b2f3.png) 4. 单击“Add a certificate or secret”按钮，跳转至“Manage \> Certificates & secrets”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b54eb119a9cc598462956cb1ac034235.png) 5. 在“Manage \> Certificates & secrets”，单击“New client secret”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c68db36207fb91608e214b954a271fa7.png) 6. 完善 Description 和 Expires 后，单击“Add”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_9f2b7cab48e55d0f1a5820407dbc6558.png) 7. 创建完成后复制并记录“Value”，作为 **Client Secret**。

说明

此时请务必记录并保存 Value 信息，后续将无法查看。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2aa607f0012411fb18d569407375ccc4.png) #### 步骤二：在 Azure Bot 中启用 Microsoft Teams Channel

说明

创建 Azure Bot 需要 Azure subscription，如果没有 Azure subscription，需要先创建，具体操作请参见官方指导文档：Use the Azure portal to Create an Azure Bot resource。

1. 创建 Resource groups。 1. 在顶部搜索框中搜索“Resource groups”，单击 Resource groups 进入 Resource Manager。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ecaad2fe152731f5f00c41d713a31b4f.png) 2. 单击“Create”创建 Resource group。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_811b4d773429eec0d96c2611a06fea9a.png) 3. 填写相关信息，此处 Resource group name 设置为“ArkClaw\-teams”，配置完成后单击“Review + create”按钮，确认信息无误后单击“Create”按钮完成 Resource group 的创建。 2. 创建 Azure Bot。 1. 在顶部搜索栏输入“Azure Bot”，单击 MarketPlace 下的 Azure Bot。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_be832d4d181a269d3e5609e59fd42f83.png) 2. 在创建页面参考下表填写相关参数，表中未说明的参数保持默认配置。配置完成后单击“Review + create”按钮，确认信息无误后单击“Create”按钮完成 Azure Bot 的创建。 |参数 |说明 | |---|---| |Resource group |选择关联的 Resource group，此处选择上一步创建的 “ArkClaw\-teams”。 | |Data residency |选择“Global”。 | |Creation type |选择“Use existing app registration”，并填写“步骤一：创建并配置 Azure Bot”中保存的 **Application (client) ID ** 和 **Directory (tenant) ID。** | 3. 在 Azure Bot 中启用 Microsoft Teams Channel。 1. 在创建 Azure Bot 创建完成后，在完成页面单击“Next steps”下的“Go to resource”按钮。 2. 在“Settings \> Channels”中的 Available Channels 下单击“Microsoft Teams”。 3. 在弹出的“Teams of Service”对话框中勾选接受条款并单击“Agree”按钮。 4. 在 Messaging 页签下，单击“Apply”按钮，在 Publish 页签下，单击“Apply”按钮。如果 Apply 按钮为灰色且无法单击，可切换至 Calling 页签下勾选“Enable calling”选项，单击“Apply”按钮后再操作。 5. 操作完成后，确认 Microsoft Teams 的 Channels 状态变为 **Healthy**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_337bc5fb1e89b26b2735b363369c3aba.png) #### 步骤三：创建 Teams App 并绑定 Azure Bot 1. 登录 [Teams Developer Portal](https://dev.teams.microsoft.com/) **。需确保登录的账号与登录 Azure Portal、Microsoft Teams 等是同一个账号**。 2. 单击“Create a new app”按钮，设置 App 名称和，单击“Create”按钮创建新的 App。为便于理解，此处示例 App 名称为“Claw\-demo”。 3. 在左侧目录树选择“Configure \> App features”，单击“Bot” 进入 Bots 页面，“Identity your bot”选择“Enter a bot ID”，并输入 **Azure Bot 的 Application (client) ID**，然后勾选`Personal`、`Team`、`Group chat `三个 Scopes，完成后单击“Save”保存信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bd3a28bc3a7300eb2a4f8e104f86a416.png) 4. 在 Configure \> Basic information 页面，检查并填写如下基础信息，已填写的保持默认即可，填写完成后单击“Save”保存信息。 * 信息参数：`App name` 、`Developer name` 、`Website URL `、`Privacy URL` 、`Terms of Use URL `、`Short description` 、`Full description `。 * 填写说明：**这些字段来自Microsoft 365 app manifest schema，是发布/分发Teams App必需的参数。** **`Application (client) ID`是之前记录的 Azure Bot 的 Application (client) ID，URL 相关的参数确保格式正确的 place holder 即可。** ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f9362d425e8f01b55925d386d6bd3ac2.png) 5. 修改 manifest.json 信息。 1. 在左侧目录树选择“Configure \> App package editor”页面，单击 manifest.json 后的“… \> Edit”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_59b1111d0bc66fd56bf6fc926d9ebe64.png) 2. 在`manifest.json`文件编辑状态，修改`schema`和`mainfestVersion`中的版本号为 v1.25 之前的版本（如 v1.23），完成后单击“Save”保存信息。 3. 单击“Update”按钮更新配置，更新完成后在对话框中单击“Confirm”按钮完成操作。 #### 步骤四：将 Teams App 安装到 Teams 1. 当 App validation 通过后，在 Publish \> Distribute 页面单击页面右上角“Distribute”按钮，然后单击“Download the app package”下载 Teams App 安装包。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_abe7effdcd31bd76e76cca99e71ef9a1.png) 2. 打开并登录 Teams 客户端，在左侧导航中选择应用，然后选择“管理你的应用 \> 上载应用 \> 上传自定义应用”，上传已下载的 Teams App 安装包。 3. 上传成功后，显示 App 名称为“Claw\-demo”，单击“添加”按钮。 #### 步骤五：在 ArkClaw 中配置 Azure Bot 信息 1. 打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键，进入 ArkClaw 会话页面。 2. 切换至目标 ArkClaw 实例页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1e8e9dcc5a7029df1875c87003332a70.png) 3. 单击会话页面右上角的“... \> 配置消息渠道”或页面中的“配置消息渠道”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4e1f94d203501c3a06ccfd962f98bf2c.png) 4. 首次绑定渠道选择“连接到 Microsoft Teams”，此处演示为非绑定首个消息渠道，单击“添加”按钮，选择“Microsoft Teams”。 5. 选择“手动配置”，并填写记录的 Azure Bot 的 **Application (client) ID**、**Directory (tenant) ID ** 和作为 **Client Secret 的**“Value”，完成后单击“确定”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3080f8c3ca9bf19c604bb1b5d2ad1a9c.png) 6. 配置大约需要 1～4 分钟，请您耐心等待。配置成功后会返回 Endpoint 信息，复制 Endpoint 单击“Azure Portal”链接。

注意

暂时请勿关闭此页面或在此页面做其他操作。

7. 在 Azure Portal 主页面，单击 Resources 下的目标 Azure Bot 名称，在 Azure Bot 的“Settings \> Configuration”页面 Manager endpoint 中，粘贴从 ArkClaw 复制的 Endpoint 信息，然后单击“Apply”按钮。 8. 回到 ArkClaw 对话页面，单击“MS Teams”消息渠道配置页面的“Confirm”按钮，提交配置。 #### 步骤六：Teams 和 Azure Bot 机器人配对 1. 个人使用 App。 1. 打开并登录 Teams 客户端，在左侧导航中选择应用，然后选择“管理你的应用”。 2. 在应用列表中单击已上传的自定义 App 名称“Claw\-demo”，然后单击“个人应用”。 3. 此时可在对话框中发送信息，如“hello”，首次从 Teams 发送消息后，消息传递链路为 Teams \> Azure Bot \> ArkClaw \> Teams，大约需要 1～2 分钟才会返回消息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_65cdb9a6fec94ea1be798adc2389b76e.png) 2. 团队使用 App。 1. **（可选）** 创建团队频道。在“聊天”中选择“Teams 和频道 \> 查看所有频道”，在查看所有频道页面单击右上角“创建团队”创建一个团队。

说明

如果已有团队频道，可跳过此步骤。