OpenClaw di Docker yang Update Sendiri lewat GitHub Actions: Apa yang Jalan dan Kenapa Saya Matikan

Terbit pada
7 menit baca.
Tags: CI/CDGitHubDevOpsAI

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-config berisi Dockerfile, docker-compose.yml, config dasar config/openclaw.json, skill, dan satu workflow.
  • Setiap ada push ke main, Actions build image lalu push dua tag ke GHCR: latest dan 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, sedangkan latest cuma untuk setup dari nol.
  • sync-config.sh menyimpan backup .bak bertimestamp dulu, lalu menimpa config live dengan config/openclaw.json dari repo.
  • Untuk login ke GHCR, VPS memakai personal access token classic, karena token fine-grained belum bisa dipakai untuk packages. Token-nya ada di .env VPS, 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:

  1. Simpan nilai OPENCLAW_IMAGE yang sekarang dari .env.
  2. Pull image SHA yang baru, tulis ke .env, sinkronkan config.
  3. Restart gateway, lalu cek docker inspect sampai statusnya healthy, maksimal 120 detik.
  4. 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.