Dari Maret sampai Juni 2026, saya punya OpenClaw di Docker yang bisa update dirinya sendiri. Servernya VPS Hetzner paling murah di Helsinki. Assistant-nya, yang saya beri nama Miki, mengubah repo miliknya lalu push ke main, dan GitHub Actions yang mengurus sisanya: build image baru, push ke GHCR, lalu deploy ulang ke VPS lewat SSH. Selama itu Miki tidak pernah diberi akses ke Docker socket.
Hasilnya, 50 dari 57 run di Actions berhasil. Dua build gagal di bulan April, sehingga dua kenaikan versi OpenClaw tidak pernah sampai ke VPS dan bot tetap jalan seperti biasa. Rollback otomatis berbasis healthcheck yang ditambahkan bulan Oktober tidak pernah jalan di server sungguhan. Akhirnya VPS-nya saya hapus, karena biaya server dan OpenRouter tidak sebanding dengan seberapa jarang saya memakainya.
Gambaran setup-nya
- Repo
miki-docker-configberisiDockerfile,docker-compose.yml, config dasarconfig/openclaw.json, skill, dan satu workflow. - Setiap ada push ke
main, Actions build image lalu push dua tag ke GHCR:latestdan 7 karakter pertama SHA commit. - Job kedua masuk ke VPS lewat SSH, pull image dengan tag SHA itu, menulisnya ke
.env, lalu restart container gateway. - VPS-nya Hetzner CX22 (2 vCPU, 4 GB, Ubuntu 24.04, sekitar €4 per bulan). Dari luar cuma port 22 yang terbuka, dan dashboard dibuka lewat SSH tunnel.
Kenapa build-nya di GitHub Actions
Awalnya, selama beberapa hari, image di-build langsung di VPS lewat compose. Saya tidak mau server sekecil itu dipakai untuk hal lain selain menjalankan OpenClaw, jadi build-nya saya pindah ke Actions. Isi image-nya juga banyak: OpenClaw, gh, uv, qmd, sampai agent-browser lengkap dengan browser-nya. Di runner GitHub, build-nya lebih cepat dan lebih stabil, ditambah ada cache layer (type=gha) dari run sebelumnya.
Efek sampingnya, kalau build rusak, yang merah job di GitHub. Bot yang sedang jalan tetap memakai image lamanya.
Docker socket sengaja tidak dipasang
Container baru bisa mengatur Docker di host-nya kalau /var/run/docker.sock dipasang ke dalamnya. File compose-nya, yang diambil dari punya OpenClaw, sudah menyediakan baris itu tapi di-comment, untuk mode sandbox:
# - /var/run/docker.sock:/var/run/docker.sock
Akses ke socket itu sama dengan akses root di host. Gateway OpenClaw membaca pesan Discord dan menjalankan tool, jadi kalau socket-nya terpasang, satu prompt injection sudah cukup untuk mengambil alih server. Dengan cara ini Miki bebas mengubah apa pun di git, sedangkan deploy tetap urusan CI.
Semua tool masuk ke image
Package yang di-install dengan npm install -g di container yang sedang jalan akan hilang begitu compose membuat ulang container-nya dengan image baru. Karena itu semua tool yang dibutuhkan agent harus ada di image. Versi OpenClaw dikunci lewat build arg:
FROM node:22-bookworm-slim
# ...apt packages, yq, uv, gh, biome, ast-grep
ARG OPENCLAW_VERSION=2026.5.7
RUN npm install -g openclaw@${OPENCLAW_VERSION}
Untuk upgrade OpenClaw, cukup ganti angka itu. Perubahan seperti ini yang paling sering dibuat Miki.
Isi workflow-nya
Workflow ini cuma jalan kalau push ke main mengubah file image atau config:
on:
push:
branches: [main]
paths:
- Dockerfile
- docker-compose.yml
- docker/**
- config/**
- scripts/**
- .github/workflows/**
- skills/**
Job build login ke GHCR dengan GITHUB_TOKEN bawaan, lalu push kedua tag:
- name: Get short SHA
id: short-sha
run: echo "sha=${GITHUB_SHA::7}" >> $GITHUB_OUTPUT
- name: Build and push
uses: docker/build-push-action@v6
with:
context: .
push: true
tags: |
${{ env.IMAGE }}:latest
${{ env.IMAGE }}:${{ steps.short-sha.outputs.sha }}
cache-from: type=gha
cache-to: type=gha,mode=max
Job deploy menunggu build selesai dengan sukses, baru menjalankan script di VPS memakai appleboy/ssh-action. Host, user, dan path repo ada di repo variable. Private key-nya disimpan sebagai secret VPS_SSH_KEY. Hampir sepanjang umur setup ini, script-nya seperti ini:
set -e
cd "$VPS_REPO_PATH"
GHCR_TOKEN=$(grep '^GHCR_TOKEN=' .env | cut -d= -f2-)
echo "$GHCR_TOKEN" | docker login ghcr.io -u henggana --password-stdin
git pull origin main
docker pull "$SHA_TAG"
sed -i "s|^OPENCLAW_IMAGE=.*|OPENCLAW_IMAGE=$SHA_TAG|" .env
OPENCLAW_REPLACE_CONFIG=1 bash scripts/sync-config.sh
docker compose up -d --no-deps openclaw-gateway
docker logout ghcr.io
Ada beberapa hal yang perlu diperhatikan dari script itu:
- Image baru di-pull sebelum restart, jadi bot masih jalan dengan container lama selama proses download. Restart-nya sendiri bikin bot mati sekitar 10 sampai 15 detik.
- Compose membaca tag dengan fallback,
image: ${OPENCLAW_IMAGE:-ghcr.io/henggana/miki-docker-config:latest}. VPS selalu menjalankan tag SHA, sedangkanlatestcuma untuk setup dari nol. sync-config.shmenyimpan backup.bakbertimestamp dulu, lalu menimpa config live denganconfig/openclaw.jsondari repo.- Untuk login ke GHCR, VPS memakai personal access token classic, karena token fine-grained belum bisa dipakai untuk packages. Token-nya ada di
.envVPS, bukan di workflow.
Apa saja yang diubah Miki sendiri
Repo itu punya 156 commit, dan 68 di antaranya dari Miki. Semuanya langsung di-push ke main, tanpa pull request. Miki menaikkan versi OpenClaw delapan kali sampai 2026.5.7, menambah tool ke image, mengatur login gh di dalam container, membuat profil agent dan channel Discord baru, dan menyalin config live-nya kembali ke config dasar di repo. Ini contoh commit dalam satu minggu di bulan April:
2026-04-14 Miki fix(docker): install qmd from npm release for stable CI builds
2026-04-14 Miki chore(docker): bump OpenClaw to 2026.4.14
2026-04-13 Miki chore(docker): bump OpenClaw to 2026.4.12
2026-04-13 Miki chore(config): promote latest live openclaw baseline
Build tanggal 13 dan 14 April itu gagal di job build. Kenaikan versinya sendiri tidak bermasalah. Menurut commit perbaikannya, yang rusak adalah langkah qmd, memory backend OpenClaw, yang waktu itu di-clone dan di-compile dari source dengan Bun di dalam Dockerfile. Job deploy menunggu build, jadi tidak ada yang sampai ke VPS, dan bot tetap jalan dengan image terakhir yang sehat. Miki lalu mengganti build dari source itu dengan rilis npm (npm install -g @tobilu/qmd@2.1.0), dan push berikutnya berhasil.
Bagian yang tidak pernah teruji
Script di atas tidak mengecek apakah container baru benar-benar hidup. Kalau run-nya hijau, artinya semua command selesai tanpa error, tidak lebih dari itu. Padahal file compose-nya sudah punya healthcheck:
healthcheck:
test:
[
"CMD",
"node",
"-e",
"fetch('http://127.0.0.1:18789/healthz').then((r)=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))",
]
interval: 30s
timeout: 5s
retries: 5
start_period: 20s
Bulan Oktober, waktu saya sudah tidak memakai bot-nya, satu sesi Claude Code memindahkan langkah deploy ke scripts/deploy.sh. Script ini menunggu healthcheck tadi dan rollback otomatis kalau gagal:
- Simpan nilai
OPENCLAW_IMAGEyang sekarang dari.env. - Pull image SHA yang baru, tulis ke
.env, sinkronkan config. - Restart gateway, lalu cek
docker inspectsampai statusnyahealthy, maksimal 120 detik. - Kalau tidak sehat, tampilkan 50 baris log terakhir, pasang lagi tag lama dan backup config, restart, lalu exit 1 supaya run-nya merah.
Script itu belum pernah jalan di server sungguhan. Run pertama setelah di-merge sudah gagal di langkah SSH:
ssh: handshake failed: ssh: unable to authenticate, attempted methods [none publickey], no supported methods remain
Karena bot-nya sudah tidak saya pakai, error itu tidak pernah saya perbaiki. Deploy terakhir yang berhasil terjadi tanggal 5 Juni. Logika rollback-nya cuma pernah dites dengan command docker palsu.
Satu lagi yang tidak sempat dikerjakan: membatasi SSH key-nya. Key itu login sebagai user miki, anggota grup docker, jadi siapa pun yang memegang secret GitHub itu praktis punya akses root ke VPS. Perbaikannya adalah entri authorized_keys dengan command="...", supaya key itu cuma bisa menjalankan script deploy.
Kenapa saya matikan
Biaya server-nya lebih saya perlukan untuk hal lain, dan pemakaian LLM lewat OpenRouter juga ada biayanya sendiri. Selain itu, saya tidak benar-benar memakai Miki sebagai assistant sehari-hari. Ini proyek eksplorasi, cara saya mencoba tool yang sedang ramai dibicarakan. Setelah saya dapat apa yang mau saya pelajari, tidak ada pemakaian yang sebanding dengan biaya bulanannya, jadi VPS-nya saya hapus.
TL;DR
OpenClaw di Docker bisa update sendiri tanpa Docker socket. Assistant-nya push ke repo miliknya. GitHub Actions build image, push latest dan tag SHA ke GHCR, masuk ke VPS lewat SSH, menulis SHA itu ke OPENCLAW_IMAGE, lalu menjalankan docker compose up -d --no-deps openclaw-gateway. Kalau build rusak, tidak ada yang sampai ke server.