Simple Application Server:FAQ OpenClaw (sebelumnya MoltBot dan Clawbot)

Deploy gambar OpenClaw pada instans yang sudah ada

1. Login ke Konsol Simple Application Server. Pilih instans Anda, lalu klik Reset System.

2. Pilih Reset to Other Image, kemudian pilih versi Openclaw 2026.3.3.

3. Konfigurasi ulang OpenClaw. Setelah reset, kunci API dan token sebelumnya tidak lagi berlaku. Buka Application Details untuk mengonfigurasi ulang kunci API.

Reset gambar aplikasi

Jika gambar Anda bukan versi Openclaw 2026.3.3, lakukan reset sistem untuk memperbarui gambar dan mencoba fitur terbaru OpenClaw.

1. Login ke Konsol Simple Application Server. Pilih instans Anda, lalu klik Reset System.

2. Pilih Reset Operating System.

3. Konfigurasi ulang OpenClaw. Setelah reset, kunci API dan token sebelumnya menjadi tidak valid. Buka Application Details untuk mengonfigurasi ulang kunci API Anda.

Lihat nomor port OpenClaw

Untuk mencegah pemindaian jahat dan serangan terarah, OpenClaw secara otomatis menghasilkan port acak selama inisialisasi. Navigasi ke Application Details > Basic Configuration > View Port, lalu klik View untuk melihat nomor port tersebut.

Apakah OpenClaw dapat mengontrol aplikasi lokal?

Tidak didukung. Simple Application Server berjalan di lingkungan jaringan cloud yang terisolasi dari jaringan komputer lokal. Isolasi ini mencegahnya mengontrol aplikasi desktop secara langsung.

Pencarian web gagal setelah pembaruan

Buka Konsol Simple Application Server. Di bagian Image Information, pastikan Application Image Anda adalah versi OpenClaw 2026.2.3 atau yang lebih baru. Jika tidak, lihat How do I reset my current application image to the latest version? untuk memperbarui. Versi Application Image ini mengaktifkan pencarian web secara default di semua Wilayah menggunakan Skill SearXNG bawaan. Tidak diperlukan konfigurasi tambahan dan tidak dikenakan biaya ekstra. Anda dapat langsung memerintahkan OpenClaw untuk menggunakan Skill SearXNG guna melakukan pencarian web. Jika server Anda berada di Hong Kong (Tiongkok) atau wilayah luar Tiongkok daratan, lihat How do I configure Brave Search for web search in OpenClaw? untuk mengonfigurasi API Brave Search guna pencarian web.

Konfigurasi penyedia model lain

Secara default, gambar OpenClaw telah dikonfigurasi sebelumnya dengan Alibaba Cloud Model Studio (Bailian) Model Provider. Anda dapat mengubah model yang digunakan di pengaturan. Untuk menghubungkan ke layanan model dari OpenAI, Anthropic, Google Gemini, atau penyedia lainnya, ikuti langkah-langkah berikut.

1. Login ke Simple Application Server (SAS) sebagai pengguna admin.

2. Ubah penyedia model. Contoh berikut menggunakan OpenRouter.

   openclaw onboard

   

3. Verifikasi perubahan tersebut. Login ke Web Console dan periksa Model Configuration untuk melihat konfigurasi yang ditambahkan.

   

Bagaimana cara mengubah model yang dipanggil OpenClaw?

Tambahkan skill ke OpenClaw

Anda dapat menambahkan Skill ke OpenClaw dengan salah satu dari tiga cara berikut:

• Pembuatan interaktif (untuk Skill baru)

  OpenClaw menyertakan komponen Skill Creator bawaan. Anda dapat menggambarkan kebutuhan Anda dalam percakapan dengan Skill Creator, dan komponen tersebut akan secara otomatis membuat Skill baru.

• Instal dari URL (untuk Skill yang sudah ada)

  Untuk menginstal Skill yang telah dikembangkan sebelumnya, berikan URL-nya ke OpenClaw, yang akan menginstalnya secara otomatis. Misalnya, untuk menginstal Web Artifacts Builder dari Anthropic, perintahkan agen untuk menginstal Skill tersebut selama percakapan.

