AI 诊断是 ArkClaw 提供的一套故障排查与恢复能力，用于排查及修复 ArkClaw 常见运行故障。当 ArkClaw 出现无响应、启动失败等异常时，您可手动触发 AI 诊断，系统将自动完成排查与修复。 ## 使用场景 |问题类型 |使用场景 | |---|---| |ArkClaw 无响应 |适用于 ArkClaw 异常或崩溃导致的长时间无响应。 | |ArkClaw 启动失败 |适用于 ArkClaw 无法正常启动，或一直显示 `ArkClaw 连接中`。 | |ArkClaw 响应偏慢 |适用于对话可以完成，但整体响应耗时偏长的情况。 | |功能使用异常 |适用于模型、插件、Skills、定时任务等功能报错、执行失败或结果异常的情况。 | |其他异常/不确定问题 |当您无法确定问题原因时，可优先选择此项，进行基础的核心服务排查，例如 ArkClaw 是否在线、服务是否正常、响应是否稳定等。 | ## 操作说明 * 仅支持 **正常运行** 及 **重启中 ** 的 ArkClaw 使用 AI 诊断功能。 * AI 诊断仅支持对部分可自动识别的故障进行修复，**无法覆盖**所有问题场景（例如插件/技能报错、第三方 IM 连接异常等）。若您的问题未通过本次诊断得到解决，请参考下文“问题未解决”反馈获取帮助。 * 支持同时选择多个问题类型进行批量排查，也可以针对同一类型问题重复发起诊断，便于多次验证问题状态。 ## 操作步骤 1. 打开浏览器，在浏览器地址栏中输入登录ArkClaw链接，按“回车”键，进入ArKClaw会话页面。 2. 切换至目标ArKClaw。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5c2bbeb3f786fde66eca65e3c98d4a8d.png) 3. 在页面右上角，选择“更多 **\>** AI 诊断”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_26980465a87b6a5843c5e2fa838331f6.png) 4. 根据您实际遇到的问题，选择对应问题卡片。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e57a8766cbeccc27cc48f5113c23b274.png)

说明

因已开启「可观测数据脱敏」，部分诊断所需信息无法获取，响应慢的深度定位可能受限。如需更完整的诊断结果，请联系管理员评估是否临时关闭该配置。

5. （可选）在补充信息中输入问题现象或报错信息等，例如实例无响应的具体场景、关键报错日志片段等，便于 AI 诊断助手更精准地定位问题。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a96c85ba3f3abc8596f379d44535999b.png) 6. 单击“开始诊断”按钮，等待系统执行诊断与修复。

说明

诊断与修复预计耗时3～5 分钟，请耐心等待。

如需中途停止诊断，可单击“取消诊断”按钮。取消后系统将立即停止后续诊断，已完成操作不会自动撤销。

7. 根据诊断结果，您还可以进行如下操作。 * **继续诊断：** 您可以基于当前诊断结果进一步补充问题说明，系统将继续发起诊断。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ee7c304be3cbb4c8e50758d51b8f9590.png) * **评价诊断结果：** 您可以通过点赞或点踩对每次 AI 诊断进行反馈，平台将根据您的反馈识别诊断过程存在的问题，并持续优化其效果。 * **点赞诊断结果：** 在满意的 AI 诊断回复下方，单击![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_66b02a2acf5e3dccb0c12c5c9d84055d.png) 按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f29e04919830a1ad8edc5b78feab310f.png) * **点踩诊断结果：** 1. 在您不满意的 AI 诊断回复下方，单击![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c1bdf3b26d4936c2db73b8b9e24c3743.png) 按钮。 2. 在弹窗中选择您不满意的原因（支持选择多个原因），单击“提交”按钮完成操作。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f4b1d8b16a0eaa5021e8b77f0605ca22.png) ## 相关功能 |功能 |操作 | |---|---| |主动推送诊断卡片 |当 AI 诊断检测到异常，可以主动向 ArkClaw 控制台及飞书消息渠道推送诊断卡片，帮助您快速定位异常问题。

1. 安装并开启“ArkClaw 报错 AI 诊断插件”。

1. 该功能需安装 `v 2026.7.14` 及以上版本的“ArkClaw 报错 AI 诊断插件”。[了解更多](https://docs.volcengine.com/docs/87732/2275231)

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1134f8a3639cfeeea389f909e0e20be1.png)

2. 开启“ArkClaw 报错 AI 诊断插件”，即可开启主动推送诊断卡片功能。[了解更多](https://docs.volcengine.com/docs/87732/2371396)

说明

关闭“ArkClaw 报错 AI 诊断插件”，即可关闭主动推送诊断卡片功能。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_665b169b66fc04a0ba2e4068e606f1b0.png)

2. 当 AI 诊断发现 ArkClaw 出现异常，会在您向 ArkClaw 发送消息时为您推送诊断卡片。

* ArkClaw 控制台示例

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b22f6092d34a13ddee53ce1517b8e3c8.png)

* 飞书消息渠道示例

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_423ebf82121dd2167a75314cc94a6e76.png)

3. 单击“发起诊断”按钮，AI 诊断将自动根据异常信息排查可能原因，并提供处理建议。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_b71a2c109bb96353c46f12c2a03862ce.png) | |查看诊断历史 |您还可以通过查看历次 AI 诊断的记录与详情，追溯目标诊断任务的问题排查过程和修复结果。

1. 单击![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_540b45c3f6349c15e87c0684db69a9ef.png) 图标。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cb162c95f584203b5ac3237181311e80.png)

2. 在诊断历史列表中，找到目标记录，单击“查看对话”按钮，可以查看其详情。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5b33f1f8496a89b2f002ce97de624f5e.png) | |新建多个诊断任务 |在**当前诊断进行期间**，您可以同时发起新的诊断任务，多个诊断任务互不影响。

1. 在 AI 诊断面板右上角，单击 ➕ 图标，发起新的诊断。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bf391b0563d57efb8c9589620522ee1d.png)

2. 参考上述 [操作步骤](https://docs.volcengine.com/docs/87732/2485345#8dUq7AU9)，完成诊断。

说明

新建诊断不会中断当前正在进行的诊断任务。

如需返回之前的诊断，可单击

（诊断历史）查看和切换。

ArkClaw 企业版