diff --git a/docs/install/ansible.md b/docs/install/ansible.md index d19383398d6..6da78ed45bf 100644 --- a/docs/install/ansible.md +++ b/docs/install/ansible.md @@ -25,12 +25,12 @@ curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/inst ## What You Get -- 🔒 **Firewall-first security**: UFW + Docker isolation (only SSH + Tailscale accessible) -- 🔐 **Tailscale VPN**: Secure remote access without exposing services publicly -- 🐳 **Docker**: Isolated sandbox containers, localhost-only bindings -- 🛡️ **Defense in depth**: 4-layer security architecture -- 🚀 **One-command setup**: Complete deployment in minutes -- 🔧 **Systemd integration**: Auto-start on boot with hardening +- **Firewall-first security**: UFW + Docker isolation (only SSH + Tailscale accessible) +- **Tailscale VPN**: Secure remote access without exposing services publicly +- **Docker**: Isolated sandbox containers, localhost-only bindings +- **Defense in depth**: 4-layer security architecture +- **One-command setup**: Complete deployment in minutes +- **Systemd integration**: Auto-start on boot with hardening ## Requirements @@ -166,7 +166,7 @@ sudo ls -la /opt/openclaw # Test manual start sudo -i -u openclaw cd ~/openclaw -pnpm start +openclaw gateway run ``` ### Docker sandbox issues diff --git a/docs/install/exe-dev.md b/docs/install/exe-dev.md index c49dab4e426..529f6286318 100644 --- a/docs/install/exe-dev.md +++ b/docs/install/exe-dev.md @@ -16,9 +16,9 @@ This page assumes exe.dev's default **exeuntu** image. If you picked a different 1. [https://exe.new/openclaw](https://exe.new/openclaw) 2. Fill in your auth key/token as needed -3. Click on "Agent" next to your VM, and wait... -4. ??? -5. Profit +3. Click on "Agent" next to your VM and wait for Shelley to finish provisioning +4. Open `https://.exe.xyz/` and paste your gateway token to authenticate +5. Approve any pending device pairing requests with `openclaw devices approve ` ## What you need diff --git a/docs/install/fly.md b/docs/install/fly.md index 3ed8df2884e..1c01c7f63fa 100644 --- a/docs/install/fly.md +++ b/docs/install/fly.md @@ -192,9 +192,7 @@ cat > /data/openclaw.json << 'EOF' "mode": "local", "bind": "auto" }, - "meta": { - "lastTouchedVersion": "2026.1.29" - } + "meta": {} } EOF ``` @@ -442,22 +440,22 @@ If you need webhook callbacks (Twilio, Telnyx, etc.) without public exposure: Example voice-call config with ngrok: -```json +```json5 { - "plugins": { - "entries": { + plugins: { + entries: { "voice-call": { - "enabled": true, - "config": { - "provider": "twilio", - "tunnel": { "provider": "ngrok" }, - "webhookSecurity": { - "allowedHosts": ["example.ngrok.app"] - } - } - } - } - } + enabled: true, + config: { + provider: "twilio", + tunnel: { provider: "ngrok" }, + webhookSecurity: { + allowedHosts: ["example.ngrok.app"], + }, + }, + }, + }, + }, } ``` @@ -488,3 +486,9 @@ With the recommended config (`shared-cpu-2x`, 2GB RAM): - Free tier includes some allowance See [Fly.io pricing](https://fly.io/docs/about/pricing/) for details. + +## Next steps + +- Set up messaging channels: [Channels](/channels) +- Configure the Gateway: [Gateway configuration](/gateway/configuration) +- Keep OpenClaw up to date: [Updating](/install/updating) diff --git a/docs/install/gcp.md b/docs/install/gcp.md index 7ff4a00d087..e997aed1cb1 100644 --- a/docs/install/gcp.md +++ b/docs/install/gcp.md @@ -276,9 +276,12 @@ services: "${OPENCLAW_GATEWAY_BIND}", "--port", "${OPENCLAW_GATEWAY_PORT}", + "--allow-unconfigured", ] ``` +`--allow-unconfigured` is only for bootstrap convenience, it is not a replacement for a proper gateway configuration. Still set auth (`gateway.auth.token` or password) and use safe bind settings for your deployment. + --- ## 10) Shared Docker VM runtime steps diff --git a/docs/install/hetzner.md b/docs/install/hetzner.md index 46bc76d6243..906ac7969a4 100644 --- a/docs/install/hetzner.md +++ b/docs/install/hetzner.md @@ -249,3 +249,9 @@ For teams preferring infrastructure-as-code workflows, a community-maintained Te This approach complements the Docker setup above with reproducible deployments, version-controlled infrastructure, and automated disaster recovery. > **Note:** Community-maintained. For issues or contributions, see the repository links above. + +## Next steps + +- Set up messaging channels: [Channels](/channels) +- Configure the Gateway: [Gateway configuration](/gateway/configuration) +- Keep OpenClaw up to date: [Updating](/install/updating) diff --git a/docs/install/macos-vm.md b/docs/install/macos-vm.md index 2bbd8e65051..2e4fd5184f1 100644 --- a/docs/install/macos-vm.md +++ b/docs/install/macos-vm.md @@ -155,17 +155,17 @@ nano ~/.openclaw/openclaw.json Add your channels: -```json +```json5 { - "channels": { - "whatsapp": { - "dmPolicy": "allowlist", - "allowFrom": ["+15551234567"] + channels: { + whatsapp: { + dmPolicy: "allowlist", + allowFrom: ["+15551234567"], }, - "telegram": { - "botToken": "YOUR_BOT_TOKEN" - } - } + telegram: { + botToken: "YOUR_BOT_TOKEN", + }, + }, } ``` @@ -209,15 +209,15 @@ Inside the VM: Add to your OpenClaw config: -```json +```json5 { - "channels": { - "bluebubbles": { - "serverUrl": "http://localhost:1234", - "password": "your-api-password", - "webhookPath": "/bluebubbles-webhook" - } - } + channels: { + bluebubbles: { + serverUrl: "http://localhost:1234", + password: "your-api-password", + webhookPath: "/bluebubbles-webhook", + }, + }, } ``` diff --git a/docs/install/node.md b/docs/install/node.md index 9cf2f59ec77..6e2f7062c42 100644 --- a/docs/install/node.md +++ b/docs/install/node.md @@ -9,7 +9,7 @@ read_when: # Node.js -OpenClaw requires **Node 22.16 or newer**. **Node 24 is the default and recommended runtime** for installs, CI, and release workflows. Node 22 remains supported via the active LTS line. The [installer script](/install#install-methods) will detect and install Node automatically — this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs). +OpenClaw requires **Node 22.16 or newer**. **Node 24 is the default and recommended runtime** for installs, CI, and release workflows. Node 22 remains supported via the active LTS line. The [installer script](/install#alternative-install-methods) will detect and install Node automatically — this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs). ## Check your version diff --git a/docs/install/northflank.mdx b/docs/install/northflank.mdx index 315c9ab5373..4c3467a26d0 100644 --- a/docs/install/northflank.mdx +++ b/docs/install/northflank.mdx @@ -42,3 +42,9 @@ instructions, see the channel docs: - [Telegram](/channels/telegram) (fastest — just a bot token) - [Discord](/channels/discord) - [All channels](/channels) + +## Next steps + +- Set up messaging channels: [Channels](/channels) +- Configure the Gateway: [Gateway configuration](/gateway/configuration) +- Keep OpenClaw up to date: [Updating](/install/updating) diff --git a/docs/install/railway.mdx b/docs/install/railway.mdx index a759b1de188..ec1fbd919e5 100644 --- a/docs/install/railway.mdx +++ b/docs/install/railway.mdx @@ -88,3 +88,9 @@ Download a backup at: - `https:///setup/export` This exports your OpenClaw state + workspace so you can migrate to another host without losing config or memory. + +## Next steps + +- Set up messaging channels: [Channels](/channels) +- Configure the Gateway: [Gateway configuration](/gateway/configuration) +- Keep OpenClaw up to date: [Updating](/install/updating) diff --git a/docs/install/render.mdx b/docs/install/render.mdx index e7a8b26346d..5d325d43ed7 100644 --- a/docs/install/render.mdx +++ b/docs/install/render.mdx @@ -157,3 +157,9 @@ Render expects a 200 response from `/health` within 30 seconds. If builds succee - Build logs for errors - Whether the container runs locally with `docker build && docker run` + +## Next steps + +- Set up messaging channels: [Channels](/channels) +- Configure the Gateway: [Gateway configuration](/gateway/configuration) +- Keep OpenClaw up to date: [Updating](/install/updating) diff --git a/docs/install/updating.md b/docs/install/updating.md index 0b88d91ed9e..ddae557c9f2 100644 --- a/docs/install/updating.md +++ b/docs/install/updating.md @@ -93,17 +93,17 @@ Note: on npm installs, the gateway logs an update hint on startup (checks the cu Auto-updater is **off by default** and is a core Gateway feature (not a plugin). -```json +```json5 { - "update": { - "channel": "stable", - "auto": { - "enabled": true, - "stableDelayHours": 6, - "stableJitterHours": 12, - "betaCheckIntervalHours": 1 - } - } + update: { + channel: "stable", + auto: { + enabled: true, + stableDelayHours: 6, + stableJitterHours: 12, + betaCheckIntervalHours: 1, + }, + }, } ```