OneClickClaw.io
$

Run Diagnostics

The server page has a Troubleshooting card. It runs checks against your server from the dashboard and shows the result right under each button, so you can see what is wrong before you contact support. On an OpenClaw server, its Run Diagnostics button runs a full health checklist in one go. (Older versions of this page described a downloadable file; that button is gone, and the Troubleshooting card does this job now.)

What the checks cover

On an OpenClaw server the card offers:

  • Test Connectivity: checks that your agent's gateway can be reached.
  • Check DNS: checks that your server's address points to the right server.
  • Test Provider Key: lists the models your AI provider offers, to prove your key works.
  • Test Channel: checks the health of your messaging channels.
  • Flush Messages: clears waiting Telegram messages.
  • Force Config Re-push: sends your saved key and channel settings to the server again.
  • Run Diagnostics: a full server health checklist covering the gateway, the provider key and the channels.

On a Hermes Agent server the card offers:

  • Check my dashboard: checks that your Hermes address answers over a secure connection.
  • Check DNS: checks that your address still points at your server.
  • Restart the dashboard: restarts the service that serves your Hermes control panel.
  • Restart messaging: restarts the service that connects your agent to your chat apps.
Server page - Troubleshooting

Troubleshooting

Click the card title to open it. One button per check.

Run Diagnostics

Full server health checklist: gateway, provider key, channels

How to run them

1

Open the server page

On the overview, click Control Panel on your server card.

2

Open the Troubleshooting card

Scroll down to Troubleshooting and click it to open it.

3

Click a check

Click Run Diagnostics, or any other check. The result appears under the button, with a line for each item checked. Each action has a 30-second cooldown before you can run it again.

When to use them

  • Your agent does not answer and a reboot did not fix it.
  • You see repeated errors or strange behaviour.
  • You changed your AI key or a channel and want to confirm it works.
  • Before you open a support ticket.

Tip

When you still need help, click Stuck? Get help at the top of the server page to open a ticket. Mention what the checks showed: it helps us answer faster.

For common problems, see Agent Not Responding and Server Offline.