Langsung ke konten utama

​
Instalasi Nix

Pasang OpenClaw secara deklaratif dengan nix-openclaw — modul Home Manager lengkap.
Repo nix-openclaw adalah sumber kebenaran untuk instalasi Nix. Halaman ini adalah ringkasan singkat.

​
Yang Anda dapatkan

  • Gateway + aplikasi macOS + alat (whisper, spotify, cameras) — semuanya dipin
  • Layanan launchd yang tetap berjalan setelah reboot
  • Sistem plugin dengan konfigurasi deklaratif
  • Rollback instan: home-manager switch --rollback

​
Mulai cepat

1

Pasang Determinate Nix

Jika Nix belum terpasang, ikuti petunjuk installer Determinate Nix.
2

Buat flake lokal

Gunakan template agent-first dari repo nix-openclaw:
mkdir -p ~/code/openclaw-local
# Copy templates/agent-first/flake.nix from the nix-openclaw repo
3

Konfigurasikan secret

Siapkan token bot pesan dan kunci API provider model Anda. File biasa di ~/.secrets/ sudah cukup baik.
4

Isi placeholder template lalu jalankan switch

home-manager switch
5

Verifikasi

Konfirmasikan bahwa layanan launchd berjalan dan bot Anda merespons pesan.
Lihat README nix-openclaw untuk opsi modul dan contoh lengkap.

​
Perilaku runtime mode Nix

Saat OPENCLAW_NIX_MODE=1 disetel (otomatis dengan nix-openclaw), OpenClaw masuk ke mode deterministik yang menonaktifkan alur auto-install. Anda juga dapat menyetelnya secara manual: 
export OPENCLAW_NIX_MODE=1
Di macOS, aplikasi GUI tidak secara otomatis mewarisi variabel lingkungan shell. Aktifkan mode Nix melalui defaults sebagai gantinya: 
defaults write ai.openclaw.mac openclaw.nixMode -bool true

​
Apa yang berubah dalam mode Nix

  • Alur auto-install dan self-mutation dinonaktifkan
  • Dependensi yang hilang menampilkan pesan remediasi khusus Nix
  • UI menampilkan banner mode Nix baca-saja

​
Jalur konfigurasi dan state

OpenClaw membaca konfigurasi JSON5 dari OPENCLAW_CONFIG_PATH dan menyimpan data yang dapat berubah di OPENCLAW_STATE_DIR. Saat berjalan di bawah Nix, setel ini secara eksplisit ke lokasi yang dikelola Nix agar state runtime dan konfigurasi tetap berada di luar immutable store.
VariableDefault
OPENCLAW_HOMEHOME / USERPROFILE / os.homedir()
OPENCLAW_STATE_DIR~/.openclaw
OPENCLAW_CONFIG_PATH$OPENCLAW_STATE_DIR/openclaw.json

​
Terkait