Skip to content

An agent is not working

Who this is for: an owner whose agent went quiet.

What you see What it means What to do
Sleeping — no gateway, no automations The agent is asleep: no channels, no scheduled jobs. Chatting with it in the panel still works. Wake up (start gateway) on its desk, or ask any agent to wake it.
Needs attention Setup failed halfway (a download, a model without a key, a port in use). Open the agent’s settings → Retry setup; it resumes from the failed step.
A grey, transparent avatar at its desk Asleep and idle. Same as sleeping.
“The agent runtime is not running” The Hermes runtime behind every agent stopped. Press the runtime button in the top bar to start it; if it keeps stopping, run Run agent health check in Settings.
Nothing moves, no bubbles, no runs since yesterday The app was closed — every agent stops with it. Open the app; the agents that were awake wake again and missed jobs run once. See Keeping the office running.

An agent that is awake but silent on a channel

Section titled “An agent that is awake but silent on a channel”
  1. Settings → Accounts: click the agent’s row — is it connected, or does it show paused (asleep) or error? Press Test connection.
  2. Who can chat: on a Private channel only listed ids get an answer; strangers are ignored. See Who can chat.
  3. Automations: an incoming-message automation (leads from WhatsApp, complaints, one number for the team) must be on for the channel to do more than chat.
  4. Model: an agent without a working model answers nothing — see Model problems.

Settings → Office → Put idle agents to sleep after (default 2 hours) puts an agent with no activity to sleep to save memory. The app wakes it a few minutes before its next scheduled job; a customer message does not wake a sleeping agent — keep customer-facing agents awake or the auto-sleep off.

✦ Ask your agent

Things you can say to an agent in Bakulai Agent:

“why is the sales agent not answering WhatsApp?”“the agent says needs attention”
  • “which agents are asleep or broken?”runs directly
  • “wake Ani”runs directly
  • “Ani needs attention, fix her”runs directly

Awake and asleep · Updates and health check