# AgentRouter — Troubleshooting

> Base Sepolia testnet. Wallet setup and spending require the owner's authorization. Follow one wallet path.

Find your next step when wallet setup, a payment or an inference request does not go as expected.

[Human guide](https://docs.agentrouter.cc/troubleshooting) · [Pricing](https://agentrouter.cc/pricing#agents) · [Documentation index](https://docs.agentrouter.cc/llms.txt)

## Common questions

## The wallet will not start

For Coinbase on a headless Linux machine, use the [Linux appendix](https://docs.agentrouter.cc/wallets/coinbase-linux). Identify the error before installing packages or changing the sandbox. Keep the wallet's [first terminal running](https://docs.agentrouter.cc/wallets/coinbase-linux#linux-run) while issuing commands in the [second](https://docs.agentrouter.cc/wallets/coinbase-linux#linux-status).

For MetaMask, check that the [CLI is on PATH](https://docs.agentrouter.cc/wallets/metamask#metamask-check) and that [authentication](https://docs.agentrouter.cc/wallets/metamask#metamask-auth) and [initialization](https://docs.agentrouter.cc/wallets/metamask#metamask-init) completed. Reopening a terminal does not preserve the PATH or helper-directory settings from an earlier shell.

## Coinbase reports NOT DEPLOYED

Stop before purchase. The documented path requires an already-deployed smart account; use the [deployment check](https://docs.agentrouter.cc/wallets/coinbase#coinbase-deployed). There is no supported first-deployment procedure in this guide yet. An address receiving test tokens does not establish that the account is deployed.

## Test tokens appear to have no value

In MetaMask, [inspect token amounts under Base Sepolia](https://docs.agentrouter.cc/wallets/metamask#metamask-balance). An unpriced token or a total dollar value of zero can reflect missing testnet pricing. Check the token's amount and network before funding again.

## Payment failed or the response is missing

Keep the private response and error files. Do not repeat the pay command automatically: another invocation can create another purchase. A wallet balance change, receipt or transaction reference does not reveal a lost bearer key.

The stock-client examples do not retain an optional recovery capability, so self-service lost-key recovery is unavailable for this flow. Do not pay again as a recovery attempt.

## The first inference did not return a useful answer

A successful HTTP status alone does not prove a useful response. Follow the documented [model](https://docs.agentrouter.cc/use/models), output bound and non-streaming request in the [OpenAI-compatible](https://docs.agentrouter.cc/use/openai) or [Anthropic-compatible](https://docs.agentrouter.cc/use/anthropic) guide. Preserve the request identity and body when the outcome is uncertain; do not generate a new identity to bypass an uncertain charge.

## You opened another terminal

Your wallet settings and bearer-key environment variable may no longer be present. Restore the wallet settings using its guide: [MetaMask sessions](https://docs.agentrouter.cc/wallets/metamask-reconnect) or [Coinbase](https://docs.agentrouter.cc/wallets/coinbase). Keep the original purchase response private and available; do not make another purchase just to restore a session.

## Sharing a problem

Share the failing step, operating system, tool version and sanitized error. Never include a login code, QR URL, session credential, wallet private key, bearer key or unredacted purchase response.