# Deploy Your First Agent

Create and launch your first AI agent on AGOS Cloud.

## Prerequisites

* Wallet connected
* At least **10 AIOU** in your account

## Step-by-Step

### 1. Start Creation

Click the **"+ Create Agent"** button (orange button, top right).

### 2. Configure Agent

Fill in the deployment form:

#### Agent Name (Required)

```
Example: my-trading-bot, community-manager-1
```

* Must be unique
* Used in endpoint URL
* Can be changed later

#### Telegram Bot Token (Optional)

Add now or configure later in Agent Dashboard.

**How to get your token:**

1. Open Telegram and message [@BotFather](https://t.me/botfather)
2. Send `/newbot`
3. Enter a **name** for your bot (display name, can have spaces)
4. Choose a **username** ending in `bot` (e.g., `myagent_bot`)
5. BotFather will send you a token:

   ```
   123456789:ABCdefGHIjklMNOpqrSTUvwxyz
   ```
6. **Copy this token** and paste it in the form

⚠️ **Lost your token?** Message BotFather `/mybots` → Select bot → **API Token** to regenerate.

#### Discord Bot Token (Optional)

Add now or configure later in Agent Dashboard.

**How to get your token:**

1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
2. Click **"New Application"** → Enter a name → **"Create"**
3. In the left sidebar, click **"Bot"**
4. Click **"Add Bot"** → **"Yes, do it!"**
5. Under **TOKEN**, click **"Reset Token"** (or **"Copy"**)
6. **Copy the token** - looks like:

   ```
   MTk4NjIyNDgzNDc3MDk4MzA4.GH1JkX.xxxxxx
   ```
7. Paste it in the form

⚠️ **Lost your token?** Go back to the Bot section → **Reset Token** to generate a new one.

#### Resource Class

| Option           | Best For                          |
| ---------------- | --------------------------------- |
| **Default**      | General use, chatbots, monitoring |
| **Higher tiers** | Heavy workloads, high traffic     |

### 3. Review Costs

The **Activation Cost** panel shows:

| Item                       | Cost                 | Description                              |
| -------------------------- | -------------------- | ---------------------------------------- |
| **Setup Fee**              | ~~29 AIOU~~ **FREE** | One-time VPS provisioning (limited time) |
| **Min. Operating Balance** | 10 AIOU              | Initial agent funds                      |
| **Required Funding**       | 10 AIOU              | Total minimum                            |

🎉 **Limited Time Promotion**: Setup fee is FREE for 2 weeks!

You can fund more than 10 AIOU for additional operating runway.

### 4. Create Agent

Click **"Create Agent"** to proceed.

### 5. Fund Agent Wallet

After creation, you'll be prompted to fund the agent:

* Minimum: 10 AIOU
* Recommended: 50+ AIOU for initial runway

🎉 **Limited Time**: Setup fee is currently FREE (normally 29 AIOU)!

### 6. Wait for Deployment

Deployment typically takes 2-5 minutes:

1. VPS provisioning
2. Container setup
3. Agent initialization

Status shows **"pending"** → **"running"**

### 7. Access Your Agent

Once running:

* Click **"View"** or **"Open Agent UI"**
* Accesses the OpenClaw Agent Dashboard
* Or use the endpoint URL directly

## After Deployment

Your agent is now running! You can:

* [Configure environment variables](/agos/agos-cloud/quickstart/env-variables.md)
* [Connect Telegram/Discord](/agos/agos-cloud/quickstart/connect-messaging.md)
* [Access the Agent Dashboard](/agos/agos-cloud/quickstart/access-dashboard.md)

## Troubleshooting

### Insufficient Balance

* Ensure you have at least 10 AIOU
* Deposit more if needed

### Deployment Fails

* Check agent logs in the platform
* Try different resource class
* Contact support if persists

### Agent Not Starting

* Verify agent wallet has sufficient balance
* Check configuration for errors

## Next Steps

→ [Configure Environment Variables](/agos/agos-cloud/quickstart/env-variables.md)


---

# 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/quickstart/deploy-agent.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.