• Instal dari sumber transit (untuk lingkungan dengan pembatasan jaringan)

  Jika pembatasan jaringan mencegah server Anda mengakses repositori kode eksternal seperti GitHub, gunakan metode mirroring:

  1. Unduh file Skill ke mesin lokal Anda.

  2. Unggah kode ke ruang penyimpanan yang dapat diakses oleh server Anda, seperti mengunggah ke OSS.

  3. Dapatkan URL unduhan baru dan berikan ke OpenClaw untuk menginstal Skill tersebut, seperti yang dijelaskan di Install from a URL.

Pemuatan dan prioritas Skill

Ya. Anda dapat menambahkan direktori lain dengan mengonfigurasi field skills.load.extraDirs di ~/.openclaw/openclaw.json. Direktori-direktori ini memiliki prioritas terendah.

Prioritas pemuatan Skill, dari tertinggi ke terendah, adalah: <workspace>/skills > ~/.openclaw/skills > Skill bawaan > skills.load.extraDirs.

Secara default, tool clawhub menginstal Skill ke ./skills. OpenClaw memperlakukan direktori ini sebagai <workspace>/skills.

Restart layanan OpenClaw Gateway

openclaw gateway restart

File konfigurasi OpenClaw

• Direktori file konfigurasi: /root/.openclaw/

• File konfigurasi utama: /root/.openclaw/openclaw.json (berisi daftar model yang dikonfigurasi)

• File konfigurasi kunci API model: /root/.openclaw/agents/main/agent/auth-profiles.json

Edit file konfigurasi ini untuk menambahkan model atau mengonfigurasi kunci API.

Konfigurasi manual Bailian Coding Plan

1. Salin dan simpan kunci API spesifik rencana untuk Coding Plan tersebut.

2. Pada blok kode berikut, ganti placeholder YOUR_API_KEY dengan kunci API spesifik rencana Anda.

    "models": {
       "mode": "merge",
       "providers": {
         "bailian": {
           "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
           "apiKey": "<span class="var-span" contenteditable="true" data-var="YOUR_API_KEY">YOUR_API_KEY"</span>,
           "api": "openai-completions",
           "models": [
             {
               "id": "qwen3-max-2026-01-23",
               "name": "qwen3-max-thinking",
               "reasoning": <span class="hljs-keyword">false</span>,
               "input": [
                 "text"
               ],
               "cost": {
                 "input": 0,
                 "output": 0,
                 "cacheRead": 0,
                 "cacheWrite": 0
               },
               "contextWindow": 262144,
               "maxTokens": 65536
             }
           ]
         }
       }
     },
     "agents": {
       "defaults": {
         "model": {
           "primary": "bailian/qwen3-max-2026-01-23"
         },
         "models": {
           "bailian/qwen3-max-2026-01-23": {
             "alias": "qwen3-max-thinking"
           }
         },
         "maxConcurrent": 4,
         "subagents": {
           "maxConcurrent": 8
         }
       }
     },

3. Buka halaman Konsol Simple Application Server - Servers, temukan server tempat OpenClaw dideploy, lalu klik ID instans-nya untuk membuka halaman Server Overview.

4. Klik tab Application Details. Di halaman Access Control, klik Execute Command. Di kotak dialog yang muncul, klik URL website untuk membuka halaman percakapan OpenClaw.

5. Klik Config > All Settings > Raw untuk membuka file konfigurasi. Salin blok kode dengan parameter "apiKey" yang telah dimodifikasi. Lalu, seperti yang ditunjukkan pada gambar berikut, ganti konten asli "agents"{...} dalam kode konfigurasi Anda dan simpan perubahan tersebut.

Perbaiki error "command not found: openclaw"

Buat tautan simbolik dengan menjalankan perintah berikut:

ln -sf /home/clawdbot/dist/entry.js /usr/bin/openclaw
openclaw --help

Konfigurasi Brave Search

Anda hanya dapat mengonfigurasi Brave Search untuk pencarian web pada instans Simple Application Server di Hong Kong (Tiongkok) atau wilayah luar Tiongkok daratan.

Gambar Aplikasi OpenClaw versi 2026.2.3 dan yang lebih baru sudah menyertakan fitur pencarian web berbasis SearXNG secara default.

1. Buat Akun API Brave Search dan hasilkan Kunci API di situs resmi Brave Search.

