Panduan Deployment OpenClaw Manager

Pendahuluan

OpenClaw Manager adalah alat manajemen visual lintas platform yang membantu Anda men-deploy dan mengelola gateway bot AI OpenClaw dengan cepat.

Deployment tanpa konfigurasi — satu file executable, dependensi dipasang otomatis
UI manajemen web — buat, mulai/hentikan, hapus instance, dan ganti model melalui browser
Dukungan multi-kanal — Telegram / Feishu / Discord
Dukungan multi-model — seri GPT-5, seri Claude 4.5/4.6, seri Gemini dengan failover otomatis
Mode background — mendukung mode --daemon, tidak terpengaruh saat koneksi SSH terputus
UI multi-bahasa — Bahasa Mandarin / Inggris / Jepang

Prasyarat

Sebelum memulai, pastikan:

API Key APIMart sudah diperoleh Masuk ke APIMart Console untuk mendapatkan API key Anda (diawali dengan sk-)
Bot platform pesan sudah dibuat Siapkan kredensial Bot sesuai platform yang ingin digunakan (lihat bagian konfigurasi kanal di bawah)

Tips: Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di APIMart dan dapatkan API key.

Langkah 1: Unduh

Unduh executable untuk platform Anda dari GitHub Releases:

Platform	Nama File
Windows x64	`openclaw-manager-win-x64.exe`
macOS ARM (Apple Silicon)	`openclaw-manager-macos-arm64.zip`
macOS Intel	`openclaw-manager-macos-x64.zip`
Linux x64	`openclaw-manager-linux-x64`
Linux ARM64	`openclaw-manager-linux-arm64`

Langkah 2: Jalankan

Windows
Linux
macOS

Deployment Windows

Prasyarat

Windows 10/11 (64-bit)
Hak administrator (diperlukan untuk membuat Windows scheduled task guna mengelola Gateway)

Menjalankan

Klik kanan openclaw-manager-win-x64.exe → Run as administrator

Saat pertama kali dijalankan, hal berikut akan dilakukan otomatis:

Memeriksa dan memasang Node.js v22 (mengunduh MSI otomatis untuk instalasi silent jika belum ditemukan)
Memasang OpenClaw CLI (melalui npm install -g openclaw)
Membuka browser otomatis ke UI manajemen

Harus dijalankan sebagai administrator, jika tidak Windows scheduled task tidak dapat dibuat untuk mengelola proses Gateway.

Deployment Linux

Prasyarat

Ubuntu 20.04+ / Debian 11+ / CentOS 8+ (x64 atau ARM64)
Hak root (direkomendasikan)

Menjalankan

Unduh dan beri izin eksekusi:

chmod +x ./openclaw-manager-linux-x64

Mode foreground (untuk pengujian):

./openclaw-manager-linux-x64

Mode background (direkomendasikan untuk produksi):

./openclaw-manager-linux-x64 --daemon

Manajemen Daemon

# Start in background
./openclaw-manager-linux-x64 --daemon
# Or shorthand
./openclaw-manager-linux-x64 -d

# Check status
./openclaw-manager-linux-x64 --status

# Stop
./openclaw-manager-linux-x64 --stop
# Or shorthand
./openclaw-manager-linux-x64 -s

Konfigurasi Firewall

Jika akses jarak jauh diperlukan, buka port berikut:

# Manager Web UI
ufw allow 51942/tcp

# Gateway ports (one per instance, starting from 18789)
ufw allow 18789/tcp

Tips: Di Linux, Manager otomatis bind ke 0.0.0.0, sehingga dapat diakses dari jarak jauh. File log berada di ~/openclaw-manager.log.

Deployment macOS

Prasyarat

macOS 12+ (Apple Silicon atau Intel)

Menjalankan

Ekstrak file zip yang diunduh untuk mendapatkan OpenClaw Manager.app
Klik dua kali untuk menjalankan OpenClaw Manager.app
Saat pertama kali dijalankan, Anda mungkin perlu mengizinkan di pengaturan keamanan:

System Settings → Privacy & Security → Allow Anyway

Tips: Di macOS, Manager bind ke 127.0.0.1 (akses lokal saja). Perintah daemon sama seperti Linux.

