---
app: agent
audience:
  - owner
since: 0.1.0
ui_only: false
agent_actions:
  - tool: app_office_get
    permission: auto
    example: which agents are asleep or broken?
  - tool: app_agent_wake
    permission: auto
    example: wake Ani
  - tool: app_agent_reprovision
    permission: auto
    example: Ani needs attention, fix her
agent_examples:
  - why is the sales agent not answering WhatsApp?
  - the agent says needs attention
llm_weight: promote
title: An agent is not working
description: Asleep, needs attention, runtime not running, or the app was closed
  — how to read the desk and what to press.
editUrl: true
head: []
template: doc
sidebar:
  order: 2
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { AgentAsk } from "@components";

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

## Read the desk first

| 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](/agent/automations/always-on/). |

## 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](/agent/channels/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](/agent/troubleshooting/model/).

## Auto-sleep

**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

<AgentAsk />

## Related

[Awake and asleep](/agent/office/awake-and-sleeping/) · [Updates and health check](/agent/troubleshooting/updates/)