2. Buka halaman OpenClaw. Klik Config > All Settings > Raw di panel navigasi untuk membuka File Konfigurasi. Salin blok kode berikut dan tempelkan ke file tersebut pada lokasi yang ditunjukkan pada gambar. Ganti placeholder BRAVE_API_KEY dengan Kunci API Brave Search Anda.

     "tools": {
       "web": {
         "search": {
           "provider": "brave",
           "apiKey": "<span class="var-span" contenteditable="true" data-var="BRAVE_API_KEY">BRAVE_API_KEY"</span>,
           "maxResults": 5,
           "timeoutSeconds": 30
         }
       }
     },

   

Jalankan tools di Docker

OpenClaw dapat menjalankan Tools di Kontainer Docker untuk mengurangi risiko. Mengaktifkan Fitur opsional ini akan menjalankannya di lingkungan sandbox. Untuk informasi lebih lanjut, lihat panduan fitur sandboxing OpenClaw.

Tool CLI OpenClaw

Login ke terminal server dan alihkan ke pengguna root untuk menjalankan perintah berikut.

Gunakan kuota gratis di wilayah Singapura untuk menghindari biaya

Secara default, Model di wilayah Singapura Model Studio dikenakan Biaya untuk penggunaan yang melebihi Kuota Gratis. Untuk menghindari Biaya Pemanggilan Model yang melebihi Kuota Gratis, aktifkan Stop when free quota is exhausted di konsol Model Studio. Setelah diaktifkan, Model menjadi tidak tersedia setelah Kuota Gratis-nya habis. Anda kemudian dapat beralih ke Model lain yang masih memiliki Kuota Gratis.

Persyaratan konfigurasi server OpenClaw

Pilih konfigurasi dengan minimal 2 vCPU dan memori 2 GiB untuk performa optimal.

Biaya tambahan

Jika Anda mengonfigurasi OpenClaw pada instans untuk memanggil model menggunakan kunci API dari Model Studio, biaya akan dikenakan berdasarkan penggunaan token. Untuk detail penagihan, lihat dokumentasi Model Invocation Billing.

Kuota gratis model di wilayah Singapura

Login ke Konsol Model Studio. Di bagian Free Quota, Anda dapat melihat kuota yang tersisa untuk model di Akun Anda.

Menampilkan catatan pemanggilan model

Perbedaan antara wilayah Internasional (Singapura), AS (Virginia), dan Tiongkok daratan (Beijing)

Alibaba Cloud Model Studio menawarkan Layanan Model di wilayah Internasional (Singapura), AS (Virginia), dan Tiongkok daratan (Beijing). Memilih Wilayah terdekat dapat mengurangi latensi jaringan. Titik akhir layanan dan kunci API bersifat unik untuk setiap Wilayah. Model yang didukung, fitur Platform, dan harga juga berbeda-beda tergantung Wilayahnya. Untuk detailnya, lihat Model List.

Tidak ada respons di Chat OpenClaw

1. Verifikasi konfigurasi kunci API Anda. Hubungkan secara remote ke Simple Application Server Anda. Pada kode berikut, ganti placeholder YOUR_API_KEY dan YOUR_API_KEY_BASE_URL dengan kunci API dan URL dasar untuk Wilayah Anda. Salin dan tempelkan kode yang telah diperbarui ke terminal untuk menguji pemanggilan model. Jika terjadi error, cari di dokumentasi pesan error dan ikuti solusi yang direkomendasikan. URL dasar bersifat spesifik untuk setiap Wilayah:

   • Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

   • AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions

   • Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions

   • Coding Plan: https://coding-intl.dashscope.aliyuncs.com/v1/chat/completions

   curl -X POST YOUR_API_KEY_BASE_URL \
   -H "Authorization: Bearer YOUR_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
       "model": "qwen3-max-2026-01-23",
       "messages": [
           {
               "role": "user",
               "content": "Who are you?"
           }
       ]
   }'

2. Periksa apakah ada Pembayaran tertunda atau pembatasan laju pada layanan model.

   1. Coding Plan: Setiap rencana memiliki batas permintaan per 5 jam, mingguan, dan bulanan. Periksa penggunaan kuota Anda di Konsol Coding Plan. Jika Anda melebihi batas, layanan akan mengembalikan pesan error hour/week/month allocated quota exceeded.

      Solusi: Tunggu kuota direset secara otomatis atau upgrade ke paket Pro.

   2. Untuk kunci API Model Studio bayar sesuai penggunaan:

      1. Periksa kuota gratis Anda. Login ke Konsol Model Studio. Di bagian Free Quota, lihat kuota gratis yang tersisa untuk model di akun Anda.

      2. Periksa apakah ada Pembayaran tertunda. Buka pusat Biaya dan Pengeluaran untuk memastikan akun Anda tidak memiliki Pembayaran tertunda.