Langkah 3: Akses UI Manajemen

Setelah program berjalan, akses UI manajemen web:

http://127.0.0.1:51942

Akses jarak jauh Linux: Ganti 127.0.0.1 dengan IP server Anda, misalnya http://your-server-ip:51942

Langkah 4: Buat Instance

Di UI manajemen web, klik + New Instance untuk memulai:

4.1 Atur Nama Instance

Masukkan nama instance (hanya huruf, angka, underscore, dan tanda hubung, 1-64 karakter).

4.2 Pilih Model AI

Pilih model AI yang ingin digunakan dan masukkan API Key APIMart Anda (diawali dengan sk-). Model yang Didukung:

ID Model	Nama	Fitur
`gpt-5`	GPT-5	Terbaru dan paling kuat
`gpt-5.1`	GPT-5.1	Versi yang ditingkatkan
`gpt-5.2-codex`	GPT-5.2 Codex	Khusus kode
`gpt-5.2-pro`	GPT-5.2 Pro	Versi profesional
`claude-opus-4-6-20260320`	Claude Opus 4.6	Penalaran paling kuat
`claude-sonnet-4-6-20260320`	Claude Sonnet 4.6	Pilihan seimbang
`claude-opus-4-5-20251101`	Claude Opus 4.5	Penalaran lanjutan
`claude-sonnet-4-5-20250929`	Claude Sonnet 4.5	Sangat baik untuk kode
`claude-haiku-4-5-20251001`	Claude Haiku 4.5	Respons cepat
`gemini-2.5-flash`	Gemini 2.5 Flash	Multimodal cepat
`gemini-3-pro-preview`	Gemini 3 Pro Preview	Performa tinggi

Rekomendasi Model:

💰 Hemat biaya: claude-haiku-4-5-20251001, gemini-2.5-flash
🚀 Performa tinggi: gpt-5, claude-opus-4-6-20260320, gemini-3-pro-preview
⚡ Respons cepat: gemini-2.5-flash, claude-haiku-4-5-20251001

Anda juga dapat memilih failover mode untuk menambahkan beberapa model cadangan. Saat model utama tidak tersedia, sistem otomatis beralih ke model cadangan.

4.3 Konfigurasikan Kanal Pesan

Pilih platform pesan Anda dan ikuti tutorial terkait:

Buat bot Telegram melalui BotFather

Feishu

Buat bot enterprise Feishu

Discord

Buat bot server Discord

Langkah 5: Pengikatan Kode Pairing

Setelah instance dibuat dan dijalankan, selesaikan pengikatan pengguna melalui kode pairing:

Pengguna mengirim pesan apa pun ke bot pada platform pesan
Bot membalas dengan kode pairing 8 digit (misalnya DFE62DTD)
Admin mengklik tombol “Pairing Code” untuk instance tersebut di Web UI
Masukkan kode pairing lalu klik “Approve”
Pengguna kini dapat menggunakan bot secara normal

Tips: Kode pairing disimpan di memori Gateway dan kedaluwarsa setelah restart. Jika kode kedaluwarsa, minta pengguna mengirim pesan baru untuk mendapatkan kode baru.

Mengelola Instance

Di UI manajemen, Anda dapat melakukan operasi berikut:

Aksi	Deskripsi
Start	Memulai proses Gateway; bot mulai menerima pesan
Stop	Menghentikan proses Gateway
Switch Model	Mengganti model AI secara real-time tanpa me-restart Gateway
Pairing Code	Menyetujui kode pairing pengguna baru untuk mengizinkan penggunaan bot
Delete	Menghentikan dan menghapus instance beserta semua datanya (tidak dapat dibatalkan)

Port & Data

Port

Tujuan	Port	Alamat Bind
Manager Web UI	`51942`	Windows/macOS: `127.0.0.1`, Linux: `0.0.0.0`
Instance Gateway	Mulai dari `18789`	Setiap instance mendapat port unik

Direktori Data

Konten	Path
Konfigurasi instance	`~/.openclaw-<instance-name>/openclaw.json`
Log Gateway	`~/.openclaw-<instance-name>/logs/gateway.log`
Log Manager	`~/openclaw-manager.log` (mode daemon)
PID Manager	`~/.openclaw-manager.pid`

