Skip to main content

Why won't my agent start or reply?

How to finish an agent's setup, read its status, and act on the chat and Start messages about stopped, starting or incomplete agents.

An agent answers only when its setup is complete and it's Running. Open it from Panel, then Agents, and check the status shown for it.

1. Finish the setup

A new agent starts as Setup Required. Its page shows "Complete your agent setup to get started." with a Complete Setup button that takes you to the credential cards.

  • Fill in every required card and click that card's own Update button (for example Update Telegram). Each card saves separately, so typing in the fields isn't enough. Optional cards, such as Telegram, Slack or Discord, can stay empty.

  • The card people miss most is Wiro AI Models: choose one of your Wiro projects there (see Why does my agent ask for a Wiro project?).

  • Cards with a Connect button open the provider's consent screen: approve it, then pick the account the agent should use. Some cards check a token instead, with a button such as Save & Connect System User Token. See How do I connect an integration to my agent?

When every required card is done, click Start.

2. Check the status

  • Stopped: click Start.

  • Queued or Starting: wait a moment; the agent is on its way.

  • Stopping: wait until it shows Stopped, then click Start.

  • Running: ready for messages.

  • Error: click Start to try again. If it keeps going back to Error, contact support with the agent's name.

  • Setup Required: a required card is still empty or not connected. Go back to step 1.

  • Subscription Expired or Cancelled: the plan has ended. See How do I cancel, renew or upgrade my agent plan?

3. What the chat messages mean

  • "Agent is stopped. Start it from the agent panel before sending messages." Click Start.

  • "Agent is starting up. Please wait a moment and try again." It's queued or starting; try again shortly.

  • "Agent is stopping. Please wait a moment and try again." Wait until it shows Stopped, then start it.

  • "Agent is in error state. Restart it from the agent panel before sending messages." Click Start.

  • "Agent setup is incomplete. Complete the setup before sending messages." Finish step 1.

  • "Agent has no remaining credits. Renew your subscription or buy a credit pack to continue." See My agent says it has no remaining credits.

When Start is refused

  • "Agent setup is not complete. Please fill in your credentials before starting." A required card is missing (step 1).

  • "No credits available. Please renew your subscription or purchase extra credits." The credits are used up.

  • "Subscription required — please subscribe to this agent before starting it." The plan has expired with no extra credits left, or was never paid.

After you change something

Saving a credential card, the agent's skills or its settings restarts a running agent automatically. It's unavailable for a short moment, then comes back with the new values. A stopped agent picks up the change the next time you start it.

Details for developers: agent statuses, Start, Setup Required and message failures.

Did this answer your question?