|
| 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 | +  |
| 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 | +  |
| 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 | + |
| 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 | + |
| 136 | +
|
| 137 | +Enter the Username as **openclaw** and the Password from the `/home/admin.credentials` file. |
| 138 | +
|
| 139 | +{{% content "marketplace-update-note-shortguide" %}} |
0 commit comments