Troubleshooting
The portal cannot see your agent
| Symptom | Cause | Fix |
|---|---|---|
| Detecting your agent… never finishes, and the agent is definitely running | The browser is blocking local network access | Click the icon at the left of the address bar, switch Apps on device on (Chrome and Edge) or Local network access (other browsers), or press Reset permissions, then press Recheck in the portal |
| The permission dialog never appeared | It was dismissed or blocked earlier; the browser will not ask again on its own | Same fix as above |
| Agent not detected after the installer finished | The service is not running | In an admin PowerShell: sc.exe start StonkAgentsDaemon, then click Retry |
See Allow local access.
Launching
| Symptom | Cause | Fix |
|---|---|---|
| Launch Agent opens the connect prompt and nothing else | No wallet extension, or it declined | Install a Solana wallet, unlock it, approve the site |
| This wallet already has an agent | One agent per wallet | Open it from the header, or connect another wallet |
| Cluster mismatch between the wallet and the launchpad | Wallet on the wrong Solana network | Switch the wallet to mainnet |
| The launch cost is marked an estimate | The tracker’s SOL price is stale | Wait for the form to re-price, or launch anyway; the tracker clamps the fee between 0.004 and 0.01 SOL |
| Can’t reach the launchpad right now. Retrying… | Tracker unreachable | Wait; the gallery and the form retry on their own |
| Transaction rejected or insufficient SOL | You declined, or the wallet cannot cover rent plus fee | Fund the wallet and retry |
| Success screen says the tracker could not be reached | Launch is on chain, listing is delayed | Nothing to do; the token appears under Agents once the tracker answers |
Installing on Windows
| Symptom | Fix |
|---|---|
| Download unavailable, try again | The release manifest could not be read. Click to retry; check your connection |
| The setup window closes after a minute and chat is still unavailable | That is expected. The command tools finish in the background; see the next section |
| Service will not stop during uninstall | Admin PowerShell: sc.exe stop StonkAgentsDaemon and sc.exe stop StonkAgentsController, then run the uninstaller again |
| Port 7841 in use | Find the process: netstat -ano | findstr 7841, stop it, then start the service |
| Need to see what the agent is doing | Windows Event Viewer (Application log) records service start and stop errors |
The command tools
| Symptom | Fix |
|---|---|
| Your agent is live. Chat will activate in up to 10 minutes after background tools finish installing. | Expected. Wait; three to five minutes on a fresh machine, longer on a slow disk or with aggressive antivirus |
| The command tools did not finish setting up | Press Retry in the portal, or run schtasks /Run /TN "StonkAgents command tools" in PowerShell |
| Retry keeps failing | Read %TEMP%\stonkagents-tools.log and %TEMP%\gateway-setup.log. The npm install is the slow and failure-prone part |
| Onboarding half did not take | Run Configure StonkAgents AI from the Start Menu |
Permissions step
| Row or message | Fix |
|---|---|
| Network access red, Grant | Adds the StonkAgents Agent firewall rule; accept the elevation prompt |
| The change needs administrator approval | Click Grant again and accept the prompt |
| The controller cannot find your agent’s program file | Reinstall the agent |
| The StonkAgents Controller service is not running | Admin PowerShell: sc.exe start StonkAgentsController |
| Only a StonkAgents site can be allowed to talk to your agent | You opened the portal from a host the agent does not know. Use stonkagents.com |
| Storage directory: Saved. Restart your agent to apply it. | The folder is written to config; restart the service (sc.exe stop then sc.exe start StonkAgentsDaemon) |
| Still checking, this can take a moment on first run | A check hit its time budget. Refresh in a few seconds |
| Your agent needs an update to finish setup | The running agent predates the setup checks. Use the update banner |
| Too many changes at once | Wait a second and retry |
Going live and the claim
| Symptom | Fix |
|---|---|
| Binding it to your token now… never finishes | The wallet link may not be in place yet. Keep wallet and agent connected and refresh in a minute |
| Claim refused: wallet mismatch | Connect the wallet that launched the token |
| Claim refused: already bound | Another Agent ID already claimed this launch (for example an earlier install on another machine). There is no self-service re-bind yet |
| Header dot is red, hero says reconnecting | The agent went away. The portal retries a few times, then calls it crashed; start the service again |
Agent chat
| Symptom | Fix |
|---|---|
| The chat page shows the install panel | Your agent is not running, not reachable on localhost:7841, or the browser is blocking local access |
| Chat is disabled right after installing | The command tools are still installing. Wait for the chip to read ready |
| Insufficient credits | Top up in Settings → Credits & API, or use Fast mode |
| Not enough paid credits for detailed mode (need 75) | Top up, or switch to Fast |
| An error naming the tracker or gateway | Your agent is fine; the LLM relay behind it failed. Try again shortly |
| Holder chat says Buy tokens to unlock chat | The connected wallet does not hold the token |
| Holder chat says the owner’s agent is offline | The token’s agent is not running; try later |
Updates
| Symptom | Fix |
|---|---|
| Banner: Update your agent to v… | Click Download update and run the new StonkAgents-Setup-<version>.exe. There is no in-place updater on Windows; the new installer upgrades over the old one and keeps your identity |
| Banner: Your agent v… is no longer supported | Same, but required: the portal will not work with the old build |
| Installer refuses to run over the current version | Uninstall from Windows Settings → Apps first, keep %USERPROFILE%\Documents\.stonkagents, then install |
Getting help
- Contact: stonkagents.com/contact
- The portal’s feedback form reaches the team directly
- X: @stonkagents