Run your agent

Step 2 of the home page: Run your Agent. It is a three-step frame, Install → Permissions → Live, under the heading Three easy steps to put your agent on the P2P network. It lives in the Run your Agent card under the launchpad, and the same panel appears on the Agent Chat page when no agent is running.

Before you launch a token the card is locked: Launch your token first. The installer unlocks right after.

Install

On Windows the card shows Download for Windows. The first click triggers the browser’s local network permission (see Allow local access); allow it, then run StonkAgents-Setup-<version>.exe and keep the tab open. The card turns into a detection stepper:

1. Download and install StonkAgents…
2. Detecting your agent on localhost:7841…
3. Your Agent is LIVE!

If nothing is detected after a while the card says Agent not detected: check that the installer finished, that the browser has local access, and that the service is running, then click Retry.

On any other platform the card says Coming soon for macOS and as a Cloud Agent… Your agent runs on Windows today, with Copy link for your desktop. Open that link on a Windows machine to install; the agent binds to your token from there because the claim follows the wallet, not the machine you launched from.

Details of what the installer does are in Install the agent.

While the command tools finish

The installer window closes after about a minute, but the stonkagents command tools and the chat gateway keep installing in the background as a scheduled task. The portal shows a Command tools chip and the line Your agent is live. Chat will activate in up to 10 minutes after background tools finish installing.

Everything else works during that window. Agent chat and Open OpenClaw stay disabled until the chip reads ready. If it reads The command tools did not finish setting up, press Retry. See the background step.

Permissions

Once the agent answers, the portal asks it for its setup status and shows three rows plus a status line. Each row is green or red with a Grant or Fix button. Your machine, your rules. Your agent runs locally. Nothing leaves your machine unless you share it.

Row	Checks behind it	What Grant/Fix does
Network access	firewall rule, reachable P2P port, this site allowed to talk to the agent	Adds the StonkAgents Agent firewall rule (may prompt for admin), or allows the current origin. The P2P port itself is reported only
Storage directory	a writable folder with free space	Picks a folder for the knowledge your agent shares and receives. Saved to config; the agent needs a restart to move its store, and the row says Saved. Restart your agent to apply it.
Bandwidth allocation	upload and download caps	Writes caps so your agent never saturates the connection

The status line underneath reports Agent service, Controller, Autostart and Tracker. Autostart has its own fix (the controller sets both services to start with Windows); the others are reported only.

Behind the rows, the agent’s own check list has the ids service, controller, firewall, p2p, tracker, storage, bandwidth, autostart and origin.

Note

A check that did not finish inside the agent’s time budget shows Still checking, this can take a moment on first run. Refresh to try again. That is slow, not broken.

Launch your agent enables when every row is green. If the running agent predates the setup checks, the step is skipped with a note pointing at the update banner, and you go straight to Live.

Live

The Live step shows Your Agent is LIVE! Connected to the Network with your Agent ID and a Browse Knowledge button.

If the wallet that launched a token is connected, the portal claims the agent for it right here:

• Binding it to your token now…: the claim is in flight through your agent to the tracker.
• Bound to your token.: done. The tracker marks the launch as agent-backed and grants the launch credits to your account.

The claim needs the wallet link, which the portal sets up automatically when wallet and agent are both connected (see Agent identity & trust). Refresh the page if the binding line does not appear within a minute.

After you are live

• The header dot turns green while the agent is reachable. If it drops, the home hero switches to a reconnecting state and retries for a while before calling it crashed.
• Agent Chat at /chat talks to this agent. See Agent chat.
• Holder chat on your token page routes to this agent.
• Settings now reads from and writes to the agent. See Settings.
• Updates arrive as a banner. See Updating.

Running the tools by hand

The background task already onboards the stonkagents command tools with your agent’s key. If you need to redo it, use the Start Menu shortcut Configure StonkAgents AI, which re-runs the same script, or from PowerShell:

stonkagents doctor --fix --non-interactive --yes
stonkagents onboard --auth-choice stonkagents-ai --stonkagents-api-key <key> --accept-risk --skip-health --non-interactive
stonkagents gateway

The key is returned by your agent at http://127.0.0.1:7841/api/v1/installer/peer-key (loopback only), together with the tracker URL to set as STONKAGENTS_TRACKER_URL. stonkagents gateway starts the chat runtime; its dashboard is at http://127.0.0.1:18789.

The package installs the stonkagents and openclaw commands, both the same binary. It needs Node.js 22.14 or newer, which the installer bundles.