Skip to content

Commit f1a3e8e

Browse files
n0vabytejddocs
andauthored
[Add] OpenClaw App Quick Deploy Docs (#7416)
* feat: add openclaw quick deploy doc. * typo fix * copy edit --------- Co-authored-by: jddocs <jdutton@akamai.com>
1 parent e96db71 commit f1a3e8e

8 files changed

Lines changed: 146 additions & 7 deletions

File tree

docs/marketplace-docs/guides/gemma3/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Before deployment, you need a Hugging Face API token to access the Gemma 3 model
4949
1. Create a free account at [huggingface.co/join](https://huggingface.co/join).
5050
1. Accept the Gemma license at [huggingface.co/google/gemma-3-12b-it](https://huggingface.co/google/gemma-3-12b-it).
5151
1. Generate a token at [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens). Read-only access is sufficient.
52-
1. Provide this token during the Marketplace deployment process.
52+
1. Provide this token during the deployment process.
5353

5454
{{% content "marketplace-required-limited-user-fields-shortguide" %}}
5555

docs/marketplace-docs/guides/gpt-oss-with-openwebui/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Deploy GPT-OSS with Open WebUI through the Linode Marketplace"
2+
title: "Deploy GPT-OSS with Open WebUI"
33
description: "This guide includes instructions on how to deploy Open WebUI with GPT-OSS self-hosted LLM on an Akamai Compute Instance."
44
published: 2026-02-12
55
modified: 2026-02-12
@@ -19,9 +19,9 @@ marketplace_app_name: "GPT-OSS with Open WebUI"
1919

2020
Open WebUI is an open-source, self-hosted web interface for interacting with and managing Large Language Models (LLMs). It supports multiple AI backends, multi-user access, and extensible integrations, enabling secure and customizable deployment for local or remote model inference.
2121

22-
The Marketplace application deployed in this guide uses OpenAI GPT-OSS, a family of open-weight large language models designed for powerful reasoning, agentic tasks, and versatile developer use cases. During deployment, you can choose between two model sizes: GPT-OSS 20B (default) or GPT-OSS 120B. These models are released under the permissive Apache 2.0 license and integrate well with self-hosted platforms like Open WebUI for general-purpose assistance, coding, and knowledge-based workflows.
22+
The Quick Deploy App deployed in this guide uses OpenAI GPT-OSS, a family of open-weight large language models designed for powerful reasoning, agentic tasks, and versatile developer use cases. During deployment, you can choose between two model sizes: GPT-OSS 20B (default) or GPT-OSS 120B. These models are released under the permissive Apache 2.0 license and integrate well with self-hosted platforms like Open WebUI for general-purpose assistance, coding, and knowledge-based workflows.
2323

24-
## Deploying a Marketplace App
24+
## Deploying a Quick Deploy App
2525

2626
{{% content "deploy-marketplace-apps-shortguide" %}}
2727

@@ -37,7 +37,7 @@ Open WebUI with GPT-OSS should be fully installed within 5-10 minutes after the
3737
- **Recommended plan for GPT-OSS 120B:** RTX4000 Ada x1 Large or higher (64GB RAM minimum)
3838

3939
{{< note type="warning" >}}
40-
This Marketplace App only works with Akamai GPU instances. If you choose a plan other than GPUs, the provisioning will fail, and a notice will appear in the LISH console.
40+
This Quick Deploy App only works with Akamai GPU instances. If you choose a plan other than GPUs, the provisioning will fail, and a notice will appear in the LISH console.
4141
{{< /note >}}
4242

4343
### GPT-OSS Options
Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
---
2+
title: "Deploy OpenClaw"
3+
description: "This tutorial will show you how deploy OpenClaw as a Quick Deploy App."
4+
published: 2026-03-17
5+
modified: 2026-03-17
6+
keywords: ['AI', 'AI Agent']
7+
tags: ["quick deploy apps", "AI", "AI Agent"]
8+
aliases: ['/products/tools/marketplace/guides/openclaw/','/guides/openclaw/']
9+
external_resources:
10+
- '[OpenClaw](https://openclaw.ai/)'
11+
- '[OpenClaw Documentation](https://docs.openclaw.ai/)'
12+
authors: ["Akamai"]
13+
contributors: ["Akamai"]
14+
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
15+
marketplace_app_id: 2049320
16+
marketplace_app_name: "OpenClaw"
17+
---
18+
19+
[OpenClaw](https://openclaw.ai/) is an open-source AI agent platform that runs locally and executes tasks through a persistent Gateway service. The Gateway connects communication channels, tools, and AI models, allowing the agent to receive messages, perform actions, and automate workflows. Administrators configure and manage the system through a CLI onboarding wizard and a local web dashboard. Our Quick Deploy App allows you to connect to the OpenClaw dashboard via a secure HTTPS endpoint protected by HTPASSWD.
20+
21+
This Quick Deploy App creates an OpenClaw limited user on the system called `openclaw`.
22+
23+
## Deploying a Quick Deploy App
24+
25+
{{% content "deploy-marketplace-apps-shortguide" %}}
26+
27+
{{% content "marketplace-verify-standard-shortguide" %}}
28+
29+
{{< note >}}
30+
**Estimated deployment time:** OpenClaw should be fully installed within 5-10 minutes after the Compute Instance has finished provisioning.
31+
{{< /note >}}
32+
33+
## Configuration Options
34+
35+
- **Supported distributions:** Ubuntu 24.04 LTS
36+
- **Recommended plan:** All plan types and sizes can be used.
37+
38+
## OpenClaw Options
39+
40+
- **Email address** *(required)*: Enter the email address you want to use for generating the SSL certificates via Let's Encrypt.
41+
42+
{{% content "marketplace-required-limited-user-fields-shortguide" %}}
43+
44+
{{% content "marketplace-custom-domain-fields-shortguide" %}}
45+
46+
{{% content "marketplace-special-character-limitations-shortguide" %}}
47+
48+
## Getting Started after Deployment
49+
50+
### Performing OpenClaw Onboard
51+
52+
Once the deployment is complete, `openclaw` will be installed on the instance but will not be running. Before you can start using OpenClaw, you need to go through the onboarding wizard. This Quick Deploy App triggers the onboarding for you when you log in as root.
53+
54+
1. Log into the instance.
55+
56+
If you disabled root login to the server during the setup of the OpenClaw app, you need to log into the server as the sudo user.
57+
58+
```command
59+
ssh admin@YOUR_INSTANCE_IP
60+
```
61+
62+
Replace `YOUR_INSTANCE_IP` with the IP address of your Linode instance and `admin` with the sudo user you created.
63+
64+
1. Escalate privileges to root.
65+
66+
Once you've logged in, note the [motd](https://man7.org/linux/man-pages/man5/motd.5.html):
67+
68+
```output
69+
*********************************************************
70+
Akamai Connected Cloud OpenClaw Quick Deploy App
71+
Dashboard URL: https://172-235-150-14.ip.linodeusercontent.com
72+
Credentials File: /home/admin/.credentials
73+
Documentation: https://www.linode.com/docs/marketplace-docs/guides/openclaw/
74+
*********************************************************
75+
```
76+
77+
Copy the sudo password from `~/.credentials.txt` and enter the following command from the terminal:
78+
79+
```command
80+
sudo su -
81+
```
82+
83+
When prompted for the password, paste the sudo password you got from the `~/.credentials.txt` file. When you log in as **root**, note the following message about the onboarding wizard:
84+
85+
![OpenClaw Init](openclaw-init.jpg)
86+
87+
If you are ready to perform the onboarding, enter `y` and it will take you to OpenClaw's onboarding wizard where you can complete the setup.
88+
89+
![OpenClaw Onboard](openclaw-onboard.jpg)
90+
91+
Once onboarding is complete, the onboarding script is removed.
92+
93+
### Confirm Gateway Status
94+
95+
At this time, you've configured OpenClaw on the server. To verify the gateway is running, you need to become the `openclaw` user. Enter the following from the terminal as the **root** user:
96+
97+
```command
98+
su - openclaw
99+
```
100+
101+
To view the gateway status, enter the following as the **openclaw** user:
102+
103+
```command
104+
openclaw gateway status
105+
```
106+
107+
That should yield the following output:
108+
109+
![OpenClaw GW Status](openclaw-gws.jpg)
110+
111+
### Dashboard Access
112+
113+
Once the onboarding is complete and the gateway is running, you can access the Dashboard from the domain you've configured in the initial deployment of the app. If you did not enter a domain name in from the start, the dashboard is accessible using the instance's rDNS value. You can view the rDNS value from the [Linode's Network](https://techdocs.akamai.com/cloud-computing/docs/configure-rdns-reverse-dns-on-a-compute-instance#setting-reverse-dns) tab. This example uses the domain `172-233-177-79.ip.linodeusercontent.com`.
114+
115+
To authenticate to the dashboard you need to provide two methods of authentication:
116+
117+
1. **Dashboard token**: If you didn't get a dashboard token during the onboarding steps, follow these steps.
118+
119+
1. Become the `openclaw` user:
120+
`su - openclaw`.
121+
122+
1. Run the following:
123+
`openclaw dashboard --no-open`
124+
125+
1. Get the entire token value `#token=a0764fb` from the `Dashboard URL:` link.
126+
127+
1. **Nginx basic auth**: Get the `Htpassword` password and `Htpasswd username` user from `/home/admin.credentials`.
128+
129+
Now you have everything you need to access the dashboard. For example:
130+
131+
`https://172-233-177-79.ip.linodeusercontent.com/#token=a0764fb`
132+
133+
When you access the web page, you will be prompted for the HTPASSWD details.
134+
135+
![Nginx Basic Auth](openclaw-htpasswd.jpg)
136+
137+
Enter the Username as **openclaw** and the Password from the `/home/admin.credentials` file.
138+
139+
{{% content "marketplace-update-note-shortguide" %}}
157 KB
Loading
21.2 KB
Loading
112 KB
Loading
203 KB
Loading

docs/marketplace-docs/guides/qwen/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ marketplace_app_name: "Qwen Instruct with Open WebUI"
1818

1919
Open WebUI is an open-source, self-hosted web interface for interacting with and managing Large Language Models (LLMs). It supports multiple AI backends, multi-user access, and extensible integrations, enabling secure and customizable deployment for local or remote model inference.
2020

21-
The Marketplace application deployed in this guide uses a Qwen Instruct model as an instruction-tuned, open-weight LLM optimized for reasoning, code generation, and conversational tasks. Qwen models are designed for high-quality inference across a wide range of general-purpose and technical workloads and integrate seamlessly with self-hosted platforms like Open WebUI.
21+
The Quick Deploy App deployed in this guide uses a Qwen Instruct model as an instruction-tuned, open-weight LLM optimized for reasoning, code generation, and conversational tasks. Qwen models are designed for high-quality inference across a wide range of general-purpose and technical workloads and integrate seamlessly with self-hosted platforms like Open WebUI.
2222

2323
## Deploying a Quick Deploy App
2424

@@ -35,7 +35,7 @@ Open WebUI with Qwen Instruct should be fully installed within 5-10 minutes afte
3535
- **Recommended plan:** RTX4000 Ada x1 Small or Larger GPU Instance
3636

3737
{{< note type="warning" >}}
38-
This Marketplace App only works with Akamai GPU instances. If you choose a plan other than GPUs, the provisioning will fail, and a notice will appear in the LISH console.
38+
This Quick Deploy App only works with Akamai GPU instances. If you choose a plan other than GPUs, the provisioning will fail, and a notice will appear in the LISH console.
3939
{{< /note >}}
4040

4141
### Open WebUI Options

0 commit comments

Comments
 (0)