# Deploy & Manage OpenClaw

OpenClaw 1-Click lets you deploy a personal AI Agent on GreenNode Agentbase in 40–60 seconds, automatically connected to GreenNode MaaS with no manual configuration required.

For an overview of concepts, architecture, and deployment options, see [OpenClaw 1-Click](https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/one-click-openclaw/openclaw-1-click).

***

## Deploy an OpenClaw Instance

### Access the Agent Marketplace

You can access the Agent Marketplace in two ways:

* **Option 1**: Go to the GreenNode homepage at <https://dashboard.console.vngcloud.vn/>. From the main dashboard, navigate to **AI Stack** and select **Agentbase** → **Agent Marketplace**.
* **Option 2**: Go directly to <https://aiplatform.console.vngcloud.vn/agent-marketplace>.

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2FTa2Q8yzEhOgue6Slwvzz%2FScreenshot%202026-04-03%20154428.png?alt=media&#x26;token=0aa3e713-0bc6-408e-b8f7-d6dbc78aad43" alt=""><figcaption></figcaption></figure>

### Deploy an OpenClaw Instance

On the Agent Marketplace, find the **OpenClaw Featured Card** or click **"Deploy OpenClaw With 1 Click!"** on the Hero Banner. The deployment process goes through the following steps:

#### Step 1: Configure Your Deployment

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2FIj8iASsJGc2WveDhB9jX%2FScreenshot%202026-04-03%20154505.png?alt=media&#x26;token=68ebba82-f219-47af-a590-e60e6a643324" alt=""><figcaption></figcaption></figure>

The configuration screen has 3 sections:

**Section 1 — AI Source**

Select the AI source for your OpenClaw instance:

| Option                        | Description                                            | Requirement                |
| ----------------------------- | ------------------------------------------------------ | -------------------------- |
| **GreenNode MaaS** (default)  | Automatically connects to GreenNode Model-as-a-Service | GreenNode account required |
| **BYOK — Bring Your Own Key** | Use an API key from an external provider               | Valid API key required     |

{% hint style="info" %}
**GreenNode MaaS:** The default model is **qwen3-5-27b**.
{% endhint %}

When selecting **BYOK**, provide the following additional details:

* **Provider**: Select your provider (OpenAI, Anthropic, Gemini, Custom).
* **API Key**: Enter your API key. The system will validate it before proceeding.
* **Model**: Select the model corresponding to your chosen provider.

{% hint style="warning" %}
**BYOK note:** If the API key is invalid or expired, the system will show an inline error and block submission. Double-check your key before submitting.
{% endhint %}

**Section 2 — Instance Configuration**

| Field             | Description                                 | Notes                                                                  |
| ----------------- | ------------------------------------------- | ---------------------------------------------------------------------- |
| **OpenClaw Name** | Instance identifier                         | Auto-filled as `openclaw/{username}`, cannot be changed after creation |
| **Flavor**        | Compute resource configuration (vCPU × RAM) | Default: `2×4`. Options include `4×8`, `8×16`...                       |

**Section 3 — Channel Configuration (Optional)**

Connect OpenClaw to a messaging platform so you can chat right after deployment.

| Field                | Description        | Notes                                                  |
| -------------------- | ------------------ | ------------------------------------------------------ |
| **Channel Provider** | Messaging platform | Supported: Telegram, Zalo                              |
| **Mode**             | Connection mode    | Pairing (default) or Allow List                        |
| **Bot Token**        | Channel bot token  | Optional. Can be configured later at Settings → Config |

Once all fields are filled, click **"Start Setup"** to begin provisioning.

#### Step 2: Provisioning — Setting Up Your Workspace

The **"Setting Up Your Workspace"** screen displays a loading spinner while the system automatically prepares your environment. Once complete, you receive a **Gateway Token** and the **OpenClaw web admin URL** to log in and start using immediately.

{% hint style="info" %}
**If provisioning fails:** The system displays an error message with a **Retry** button.
{% endhint %}

#### Step 3: Deploy Success

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fk4uzCxPD5ylFuZCYs4XI%2FScreenshot%202026-04-03%20140457.png?alt=media&#x26;token=8770bb4f-e86b-457e-ad87-4035978a04b2" alt=""><figcaption></figcaption></figure>

Once provisioning is complete, the Deploy Success screen shows your instance details:

| Field                    | Description                                                  |
| ------------------------ | ------------------------------------------------------------ |
| **Instance Name**        | The name of your created instance (e.g. `openclaw/username`) |
| **Status**               | 🟢 Active                                                    |
| **Gateway Token**        | Token used to log in to the OpenClaw web admin               |
| **OpenClaw Gateway URL** | Link to your OpenClaw web admin                              |
| **Created At**           | Timestamp                                                    |

Click **"Open OpenClaw"** to access your OpenClaw Gateway Dashboard and start using it immediately.

***

## Manage OpenClaw Instances

### Access My Agents Dashboard

In the Agentbase interface, select **My Agents** from the navigation menu. This page shows a list of all your OpenClaw instances. You can filter by status to view instances that are **Active** or **Stopped**.

Each instance in the list shows: instance name, status, AI model in use, version, and tags.

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2FFUibRru4kwdPSvEuye57%2FScreenshot%202026-04-03%20154608.png?alt=media&#x26;token=ca760ec0-6a0a-4edb-81fa-38100bb84d40" alt=""><figcaption></figcaption></figure>

### Open an Instance

1. In My Agents, find the instance you want to access.
2. Click **"Open"** on the instance.
3. You are redirected straight to the OpenClaw web admin — no wizard or re-provisioning required.

### Stop an Instance

1. In My Agents, find the instance you want to stop.
2. Click **"Stop"** on the instance.
3. Confirm in the dialog that appears.

After stopping, the instance status changes to **Stopped** and its URL is no longer accessible.

### Restart an Instance

1. In My Agents, filter by **Stopped** status to find the instance.
2. Click **"Restart"** on the instance.
3. The instance transitions through **Starting → Active**.

After restarting, the URL becomes accessible again.

### Delete an Instance

1. In My Agents, click **"Delete"** on the instance you want to remove.
2. A confirmation dialog appears, requiring you to type the **instance name**.
3. Enter the exact instance name and click **"Delete"** (red button) to confirm.

{% hint style="warning" %}
**Note when deleting:**

* Deletion is **permanent and cannot be undone**.
* All instance data will be **permanently deleted**.
  {% endhint %}