# Managing Agents

Create, control, and monitor your agents on AGOS Cloud.

## Agent List View

Navigate to **Agents** in the sidebar to see all your agents:

| Column       | Description                     |
| ------------ | ------------------------------- |
| **Name**     | Agent identifier                |
| **Status**   | active, stopped, pending, error |
| **VPS**      | running, stopped                |
| **Endpoint** | Agent dashboard URL             |
| **Template** | openclaw (default)              |
| **Created**  | Deployment date                 |

## Creating Agents

See [Deploy Your First Agent](/agos/agos-cloud/quickstart/deploy-agent.md) for detailed steps.

Quick summary:

1. Click **"+ Create Agent"**
2. Configure name, tokens, resource class
3. Pay 10 AIOU minimum (~~29~~ FREE setup + 10 balance) - limited time!
4. Wait for deployment

## Agent Actions

### Start/Stop Agent

Controls agent runtime (not VPS):

* **Stop**: Pause agent processing (VPS still runs)
* **Start**: Resume agent processing

To stop/start:

1. Find agent in list
2. Click **actions menu** (three dots)
3. Select **Start** or **Stop**

⚠️ **Note**: VPS billing continues regardless of agent status!

### Delete Agent

Permanently removes agent and stops all billing:

1. Click **actions menu**
2. Select **Delete**
3. Confirm deletion

⚠️ **Warning**: This is irreversible! All data is lost.

## Monitoring Agent Status

### Status Indicators

| Status      | Meaning            | Action          |
| ----------- | ------------------ | --------------- |
| **active**  | Running normally   | None            |
| **stopped** | Agent paused       | Start to resume |
| **pending** | Deploying/starting | Wait            |
| **error**   | Problem detected   | Check logs      |

### VPS Status

Shows underlying infrastructure:

| Status      | Meaning            |
| ----------- | ------------------ |
| **running** | VPS operational    |
| **stopped** | VPS stopped (rare) |

## Agent Details Page

Click agent name to view details:

### Overview Cards

| Card             | Info                                  |
| ---------------- | ------------------------------------- |
| **Details**      | ID, template, image, wallet, endpoint |
| **AIOU Balance** | Current balance, frozen amount, spent |
| **VPS & Access** | Status, IP, SSH credentials, region   |

### Actions on Details Page

* **Stop/Start**: Control agent runtime
* **Fund**: Add AIOU to agent wallet
* **View**: Open Agent Dashboard

## SSH Access

Connect directly to agent's VPS:

```bash
ssh root@{public-ip}
# Password: [reveal in dashboard]
```

Use for:

* Advanced debugging
* File system access
* Custom configurations

## Bulk Operations

Currently supported:

* View all agents in list
* Individual start/stop/delete

Not supported:

* Bulk delete
* Mass start/stop

## Agent Limits

| Limit                | Default                    |
| -------------------- | -------------------------- |
| **Max agents**       | Subject to platform policy |
| **Budget per agent** | Configurable               |

Contact support to increase limits.

## Troubleshooting

### Agent Won't Start

* Check agent wallet has sufficient balance
* Review agent logs
* Verify configuration

### Deployment Fails

* Ensure sufficient AIOU (10 minimum)
* Try different resource class
* Check platform status

### High Costs

* Review [Understanding Costs](/agos/agos-cloud/platform/costs.md)
* Consider smaller resource class
* Delete unused agents

## Best Practices

✅ **Do**:

* Name agents descriptively
* Monitor balance regularly
* Set up alerts for low balance
* Delete agents you no longer need

❌ **Don't**:

* Leave stopped agents running (costs money)
* Ignore low balance warnings
* Share SSH credentials

## Next Steps

→ [Funding and Budgets](/agos/agos-cloud/platform/funding.md) to manage agent finances


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agos.gitbook.io/agos/agos-cloud/platform/managing-agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.