> 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 . From the main dashboard, navigate to **AI Stack** and select **Agentbase** → **Agent Marketplace**.
* **Option 2**: Go directly to .
### 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
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 | 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.
#### Step 3: Deploy Success
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.
### 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 %}