OpenClaw

Deploy OpenClaw, an open source AI agent platform that runs locally and executes tasks through a persistent gateway service connecting communication channels, tools, and AI models.

You can configure and manage the system using a CLI onboarding wizard and a local web dashboard. This app allows you to connect to the OpenClaw dashboard via a secure HTTPS endpoint protected by HTPASSWD and creates a limited user on the system named openclaw.

1. Deploy OpenClaw

 Estimated deployment time: 5–10 minutes

Base distribution and plan

• Supported distribution: Ubuntu 24.04 LTS
• Recommended plans: All plan types and sizes can be used.

Configuration options

StackScript ID: 2049320

Notes:

• After the app deployment completes, the password for your limited sudo user is generated and stored in the .credentials file in the home directory, along with application-specific passwords. Log in to your instance as root through the Lish console or SSH, then run cat /home/$USERNAME/.credentials to view its contents.
• You can automatically configure a custom domain (optional) during deployment. To do that:
  1. First, configure your domain to use Linode’s name servers via your registrar. See Configure your domain's authoritative name servers for details.
  2. Once you complete that, specify the Linode API token, subdomain, and domain for the app in Cloud Manager or via API/CLI/Terraform.

Use API, CLI, or Terraform

curl --location 'https://api.linode.com/v4/linode/instances' \
    --header 'Content-Type: application/json' \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer abc123def456hij789klm' \
    --data-raw '{
        "region": "us-east",
        "type": "g6-standard-2",
        "image": "linode/ubuntu24.04",
        "label": "my-openclaw-one-click-app",
        "root_pass": "@C0mpl3x#P@ssw0rd",
        "stackscript_id": 2049320,
        "stackscript_data": {
            "user_name":"jsmith",
            "soa_email_address":"jsmith@example.com"
        }
    }'

linode-cli linodes create \
    --region us-east \
    --type g6-standard-2 \
    --label my-openclaw-one-click-app \
    --image linode/ubuntu24.04 \
    --root_pass @C0mpl3x#P@ssw0rd \
    --stackscript_id 2049320 \
    --stackscript_data '{"user_name":"jsmith", "soa_email_address":"jsmith@example.com"}'

resource "linode_instance" "my-linode" {
    region         = "us-east"
    type           = "g6-standard-2"
    label          = "my-openclaw-one-click-app"
    image          = "linode/ubuntu24.04"
    root_pass      = "@C0mpl3x#P@ssw0rd"
    stackscript_id = 2049320
    stackscript_data = {
        "user_name"         = "jsmith"
        "soa_email_address" = "jsmith@example.com"
    }
}

2. Access OpenClaw

Onboard OpenClaw

Once the deployment is complete, openclaw is installed on the instance but is not running yet. Before you can start using OpenClaw, you need to go through the onboarding wizard. This app triggers onboarding for you when you log in as root.

1. Log in to your instance.

   If you disabled root login to the server during the setup of the OpenClaw app, log in as a sudo user.

   Bash

   ssh admin@YOUR_INSTANCE_IP

   Replace YOUR_INSTANCE_IP with the IP address of your Linode instance and admin with the sudo user you created.

2. Escalate privileges to root. Once you’ve logged in, the motd (message of the day) appears.

   Bash

   *********************************************************
   Akamai Connected Cloud OpenClaw Quick Deploy App
   Dashboard URL: https://172-235-150-14.ip.linodeusercontent.com
   Credentials File: /home/admin/.credentials
   Documentation: https://techdocs.akamai.com/quick-deploy-apps/docs/openclaw
   *********************************************************

3. Copy the sudo password from the ~/.credentials file and enter the sudo su - command in the terminal.

4. When prompted for the password, paste the sudo password you copied from the ~/.credentials file. When you log in as root, the onboarding wizard message appears.

5. If you're ready to perform the onboarding, enter y. It takes you to OpenClaw’s onboarding wizard where you can complete the configuration.

   Once the setup is complete, the onboarding script is removed.

Confirm the gateway status

At this point, you’ve configured OpenClaw on the server. To verify the gateway is running, you need to become the openclaw user.

1. Run the su - openclaw command in the terminal as the root user.
2. To view the gateway status, run the openclaw gateway status command as the openclaw user. The output should display the running state, along with other gateway details.

Access the dashboard

Once onboarding is complete and the gateway is running, you can access the dashboard using one of these methods:

• Access the dashboard from the domain you’ve configured in the initial app deployment.
• If you didn't configure your domain, assess the dashboard using your instance’s rDNS value. For example, 172-233-177-79.ip.linodeusercontent.com. You can view the rDNS value from the Linode’s Network tab.

To authenticate to the dashboard, you need to provide two authentication methods:

1. Dashboard token: If you didn’t get a dashboard token during the onboarding steps, follow these steps:
   1. Become the openclaw user by running su - openclaw.
   2. Run the openclaw dashboard --no-open command.
   3. Get the entire token value, for example, #token=a12bc34def56ghi7j, from the Dashboard URL field.
2. Nginx basic auth: Get the Htpasswd username and password from the .credentials file.
3. Once you're set, you can access the dashboard. For example, using https://172-233-177-79.ip.linodeusercontent.com/#token=a12bc34def56ghi7j.
4. When you access the web page, you're prompted for the HTPASSWD details, including the openclaw username and password from the .credentials file.

Additional resources

For more information about the installed packages, see their official documentation.

• OpenClaw Documentation