GoClaw on Render

Multi-tenant AI agent gateway: official GoClaw image, Postgres 18 with pgvector, persistent agent workspaces.

Deploy GoClaw on Render without building the Go + Node monorepo. This template uses the official ghcr.io/nextlevelbuilder/goclaw image, wires Postgres and a 10 GB disk, and generates auth secrets for you.

At a glance: ~$33–35/mo (Oregon) · first deploy ~5–10 min · Standard web plan required · no LLM keys at Apply time

---

Deploy

1. Click Deploy to Render and fork into your GitHub account.
2. On Apply, confirm goclaw, goclaw-db, and the disk. Leave provider keys empty.
3. Wait for Live (~5–10 min).
4. Copy GOCLAW_GATEWAY_TOKEN from the Render Dashboard → Environment → sign in to the UI.
5. Add one LLM provider key in Settings → Providers (or set GOCLAW_ANTHROPIC_API_KEY in Render and redeploy).

curl -sS https://<your-service>.onrender.com/health
# {"status":"ok","protocol":3}

Docs: docs.goclaw.sh

---

What's included

flowchart LR
  user["Browser / channels"] --> web["goclaw"]
  web --> db[("Postgres 18")]
  web --> disk[/"10 GB disk"/]
  web -.-> llm["LLM APIs"]

Loading

Resource	Plan	Role
goclaw	Standard	Image ghcr.io/nextlevelbuilder/goclaw:v3.12.0, port 10000
goclaw-db	Basic 256MB	Postgres 18, pgvector, migrations on boot
goclaw-data	10 GB disk	Config, skills, workspaces at /app/data

Default region: oregon (change in render.yaml). Image pin: v3.12.0.

Use it for: team agent gateway · multi-channel bots · Knowledge Vault / RAG · agent orchestration

---

Environment variables

At Apply: no secrets required.

Auto-generated (do not rotate casually):

Variable	Purpose
GOCLAW_GATEWAY_TOKEN	Dashboard / API login
GOCLAW_ENCRYPTION_KEY	Encrypts stored provider keys in Postgres

Wired for you: GOCLAW_POSTGRES_DSN from goclaw-db.

Blueprint defaults and optional overrides

Set in render.yaml:

Variable	Value
GOCLAW_HOST	0.0.0.0
GOCLAW_PORT	10000 (GoClaw uses this, not Render's PORT)
GOCLAW_CONFIG	/app/data/config.json
GOCLAW_DATA_DIR	/app/data
GOCLAW_WORKSPACE	/app/data/workspace
GOCLAW_SKILLS_DIR	/app/data/skills

Optional after deploy: GOCLAW_ANTHROPIC_API_KEY, GOCLAW_OPENAI_API_KEY, GOCLAW_OPENROUTER_API_KEY, and others listed in .env.example.

---

Cost

Resource	~USD/mo
goclaw (Standard)	25
goclaw-db	6
10 GB disk	2.50
Total	~33–35

LLM usage is separate. Starter plan and free Postgres are not supported for this stack.

---

Customize

• New GoClaw version: change image.url in render.yaml, push, Sync Blueprint.
• Custom domain: add on the goclaw service in the Dashboard (TLS automatic).
• Redis: add Key Value + GOCLAW_REDIS_DSN + Redis-enabled image (not in default template).
• Patches before upstream release: switch to runtime: docker and your own Dockerfile.

Ops: Postgres and disk have Render backups/snapshots. Logs: Dashboard → goclaw → Logs, or render logs -r <id> --tail. Disk = single instance only; scale up (Standard → Pro) if you OOM.

---

Troubleshooting

Problem	Fix
Exit 127 / GOCLAW_PORT shell error	Do not use dockerCommand. Keep GOCLAW_PORT=10000 in env (already in template).
No open ports / health check fails	Use Standard+. Set GOCLAW_HOST=0.0.0.0, GOCLAW_PORT=10000.
Anthropic 400 on Claude 4.6+	Pin an older model (e.g. Sonnet 4.5) or use a newer image tag / custom Docker build.
DB errors on first deploy	Wait until goclaw-db is Available, then redeploy goclaw.

More issues: GitHub issues · upstream GoClaw

---

FAQ

LLM keys at deploy? No. Add one after sign-in.

Fork manually? No. One-click creates your fork.

Free tier? No. Needs paid Postgres, Standard web, and a disk.

Sandbox / browser automation? Not on Render without extra services you add yourself.

---

Limits

• Standard plan minimum (Starter OOMs at startup)
• One instance (disk attached; no autoscaling or zero-downtime deploys)
• No Docker sandbox, Tailscale, or bundled browser sidecar in this template
• Same region for web, DB, and disk

---

Security & license

TLS at Render's edge. Protect GOCLAW_GATEWAY_TOKEN. Provider keys encrypted with GOCLAW_ENCRYPTION_KEY. Report upstream vulns to nextlevelbuilder/goclaw.

• GoClaw: CC BY-NC 4.0
• This template: MIT · render-examples/goclaw-render-template