# clawdbot-vps-setup

> Bootstrap and maintain a Clawdbot gateway VPS (Ubuntu 24.04) with standard dev tooling (nvm/Node 22.22.0, pnpm 10.23.0, git, python, uv, bun, homebrew optional) and verify gateway readiness. Use for new VPS setup, toolchain standardization, or auditing dev environment + permissions on Clawdbot hosts.

- Author: Ameno
- Repository: ameno-/clawdbot-vps
- Version: 20260124190602
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/ameno-/clawdbot-vps
- Web: https://mule.run/skillshub/@@ameno-/clawdbot-vps~clawdbot-vps-setup:20260124190602

---

---
name: clawdbot-vps-setup
description: Bootstrap and maintain a Clawdbot gateway VPS (Ubuntu 24.04) with standard dev tooling (nvm/Node 22.22.0, pnpm 10.23.0, git, python, uv, bun, homebrew optional) and verify gateway readiness. Use for new VPS setup, toolchain standardization, or auditing dev environment + permissions on Clawdbot hosts.
---

# Clawdbot VPS setup

## Overview

Provision a Clawdbot VPS for gateway + dev use. Standardize runtimes, install core tools, and verify the gateway can run under the `clawdbot` user.

## Workflow

### 1) Identify target + access

- Use SSH alias from `infra/ssh/hosts.json` (sync via `scripts/ssh-sync.sh`).
- Prefer `ssh hostinger-gateway` (clawdbot user). Use root only for OS packages or user creation.
- If you see Git "dubious ownership" errors, you are in the repo as root; switch to `clawdbot`.

### 2) Baseline OS + user

- Confirm `clawdbot` user exists and has a home directory.
- Root tasks only: apt update/upgrade + system packages.

### 3) Install dev tooling (standard)

Use the bootstrap script (idempotent):

```bash
sudo TARGET_USER=clawdbot \
  NODE_VERSION=22.22.0 \
  PNPM_VERSION=10.23.0 \
  INSTALL_BUN=1 \
  INSTALL_UV=1 \
  INSTALL_BREW=0 \
  INSTALL_OH_MY_ZSH=1 \
  INSTALL_TAILSCALE=1 \
  TAILSCALE_HOSTNAME=hostinger-gateway \
  ./skills/clawdbot-vps-setup/scripts/vps-bootstrap.sh
```

Notes:
- Bun is not recommended for the gateway runtime. Keep Node for gateway services.
- Homebrew is optional on Ubuntu (Linuxbrew) and can be skipped.
- Tailscale requires `tailscale up` (interactive) or `TAILSCALE_AUTHKEY=...`.
- To start the gateway after install, set `START_GATEWAY=1` once the user service exists.

### 4) Verify toolchain

```bash
ssh hostinger-root 'sudo -iu clawdbot /tmp/vps-verify.sh'
```

Expect:
- node v22.22.0
- pnpm 10.23.0
- python3 present
- tailscale installed
- uv/bun optional

### 5) Gateway readiness

- Ensure clawdbot repo exists at `/home/clawdbot/dev/clawdbot`.
- Build under `clawdbot`:
  ```bash
  sudo -u clawdbot bash -lc 'cd /home/clawdbot/dev/clawdbot && pnpm install && pnpm build'
  ```
- Install helper scripts (no secrets):
  ```bash
  sudo -u clawdbot mkdir -p /home/clawdbot/bin
  sudo cp scripts/gateway-*.sh /home/clawdbot/bin/
  sudo chown clawdbot:clawdbot /home/clawdbot/bin/gateway-*.sh
  sudo chmod 755 /home/clawdbot/bin/gateway-*.sh
  ```
- Manage service with systemd user units. See references below.

### 6) Permissions + keys

- Hostinger UI installs keys for `root` only. Ensure the `clawdbot` key is in:
  `/home/clawdbot/.ssh/authorized_keys`.
- Keep secrets in 1Password. Do not write tokens to repo.

## Manifest (source of truth)

- Versions + paths: `manifest.yaml`
- Update process: `references/manifest.md`

## References

- Clawdbot setup docs: `references/clawdbot-guides.md`
- Dev tools matrix: `references/devtools.md`
- Permissions + requirements: `references/permissions.md`
- Cloud ops workflow: `references/cloud-ops-workflow.md`

## Resources

### scripts/

- `scripts/vps-bootstrap.sh` — install OS packages + nvm/Node/pnpm + optional bun/uv/brew/oh-my-zsh
- `scripts/vps-verify.sh` — verify toolchain + optional CLIs
- `scripts/gateway-update.sh` — update repo + deps + restart service (no wipe)
- `scripts/gateway-status.sh` — short systemd status
- `scripts/gateway-logs.sh` — tail last 200 log lines

### references/

- `references/clawdbot-guides.md`
- `references/devtools.md`