10d5ea5de6
* docs: Add Oracle Cloud (OCI) platform guide - Add comprehensive guide for Oracle Cloud Always Free tier (ARM) - Cover VCN security, Tailscale Serve setup, and why traditional hardening is unnecessary - Update vps.md to list Oracle as top provider option - Update digitalocean.md to link to official Oracle guide instead of community gist Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * Keep community gist link, remove unzip * Fix step order: lock down VCN after Tailscale is running * Move VCN lockdown to final step (after verifying everything works) * docs: make Oracle/Tailscale guide safer + tone down DO copy * docs: fix Oracle guide step numbering * docs: tone down VPS hub Oracle blurb * docs: add Oracle Cloud guide (#2333) (thanks @hirefrank) --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> Co-authored-by: Pocket Clawd <pocket@Pockets-Mac-mini.local>
244 lines
5.7 KiB
Markdown
244 lines
5.7 KiB
Markdown
---
|
||
summary: "Clawdbot on DigitalOcean (simple paid VPS option)"
|
||
read_when:
|
||
- Setting up Clawdbot on DigitalOcean
|
||
- Looking for cheap VPS hosting for Clawdbot
|
||
---
|
||
|
||
# Clawdbot on DigitalOcean
|
||
|
||
## Goal
|
||
|
||
Run a persistent Clawdbot Gateway on DigitalOcean for **$6/month** (or $4/mo with reserved pricing).
|
||
|
||
If you want a $0/month option and don’t mind ARM + provider-specific setup, see the [Oracle Cloud guide](/platforms/oracle).
|
||
|
||
## Cost Comparison (2026)
|
||
|
||
| Provider | Plan | Specs | Price/mo | Notes |
|
||
|----------|------|-------|----------|-------|
|
||
| Oracle Cloud | Always Free ARM | up to 4 OCPU, 24GB RAM | $0 | ARM, limited capacity / signup quirks |
|
||
| Hetzner | CX22 | 2 vCPU, 4GB RAM | €3.79 (~$4) | Cheapest paid option |
|
||
| DigitalOcean | Basic | 1 vCPU, 1GB RAM | $6 | Easy UI, good docs |
|
||
| Vultr | Cloud Compute | 1 vCPU, 1GB RAM | $6 | Many locations |
|
||
| Linode | Nanode | 1 vCPU, 1GB RAM | $5 | Now part of Akamai |
|
||
|
||
**Picking a provider:**
|
||
- DigitalOcean: simplest UX + predictable setup (this guide)
|
||
- Hetzner: good price/perf (see [Hetzner guide](/platforms/hetzner))
|
||
- Oracle Cloud: can be $0/month, but is more finicky and ARM-only (see [Oracle guide](/platforms/oracle))
|
||
|
||
---
|
||
|
||
## Prerequisites
|
||
|
||
- DigitalOcean account ([signup with $200 free credit](https://m.do.co/c/signup))
|
||
- SSH key pair (or willingness to use password auth)
|
||
- ~20 minutes
|
||
|
||
## 1) Create a Droplet
|
||
|
||
1. Log into [DigitalOcean](https://cloud.digitalocean.com/)
|
||
2. Click **Create → Droplets**
|
||
3. Choose:
|
||
- **Region:** Closest to you (or your users)
|
||
- **Image:** Ubuntu 24.04 LTS
|
||
- **Size:** Basic → Regular → **$6/mo** (1 vCPU, 1GB RAM, 25GB SSD)
|
||
- **Authentication:** SSH key (recommended) or password
|
||
4. Click **Create Droplet**
|
||
5. Note the IP address
|
||
|
||
## 2) Connect via SSH
|
||
|
||
```bash
|
||
ssh root@YOUR_DROPLET_IP
|
||
```
|
||
|
||
## 3) Install Clawdbot
|
||
|
||
```bash
|
||
# Update system
|
||
apt update && apt upgrade -y
|
||
|
||
# Install Node.js 22
|
||
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
|
||
apt install -y nodejs
|
||
|
||
# Install Clawdbot
|
||
curl -fsSL https://clawd.bot/install.sh | bash
|
||
|
||
# Verify
|
||
clawdbot --version
|
||
```
|
||
|
||
## 4) Run Onboarding
|
||
|
||
```bash
|
||
clawdbot onboard --install-daemon
|
||
```
|
||
|
||
The wizard will walk you through:
|
||
- Model auth (API keys or OAuth)
|
||
- Channel setup (Telegram, WhatsApp, Discord, etc.)
|
||
- Gateway token (auto-generated)
|
||
- Daemon installation (systemd)
|
||
|
||
## 5) Verify the Gateway
|
||
|
||
```bash
|
||
# Check status
|
||
clawdbot status
|
||
|
||
# Check service
|
||
systemctl --user status clawdbot-gateway.service
|
||
|
||
# View logs
|
||
journalctl --user -u clawdbot-gateway.service -f
|
||
```
|
||
|
||
## 6) Access the Dashboard
|
||
|
||
The gateway binds to loopback by default. To access the Control UI:
|
||
|
||
**Option A: SSH Tunnel (recommended)**
|
||
```bash
|
||
# From your local machine
|
||
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
|
||
|
||
# Then open: http://localhost:18789
|
||
```
|
||
|
||
**Option B: Tailscale Serve (HTTPS, loopback-only)**
|
||
```bash
|
||
# On the droplet
|
||
curl -fsSL https://tailscale.com/install.sh | sh
|
||
tailscale up
|
||
|
||
# Configure Gateway to use Tailscale Serve
|
||
clawdbot config set gateway.tailscale.mode serve
|
||
clawdbot gateway restart
|
||
```
|
||
|
||
Open: `https://<magicdns>/`
|
||
|
||
Notes:
|
||
- Serve keeps the Gateway loopback-only and authenticates via Tailscale identity headers.
|
||
- To require token/password instead, set `gateway.auth.allowTailscale: false` or use `gateway.auth.mode: "password"`.
|
||
|
||
**Option C: Tailnet bind (no Serve)**
|
||
```bash
|
||
clawdbot config set gateway.bind tailnet
|
||
clawdbot gateway restart
|
||
```
|
||
|
||
Open: `http://<tailscale-ip>:18789` (token required).
|
||
|
||
## 7) Connect Your Channels
|
||
|
||
### Telegram
|
||
```bash
|
||
clawdbot pairing list telegram
|
||
clawdbot pairing approve telegram <CODE>
|
||
```
|
||
|
||
### WhatsApp
|
||
```bash
|
||
clawdbot channels login whatsapp
|
||
# Scan QR code
|
||
```
|
||
|
||
See [Channels](/channels) for other providers.
|
||
|
||
---
|
||
|
||
## Optimizations for 1GB RAM
|
||
|
||
The $6 droplet only has 1GB RAM. To keep things running smoothly:
|
||
|
||
### Add swap (recommended)
|
||
```bash
|
||
fallocate -l 2G /swapfile
|
||
chmod 600 /swapfile
|
||
mkswap /swapfile
|
||
swapon /swapfile
|
||
echo '/swapfile none swap sw 0 0' >> /etc/fstab
|
||
```
|
||
|
||
### Use a lighter model
|
||
If you're hitting OOMs, consider:
|
||
- Using API-based models (Claude, GPT) instead of local models
|
||
- Setting `agents.defaults.model.primary` to a smaller model
|
||
|
||
### Monitor memory
|
||
```bash
|
||
free -h
|
||
htop
|
||
```
|
||
|
||
---
|
||
|
||
## Persistence
|
||
|
||
All state lives in:
|
||
- `~/.clawdbot/` — config, credentials, session data
|
||
- `~/clawd/` — workspace (SOUL.md, memory, etc.)
|
||
|
||
These survive reboots. Back them up periodically:
|
||
```bash
|
||
tar -czvf clawdbot-backup.tar.gz ~/.clawdbot ~/clawd
|
||
```
|
||
|
||
---
|
||
|
||
## Oracle Cloud Free Alternative
|
||
|
||
Oracle Cloud offers **Always Free** ARM instances that are significantly more powerful than any paid option here — for $0/month.
|
||
|
||
| What you get | Specs |
|
||
|--------------|-------|
|
||
| **4 OCPUs** | ARM Ampere A1 |
|
||
| **24GB RAM** | More than enough |
|
||
| **200GB storage** | Block volume |
|
||
| **Forever free** | No credit card charges |
|
||
|
||
**Caveats:**
|
||
- Signup can be finicky (retry if it fails)
|
||
- ARM architecture — most things work, but some binaries need ARM builds
|
||
|
||
For the full setup guide, see [Oracle Cloud](/platforms/oracle). For signup tips and troubleshooting the enrollment process, see this [community guide](https://gist.github.com/rssnyder/51e3cfedd730e7dd5f4a816143b25dbd).
|
||
|
||
---
|
||
|
||
## Troubleshooting
|
||
|
||
### Gateway won't start
|
||
```bash
|
||
clawdbot gateway status
|
||
clawdbot doctor --non-interactive
|
||
journalctl -u clawdbot --no-pager -n 50
|
||
```
|
||
|
||
### Port already in use
|
||
```bash
|
||
lsof -i :18789
|
||
kill <PID>
|
||
```
|
||
|
||
### Out of memory
|
||
```bash
|
||
# Check memory
|
||
free -h
|
||
|
||
# Add more swap
|
||
# Or upgrade to $12/mo droplet (2GB RAM)
|
||
```
|
||
|
||
---
|
||
|
||
## See Also
|
||
|
||
- [Hetzner guide](/platforms/hetzner) — cheaper, more powerful
|
||
- [Docker install](/install/docker) — containerized setup
|
||
- [Tailscale](/gateway/tailscale) — secure remote access
|
||
- [Configuration](/gateway/configuration) — full config reference
|