Docs

ArkClaw Enterprise

Advanced features

Using AI diagnosis to troubleshoot and fix ArkClaw failures

AI diagnosis is a set of troubleshooting and recovery capabilities provided by ArkClaw. You can use this feature to identify and fix common operational issues in ArkClaw. When ArkClaw exceptions occur, such as no response or startup failure, you can manually trigger AI diagnosis, and the system automatically performs troubleshooting and repair.

Applicable scenarios

Issue type	Applicable scenarios
ArkClaw unresponsiveness	Applicable when ArkClaw exceptions or crashes cause long-term unresponsiveness.
ArkClaw startup failure	Applicable when ArkClaw fails to start properly, or keeps showing that ArkClaw is being connected.
ArkClaw slow response	Applicable when the conversation can be completed, but the overall response time is long.
Feature usage exceptions	Applicable to scenarios where functions such as models, plugins, Skills, and scheduled tasks encounter errors, execution failures, or abnormal results.
Other exceptions/uncertain issues	When the cause of the issue cannot be determined, you can prioritize selecting this option to perform a basic diagnosis of core services. For example, check whether ArkClaw is online, whether the service is running properly, and whether the responses stay stable.

Operation instructions

Only ArkClaw instances in the running or restarting status support the AI diagnosis feature.

AI diagnosis only supports fixing some automatically identifiable failures and cannot cover all issue scenarios (such as plugin/skill errors and third-party IM connection exceptions). If your issue is not resolved through this diagnosis, you can provide feedback by referring to the "Issue not resolved" below for help.

You can select multiple issue types simultaneously for batch troubleshooting, or repeatedly initiate diagnosis for issues of the same type to verify the issue status.

Procedure

In the upper-right corner of the page, click "... > AI diagnosis".

Select the corresponding issue card based on the issue you encountered.

tip

If the "Diagnose ArkClaw slow response" feature is unavailable, please select "Diagnose ArkClaw slow response > Enable" to join the User Experience Improvement Program.

The User Experience Improvement Program is enabled by default. If you do not need it later, you can exit the User Experience Improvement Program as needed.

(Optional) Enter issue symptoms, error messages and other details in the supplementary information field, such as specific scenarios of unresponsive instances and key error log snippets, to help the AI diagnosis assistant identify issues more accurately.

Click the "Start diagnosis" button and wait for the system to perform diagnosis and repair.

tip

The diagnosis and repair process is expected to take 3-5 minutes. Please wait.

To stop the diagnosis midway, click the "Cancel diagnosis" button. After the cancellation, the system will immediately stop subsequent diagnosis steps. Completed actions will not be automatically undone.

Based on the diagnosis result, you can perform the following operations:

Continue diagnosis: You can further supplement the issue description based on the current diagnosis result, and the system will initiate a new diagnosis task.

Evaluate the diagnosis result: You can provide feedback on each AI diagnosis by clicking the thumbs-up or thumbs-down button. The platform will identify issues arising during diagnosis based on your feedback and continuously optimize the diagnostic performance.

Give a thumbs-up for the diagnosis result:

Below any satisfactory AI diagnostic response, click the .

Give a thumbs-down for the diagnosis result:

Below any unsatisfactory AI diagnostic response, click the .

In the pop-up window, select the reasons for your dissatisfaction (multiple selections allowed). Click the "Submit" button to complete the operation.

Related features

Feature	Actions
Active pushing of diagnosis cards	When the AI diagnosis module detects an exception, it proactively pushes a diagnosis card via the ArkClaw Console or Feishu message channel to help you quickly identify the issue. Install and enable the "ArkClaw error AI diagnosis plugin". This feature requires "ArkClaw Error AI Diagnosis plugin" v 2026.7.14 or later. Learn more By enabling the "ArkClaw error AI diagnosis plugin", you can enable active pushing of diagnosis cards. Learn more tip By disabling the "ArkClaw error AI diagnosis plugin", you can disable active pushing of diagnosis cards. When the AI diagnosis module detects an exception in ArkClaw, it will push a diagnosis card to you when you send a message to ArkClaw. Click the "Initiate diagnosis" button. The AI diagnosis module will automatically identify potential causes based on exception information and provide resolution suggestions.
View diagnosis history	You can also view the records and details of previous AI diagnoses to trace the troubleshooting process and repair result of the target diagnosis task. Click . In the diagnosis history list, find the target record and click the "View conversation" button to view details.
Create multiple diagnosis tasks	During the current diagnosis, you can initiate new diagnosis tasks. Multiple diagnosis tasks do not interfere with each other. In the upper-right corner of the AI diagnosis pane, click the ➕ icon to initiate a new diagnosis task. Refer to the above procedure to perform the diagnosis. tip Creating a new diagnosis does not interrupt ongoing diagnosis tasks. To return to a previous diagnosis, click (diagnosis history) to view and switch.

Last updated: 2026.08.20 10:36:38