FAQ

Q1: Manager tidak dapat berjalan?

Solusi:

Platform	Pemeriksaan
Windows	Pastikan dijalankan sebagai administrator
Linux	Pastikan port 51942 tidak sedang digunakan (`lsof -i :51942`)
macOS	Pastikan pengaturan keamanan sudah mengizinkan atau quarantine sudah dihapus
Semua	Periksa log di `~/openclaw-manager.log`

Q2: Perintah openclaw tidak ditemukan?

Solusi:

Program otomatis mendeteksi dan memasang openclaw CLI saat startup
Jika versinya terlalu lama (< 0.1.0), program akan melakukan pembaruan otomatis
Instalasi manual: npm install -g openclaw@latest

Q3: Instance menampilkan status “stopped” setelah dimulai?

Solusi:

Gateway membutuhkan beberapa detik untuk bind port, sehingga status mungkin terlihat tidak sinkron sementara
Refresh halaman untuk memeriksa status terbaru
Periksa log Gateway: ~/.openclaw-<instance-name>/logs/gateway.log

Q4: Bot Feishu tidak merespons?

Solusi:

Pastikan langganan event telah menambahkan im.message.receive_v1
Pastikan metode langganan adalah “Long Connection”
Pastikan versi baru telah dibuat dan dipublikasikan (wajib setelah setiap perubahan izin/event)

Q5: Persetujuan kode pairing gagal?

Solusi:

Pastikan Gateway sedang berjalan
Kode pairing disimpan di memori Gateway dan kedaluwarsa setelah restart
Minta pengguna mengirim pesan baru untuk mendapatkan kode pairing baru

Q6: Bagaimana melihat penggunaan dan biaya API?

Masuk ke APIMart Console untuk melihat:

📊 Statistik panggilan API
💰 Rincian biaya
📈 Grafik tren penggunaan

Dukungan & Bantuan

Jika mengalami masalah:

Mulai dengan APIMart

Daftar APIMart sekarang, dapatkan API key Anda, dan deploy bot AI Anda!

​Pendahuluan

​Prasyarat

​Langkah 1: Unduh

​Langkah 2: Jalankan

​Deployment Windows

​Prasyarat

​Menjalankan

​Deployment Linux

​Prasyarat

​Menjalankan

​Manajemen Daemon

​Konfigurasi Firewall

​Deployment macOS

​Prasyarat

​Menjalankan

​Langkah 3: Akses UI Manajemen

​Langkah 4: Buat Instance

​4.1 Atur Nama Instance

​4.2 Pilih Model AI

​4.3 Konfigurasikan Kanal Pesan

Telegram

Feishu

Discord

​Langkah 5: Pengikatan Kode Pairing

​Mengelola Instance

​Port & Data

​Port

​Direktori Data

​FAQ

​Q1: Manager tidak dapat berjalan?

​Q2: Perintah openclaw tidak ditemukan?

​Q3: Instance menampilkan status “stopped” setelah dimulai?

​Q4: Bot Feishu tidak merespons?

​Q5: Persetujuan kode pairing gagal?

​Q6: Bagaimana melihat penggunaan dan biaya API?

​Dukungan & Bantuan

Mulai dengan APIMart

Pendahuluan

Prasyarat

Langkah 1: Unduh

Langkah 2: Jalankan

Deployment Windows

Prasyarat

Menjalankan

Deployment Linux

Prasyarat

Menjalankan

Manajemen Daemon

Konfigurasi Firewall

Deployment macOS

Prasyarat

Menjalankan

Langkah 3: Akses UI Manajemen

Langkah 4: Buat Instance

4.1 Atur Nama Instance

4.2 Pilih Model AI

4.3 Konfigurasikan Kanal Pesan

Langkah 5: Pengikatan Kode Pairing

Mengelola Instance

Port & Data

Port

Direktori Data

FAQ

Q1: Manager tidak dapat berjalan?

Q2: Perintah openclaw tidak ditemukan?

Q3: Instance menampilkan status “stopped” setelah dimulai?

Q4: Bot Feishu tidak merespons?

Q5: Persetujuan kode pairing gagal?

Q6: Bagaimana melihat penggunaan dan biaya API?

Dukungan & Bantuan