> For the complete documentation index, see [llms.txt](https://docs.greennode.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.greennode.ai/ai-stack/agent-base/agent-runtime/openclaw/deploy-and-manage-openclaw.md).

# 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](/ai-stack/agent-base/agent-runtime/openclaw/openclaw-1-click.md).

***

## 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.greennode.ai/>. From the main dashboard, navigate to **AI Stack** and select **Agentbase** → **Agent Marketplace**.
* **Option 2**: Go directly to <https://aiplatform.console.greennode.ai/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&amp;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&amp;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     |

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  | Not enforced by the form, but **fill it in here** — see the note below |

{% hint style="warning" %}
**Enter the Bot Token at this step.** The deploy form does not require a Bot Token, but if you leave it empty, adding the token after the instance is created means asking the agent inside OpenClaw to update the channel configuration itself — which is hard to do and easy to get wrong. Get your bot token first via [Get Bot Token and Pairing](/ai-stack/agent-base/agent-runtime/openclaw/get-bot-token-and-pairing.md), then paste it here so the channel connects as soon as the deploy finishes.
{% endhint %}

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="warning" %}
**Save the Gateway Token the moment it appears.** This token is **shown only once** on the success screen — afterwards it is hidden and cannot be retrieved. Copy it somewhere safe (a password manager) before you leave the page. If you have already lost it, contact the GreenNode team for help.
{% 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&amp;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 — **shown only once**, copy and save it immediately |
| **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.

{% hint style="warning" %}
**Only start pairing once the status is 🟢 Active.** If you send `/start` to your Telegram/Zalo bot while the instance is still `Creating`, the bot returns no pairing code — and that message is not reprocessed once the instance becomes Active. Wait for Active, then follow [Get Bot Token and Pairing](/ai-stack/agent-base/agent-runtime/openclaw/get-bot-token-and-pairing.md).
{% endhint %}

***

## 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&amp;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 %}