3. Tinjau log error. Buka halaman Chat OpenClaw. Di panel navigasi kiri, klik Logs. Pilih kotak centang WARN dan ERROR untuk melihat log error. Cari error tersebut di FAQ OpenClaw untuk menemukan solusinya.

   

   Jika tidak ada error yang muncul di Logs, restart gateway dari konsol.

4. Reset gambar.

   Jika server Anda tidak berisi data penting, reset Simple Application Server ke gambar aplikasi OpenClaw terbaru lalu konfigurasi ulang.

   Penting

   Tindakan Reset operating system sama dengan menginstal ulang sistem operasi. Tindakan ini menghapus semua data pada sistem disk, termasuk konfigurasi, log, dan database yang tersimpan. Sebelum melanjutkan, backup data penting. Buat Snapshot atau ekspor data ke perangkat lokal.

Error HTTP 401 di OpenClaw

Error ini terjadi ketika token akses kedaluwarsa. Buka halaman Application Details di konsol Simple Application Server, hasilkan ulang URL login OpenClaw, lalu gunakan URL baru tersebut untuk mengakses OpenClaw.

Penginstalan Skill diblokir

Antarmuka manajemen OpenClaw mendukung instalasi satu-klik untuk beberapa Skill. Namun, sebagian besar Skill bergantung pada Homebrew sehingga tidak mendukung instalasi satu-klik. Untuk menggunakan Skill tersebut, Anda harus menginstal Homebrew di server Anda lalu mengonfigurasinya secara manual.

Selesaikan error "disconnected (1008): unauthorized"

Kesalahan ini menunjukkan bahwa URL akses Anda tidak menyertakan Token Autentikasi. Konsol Web OpenClaw tidak mengizinkan akses langsung melalui alamat IP; URL Anda harus mencakup Parameter Token yang valid. Untuk mendapatkan URL akses baru, buka Konsol Server, lalu klik ID Instance pada kartu server. Di halaman ringkasan server, pilih tab Application Details. Pada bagian Access Control, klik Execute Command.

Selesaikan error "disconnected (1008)"

Error ini terjadi karena token belum diinisialisasi. Untuk mengatasi error ini, buka halaman Application Details di konsol Simple Application Server, atur kunci API di Langkah 2, lalu dapatkan tautan akses baru.

Menyelesaikan error "disconnected (1006)"

Ikuti langkah-langkah berikut untuk pemecahan masalah:

1. Login ke Konsol Alibaba Cloud Simple Application Server, temukan Instans Anda, buka Halaman Application Details, lalu hasilkan ulang token tersebut.

2. Tambahkan token baru ke URL akses dalam format http://XXX:18789/?token=YOUR_NEW_TOKEN, lalu uji URL tersebut di jendela penyamaran.

3. Gunakan SSH untuk login ke Server dan verifikasi bahwa layanan OpenClaw sedang berjalan.

4. Pastikan bahwa grup keamanan untuk Simple Application Server Anda mengizinkan Traffic TCP arah masuk pada port pendengaran.

   Jika layanan tidak terikat dengan benar ke Alamat IP Publik atau Reverse Proxy salah dikonfigurasi, koneksi WebSocket mungkin gagal. Uji konektivitas lokal dengan curl atau telnet untuk mengisolasi masalah tersebut.

Pemecahan masalah error "401 Unauthorized"

Saat menggunakan model dari Alibaba Cloud Model Studio, sistem mungkin mengembalikan error Failed to discover Alibaba Cloud models: 401 Unauthorized.

Kemungkinan penyebab: Error 401 biasanya disebabkan oleh kunci API yang dimasukkan salah, ketidaksesuaian antara Wilayah kunci API dan Wilayah URL dasar, atau Izin Workspace atau Akun yang tidak mencukupi untuk memanggil Model tersebut.

Pemecahan masalah dan penyelesaian:

curl -X POST https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer <span class="var-span" contenteditable="true" data-var="DASHSCOPE_API_KEY">DASHSCOPE_API_KEY"</span> \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3-max-2026-01-23",
    "messages": [
        {
            "role": "system",
            "content": "Anda adalah asisten yang membantu."
        },
        {
            "role": "user", 
            "content": "Siapa Anda?"
        }
    ]
}'

