OpenClaw devbox 🦞

Node ekstensi untuk aplikasi utama OpenClaw, menyediakan lingkungan eksekusi jarak jauh dengan bahasa pemrograman dan alat pengembangan yang sudah terinstal.

Bahasa & Alat yang Terinstal

• Python 3 (python3, pip, venv)
• Node.js (dari image dasar OpenClaw)
• Go (golang)
• Rust (rustc, cargo)
• C/C++ (gcc, g++, make, cmake)
• Alat pengembangan: git, curl, wget, jq, unzip, zip

Paket Pengguna Persisten

Paket yang diinstal pengguna tetap tersimpan setelah container di-restart:

• pip install → ~/.local/
• npm install -g → ~/.npm-global/
• go install → ~/go/
• cargo install → ~/.cargo/

Autentikasi Git (Opsional)

Untuk meng-clone repositori privat, tambahkan variabel lingkungan berikut ke layanan devbox di dashboard Zeabur:

• GIT_TOKEN — GitHub personal access token. Skrip startup akan otomatis mengonfigurasi autentikasi HTTPS. Buat di GitHub > Settings > Developer settings > Personal access tokens dengan scope repo.
• SSH_PRIVATE_KEY — Kunci SSH privat yang di-encode Base64. Skrip startup akan otomatis menulisnya ke ~/.ssh/id_rsa. Buat pasangan kunci dan encode:

  ssh-keygen -t ed25519 -f ~/.ssh/openclaw_devbox -N ""
  base64 -i ~/.ssh/openclaw_devbox    # tempel nilai ini sebagai SSH_PRIVATE_KEY
  

  Lalu tambahkan ~/.ssh/openclaw_devbox.pub ke akun GitHub Anda di Settings > SSH and GPG keys.

Kasus Penggunaan

• Eksekusi kode multi-bahasa — Minta AI menulis dan menjalankan kode Python, Go, Rust, atau C dalam percakapan
• Instalasi dan pengujian paket — Minta AI menginstal paket pihak ketiga dan memverifikasi fungsionalitasnya (instalasi tetap tersimpan setelah restart)
• Pemrosesan dan analisis data — Unggah file data dan minta AI memprosesnya dengan Python atau jq
• Operasi Git dan build proyek — Clone repositori, build proyek, dan jalankan pengujian
• Skrip otomasi sistem — Tulis dan uji shell script dan alat otomasi

Prasyarat

Anda memerlukan instans OpenClaw yang sudah berjalan. Jika belum memilikinya, deploy terlebih dahulu template aplikasi utama OpenClaw.

Pengaturan

1. Sebelum deploy, salin Gateway Token dari tab Instruksi layanan OpenClaw Anda agar mudah dimasukkan nanti
2. Deploy template ini ke proyek Zeabur yang sama dengan instans OpenClaw Anda
3. Masukkan Gateway Token dan Gateway Host (nama layanan Zeabur dari instans OpenClaw Anda, misalnya jika layanan bernama openclaw, masukkan openclaw)
4. Node devbox akan terhubung ke OpenClaw dan mengirim permintaan pairing
5. Setujui permintaan pairing di terminal layanan OpenClaw Anda:

   openclaw devices list       # temukan ID permintaan yang tertunda
   openclaw devices approve <requestId>
   

Rekomendasi Sumber Daya

• CPU: 2 vCPU
• Memori: 2048 MB

Verifikasi

Setelah deployment, pastikan node devbox muncul di OpenClaw:

• Jalankan openclaw nodes list di terminal layanan OpenClaw Anda
• Atau periksa halaman Nodes di OpenClaw Web UI
• Atau tanyakan langsung dalam percakapan: "Can you see the devbox node?"

Arsitektur

• Tidak ada port yang terbuka — devbox memulai koneksi WebSocket keluar ke gateway OpenClaw
• exec.security diatur ke full — tidak perlu persetujuan interaktif untuk eksekusi perintah
• Runtime sistem sudah terpasang di dalam image; paket pengguna disimpan di volume persisten

Pemecahan Masalah

• Jika Anda sudah memasukkan Gateway Host tetapi tidak melihat permintaan pairing yang tertunda di openclaw devices list, kemungkinan nama layanan salah. Buka tab Jaringan pada layanan OpenClaw di dashboard Zeabur dan periksa hostname privat. Misalnya, jika hostname privat adalah openclaw.zeabur.internal, maka Gateway Host harus diisi openclaw (bagian sebelum .zeabur.internal).
• Jika layanan devbox tidak berhasil pairing dalam waktu lama, Zeabur dapat menangguhkannya secara otomatis. Pastikan layanan devbox dalam status berjalan sebelum mencoba pairing.