docs(render): fix port env var, remove nonexistent setup wizard

This commit is contained in:
Jacob Tomlinson
2026-03-22 22:10:00 +00:00
parent e06b8d3e62
commit 6a228d9145
2 changed files with 13 additions and 25 deletions

View File

@@ -20,8 +20,7 @@ Deploy OpenClaw on Render using Infrastructure as Code. The included `render.yam
Clicking this link will: Clicking this link will:
1. Create a new Render service from the `render.yaml` Blueprint at the root of this repo. 1. Create a new Render service from the `render.yaml` Blueprint at the root of this repo.
2. Prompt you to set `SETUP_PASSWORD` 2. Build the Docker image and deploy
3. Build the Docker image and deploy
Once deployed, your service URL follows the pattern `https://<service-name>.onrender.com`. Once deployed, your service URL follows the pattern `https://<service-name>.onrender.com`.
@@ -38,10 +37,8 @@ services:
plan: starter plan: starter
healthCheckPath: /health healthCheckPath: /health
envVars: envVars:
- key: PORT - key: OPENCLAW_GATEWAY_PORT
value: "8080" value: "8080"
- key: SETUP_PASSWORD
sync: false # prompts during deploy
- key: OPENCLAW_STATE_DIR - key: OPENCLAW_STATE_DIR
value: /data/.openclaw value: /data/.openclaw
- key: OPENCLAW_WORKSPACE_DIR - key: OPENCLAW_WORKSPACE_DIR
@@ -60,7 +57,6 @@ Key Blueprint features used:
| --------------------- | ---------------------------------------------------------- | | --------------------- | ---------------------------------------------------------- |
| `runtime: docker` | Builds from the repo's Dockerfile | | `runtime: docker` | Builds from the repo's Dockerfile |
| `healthCheckPath` | Render monitors `/health` and restarts unhealthy instances | | `healthCheckPath` | Render monitors `/health` and restarts unhealthy instances |
| `sync: false` | Prompts for value during deploy (secrets) |
| `generateValue: true` | Auto-generates a cryptographically secure value | | `generateValue: true` | Auto-generates a cryptographically secure value |
| `disk` | Persistent storage that survives redeploys | | `disk` | Persistent storage that survives redeploys |
@@ -77,17 +73,11 @@ The Blueprint defaults to `starter`. To use free tier, change `plan: free` in yo
## After deployment ## After deployment
### Complete web setup
1. Navigate to `https://<your-service>.onrender.com/setup`
2. Enter your `SETUP_PASSWORD`
3. Select a model provider and paste your API key
4. Optionally configure messaging channels (Telegram, Discord, Slack)
5. Click **Run setup**
### Access the Control UI ### Access the Control UI
The web dashboard is available at `https://<your-service>.onrender.com/openclaw`. The web dashboard is available at `https://<your-service>.onrender.com/`.
Connect using the `OPENCLAW_GATEWAY_TOKEN` value that was auto-generated during deploy (find it in **Dashboard → your service → Environment**).
## Render Dashboard features ## Render Dashboard features
@@ -129,13 +119,13 @@ For OpenClaw, vertical scaling is usually sufficient. Horizontal scaling require
## Backups and migration ## Backups and migration
Export your configuration and workspace at any time: Export your configuration and workspace at any time using the shell access in the Render Dashboard:
``` ```bash
https://<your-service>.onrender.com/setup/export openclaw backup create
``` ```
This downloads a portable backup you can restore on any OpenClaw host. This creates a portable backup archive you can restore on any OpenClaw host. See [Backup](/cli/backup) for details.
## Troubleshooting ## Troubleshooting
@@ -143,8 +133,8 @@ This downloads a portable backup you can restore on any OpenClaw host.
Check the deploy logs in the Render Dashboard. Common issues: Check the deploy logs in the Render Dashboard. Common issues:
- Missing `SETUP_PASSWORD` — the Blueprint prompts for this, but verify it's set - Missing `OPENCLAW_GATEWAY_TOKEN` — verify it is set in **Dashboard → Environment**
- Port mismatch — ensure `PORT=8080` matches the Dockerfile's exposed port - Port mismatch — ensure `OPENCLAW_GATEWAY_PORT=8080` is set so the gateway binds to the port Render expects
### Slow cold starts (free tier) ### Slow cold starts (free tier)
@@ -153,7 +143,7 @@ Free tier services spin down after 15 minutes of inactivity. The first request a
### Data loss after redeploy ### Data loss after redeploy
This happens on free tier (no persistent disk). Upgrade to a paid plan, or This happens on free tier (no persistent disk). Upgrade to a paid plan, or
regularly export your config via `/setup/export`. regularly export your config via `openclaw backup create` in the Render shell.
### Health check failures ### Health check failures

View File

@@ -5,10 +5,8 @@ services:
plan: starter plan: starter
healthCheckPath: /health healthCheckPath: /health
envVars: envVars:
- key: PORT - key: OPENCLAW_GATEWAY_PORT
value: "8080" value: "8080"
- key: SETUP_PASSWORD
sync: false
- key: OPENCLAW_STATE_DIR - key: OPENCLAW_STATE_DIR
value: /data/.openclaw value: /data/.openclaw
- key: OPENCLAW_WORKSPACE_DIR - key: OPENCLAW_WORKSPACE_DIR