Skip to content

Agent Configuration

Agent settings overview

Your agent's own settings (AI model, channels, personality) live inside the agent. The OneClickClaw dashboard looks after the server your agent runs on. On the server page you find the cards that matter for the agent: the agent card, the version card, backups and troubleshooting.

Server page - Agent cards

OpenClaw Agent / Your Hermes Agent

Shows whether your agent is running. On OpenClaw: Agent and Gateway status, your channels, and links into the agent. On Hermes: the installed build and your dashboard sign-in.

OpenClaw version / Hermes Agent version

Choose when your agent moves to a newer version.

Backups

Automatic and manual snapshots of your whole server, with Restore.

Choosing when to upgrade

You decide when your agent moves to a newer version. We never upgrade your server on our own. There are two ways to start an upgrade:

  • The upgrade offer. When a newer version is ready for paid servers, the dashboard offers it. Click Upgrade now to start, or Not now to stay where you are.
  • The version card. On the server page, the OpenClaw version or Hermes Agent version card lets you choose Stable (the version most servers run, tested the longest) or Latest (the version new servers get). Click Confirm update to move.

Plan for about half an hour. Your agent is offline while we upgrade, and the server shows a calm "Upgrading" badge. We take a full copy of your server first. A card at the bottom right of the dashboard shows the steps of the upgrade (taking the copy, installing the new version, checking that your agent answers) and tells you when it is done. If the new version does not come up healthy, we put the copy back.

Warning

On OpenClaw, upgrade through the dashboard only. The Settings page has an "Agent Update Warning" for each server: it reminds you to skip the update prompts that appear inside OpenClaw itself.

Restarting your agent and server

The dashboard restarts your agent by restarting its server:

  • Reboot: On the server page, click Reboot. It usually takes a minute or two, and your agent starts again with the server. The server card on the overview has a restart icon for the same job.
  • Stop and Start: Stop shuts the server down until you click Start.
  • Hermes Agent services: The Troubleshooting card on a Hermes server has Restart the dashboard and Restart messaging, which restart one service without a full reboot.

These buttons are hidden while an upgrade runs. See Server Page for the full tour.

Tip

If your agent does not answer, try Reboot first. If it still does not answer, run the checks in the Troubleshooting card and then click Stuck? Get help.

Going back with backups

To undo a change that went wrong, use the Backups card on the server page. It keeps snapshots of your whole server:

  • Automatic snapshots: one right after your server is built, one every week, and one before every update. These cannot be deleted.
  • Manual snapshots: click Create Snapshot to make up to 3 of your own. You can delete them whenever you want. They unlock after the first automatic backup and are removed after 6 months.
  • Restore: click Restore to put your server back to any snapshot, automatic or manual.

Note

A restore brings back the whole server as it was at that moment, including your agent's settings and files.

Activity logging

OneClickClaw records key events about your server and agent: starts, stops, reboots, setup steps, updates, health checks and billing events. They appear in the Event Viewer on your dashboard's Overview page. Click Event Viewer to open it.

Events are sorted into nine categories: SERVER, AGENT, CHANNEL, CONFIG, UPDATE, HEALTH, BILLING, SETUP and SECURITY. Each row shows the time, the category and a short title. Click Load more events... to see older ones.

Note

Activity logs record operational events only. They do not store the content of conversations between your agent and users. Your messages are processed on your own server and by the AI provider you connected, under that provider's privacy policy. For more on data handling, see Data & Privacy.

Tip

If you see many AGENT or HEALTH events in a short time, something may be wrong. Common causes are an invalid API key, a model that is no longer available, or a server short of memory. Check the metrics on your Server Page to rule out resource issues.