Perbaiki error 'openclaw: command not found'

Untuk membuat tautan simbolik, jalankan perintah berikut:

ln -sf /home/clawdbot/dist/entry.js /usr/bin/openclaw
openclaw --help

Kegagalan pengambilan token setelah mengaktifkan Tailscale

Masalah ini terjadi karena Tailscale memodifikasi kebijakan perutean. Sebagai solusi sementara, jalankan perintah berikut untuk membaca token langsung dari instans:

1. Login ke terminal server OpenClaw.

2. Jalankan perintah berikut:

   echo $(sed -z 's/.*"token": "\([^"]*\)".*/\1/' /root/.clawdbot/clawdbot.json | tr -d '\0')

3. Output perintah tersebut adalah token Anda.

Pemecahan masalah akses eksternal ke OpenClaw

Port 18789 OpenClaw mendengarkan di 127.0.0.1, sehingga mencegah akses eksternal.

Kemungkinan penyebab: Masalah ini terjadi jika parameter bind dalam file konfigurasi OpenClaw diubah. Secara default, parameter ini diatur ke lan untuk mengizinkan akses publik. Jika Anda mengubah parameter menjadi loopback dan merestart layanan, port hanya akan mendengarkan pada alamat loopback 127.0.0.1.

Solusi:

1. Periksa konfigurasi. Login ke Simple Application Server (SAS) sebagai pengguna admin dan jalankan perintah berikut untuk memeriksa parameter bind saat ini:

   cat /home/admin/.openclaw/openclaw.json | grep bind

2. Edit file konfigurasi. Tinjau output perintah tersebut. Jika output menunjukkan "bind": "loopback", edit file konfigurasi dan ubah parameter kembali menjadi "lan".

3. Restart layanan Gateway. Setelah menyimpan file konfigurasi, jalankan perintah berikut untuk merestart layanan Gateway:

   openclaw gateway restart

   Setelah layanan dijalankan ulang, port kembali mendengarkan secara normal, sehingga mengembalikan akses eksternal.

Kegagalan restart layanan Gateway

Saat Anda mencoba merestart Layanan Gateway, terjadi error saat menjalankan perintah openclaw gateway restart, dan layanan gagal dijalankan ulang.

Penyelesaian: Jika perintah restart standar gagal, hentikan secara manual Proses tersebut lalu jalankan ulang Layanan. Ikuti langkah-langkah berikut:

1. Login ke server. Gunakan pengguna admin untuk login ke Simple Application Server.

2. Hentikan Proses saat ini. Jalankan perintah berikut untuk menghentikan Proses Gateway OpenClaw saat ini:

   killall openclaw-gateway

3. Jalankan ulang Layanan. Setelah Proses dihentikan, jalankan perintah berikut untuk menjalankan ulang Layanan Gateway:

   openclaw gateway start

   Catatan: Anda dapat mengabaikan pesan error apa pun yang dikembalikan oleh perintah start.

4. Verifikasi status layanan. Setelah perintah start selesai, jalankan perintah ps aux | grep gate untuk memeriksa apakah proses openclaw-gateway telah berhasil dimulai, dan jalankan perintah netstat -nltp untuk mengonfirmasi bahwa port terkait berada dalam keadaan mendengarkan normal.

   

Server crash, masalah memori, dan OOM Killer

• Upgrade konfigurasi instans
  Kami menyarankan Anda mengupgrade konfigurasi instans Anda minimal menjadi 2 vCPU dan memori 2 GiB. Ini meningkatkan stabilitas Simple Application Server dan mengurangi masalah terkait sumber daya, seperti crash server, downtime, dan kehabisan memori.
  
  

• Periksa dan konfigurasi Partisi Swap
  Gambar aplikasi Simple Application Server yang dibuat setelah 26 Februari 2026 sudah menyertakan Partisi Swap secara default. Jika instans Anda menggunakan gambar yang lebih lama, kami menyarankan mengonfigurasi secara manual Partisi Swap atau mereset gambar aplikasi saat ini ke versi terbaru. Ini memberikan buffer saat memori rendah, sehingga mengurangi kejadian OOM Killer dan gangguan layanan yang tidak terduga.