> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Panduan Deployment OpenClaw Manager

> Alat visual untuk deployment sekali klik dan pengelolaan gateway bot AI OpenClaw, mendukung platform Telegram, Feishu, dan Discord, serta ditenagai model AI seperti GPT-5, Claude, Gemini, dan lainnya melalui API APIMart.

## 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:

1. **API Key APIMart sudah diperoleh**
   Masuk ke [APIMart Console](https://apimart.ai/keys) untuk mendapatkan API key Anda (diawali dengan `sk-`)

2. **Bot platform pesan sudah dibuat**
   Siapkan kredensial Bot sesuai platform yang ingin digunakan (lihat bagian konfigurasi kanal di bawah)

<Note>
  **Tips:** Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di [APIMart](https://apimart.ai) dan dapatkan API key.
</Note>

## Langkah 1: Unduh

Unduh executable untuk platform Anda dari [GitHub Releases](https://github.com/zhihong-apimart/OpenClaw-Manager-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

<Tabs>
  <Tab title="Windows">
    ### 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

    <Warning>
      **Harus dijalankan sebagai administrator**, jika tidak Windows scheduled task tidak dapat dibuat untuk mengelola proses Gateway.
    </Warning>
  </Tab>

  <Tab title="Linux">
    ### Deployment Linux

    #### Prasyarat

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

    #### Menjalankan

    1. Unduh dan beri izin eksekusi:

    ```bash theme={null}
    chmod +x ./openclaw-manager-linux-x64
    ```

    2. **Mode foreground** (untuk pengujian):

    ```bash theme={null}
    ./openclaw-manager-linux-x64
    ```

    3. **Mode background** (direkomendasikan untuk produksi):

    ```bash theme={null}
    ./openclaw-manager-linux-x64 --daemon
    ```

    #### Manajemen Daemon

    ```bash theme={null}
    # 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:

    ```bash theme={null}
    # Manager Web UI
    ufw allow 51942/tcp

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

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

  <Tab title="macOS">
    ### Deployment macOS

    #### Prasyarat

    * macOS 12+ (Apple Silicon atau Intel)

    #### Menjalankan

    1. Ekstrak file zip yang diunduh untuk mendapatkan `OpenClaw Manager.app`

    2. Klik dua kali untuk menjalankan `OpenClaw Manager.app`

    3. Saat pertama kali dijalankan, Anda mungkin perlu mengizinkan di pengaturan keamanan:

    ```
    System Settings → Privacy & Security → Allow Anyway
    ```

    <Note>
      **Tips:** Di macOS, Manager bind ke `127.0.0.1` (akses lokal saja). Perintah daemon sama seperti Linux.
    </Note>
  </Tab>
</Tabs>

## Langkah 3: Akses UI Manajemen

Setelah program berjalan, akses UI manajemen web:

```
http://127.0.0.1:51942
```

<Note>
  **Akses jarak jauh Linux:** Ganti `127.0.0.1` dengan IP server Anda, misalnya `http://your-server-ip:51942`
</Note>

## 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         |

<Tip>
  **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`
</Tip>

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:

<CardGroup cols={3}>
  <Card title="Telegram" icon="telegram" href="/id/integrations/platform/openclaw-manager-telegram">
    Buat bot Telegram melalui BotFather
  </Card>

  <Card title="Feishu" icon="message" href="/id/integrations/platform/openclaw-manager-feishu">
    Buat bot enterprise Feishu
  </Card>

  <Card title="Discord" icon="discord" href="/id/integrations/platform/openclaw-manager-discord">
    Buat bot server Discord
  </Card>
</CardGroup>

## Langkah 5: Pengikatan Kode Pairing

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

1. Pengguna mengirim pesan apa pun ke bot pada platform pesan
2. Bot membalas dengan **kode pairing 8 digit** (misalnya `DFE62DTD`)
3. Admin mengklik tombol "**Pairing Code**" untuk instance tersebut di Web UI
4. Masukkan kode pairing lalu klik "**Approve**"
5. Pengguna kini dapat menggunakan bot secara normal

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

## 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:**

1. Pastikan langganan event telah menambahkan `im.message.receive_v1`
2. Pastikan metode langganan adalah "**Long Connection**"
3. 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](https://apimart.ai/overview) untuk melihat:

* 📊 Statistik panggilan API
* 💰 Rincian biaya
* 📈 Grafik tren penggunaan

## Dukungan & Bantuan

Jika mengalami masalah:

* 📚 [Dokumentasi APIMart](https://docs.apimart.ai)
* 📚 [GitHub OpenClaw Manager](https://github.com/zhihong-apimart/OpenClaw-Manager)
* 💬 [Komunitas Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Dukungan Teknis: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Mulai dengan APIMart" icon="rocket" href="https://apimart.ai">
  Daftar APIMart sekarang, dapatkan API key Anda, dan deploy bot AI Anda!
</Card>