Simple Application Server:OpenClaw FAQ

Deploy gambar OpenClaw pada server yang sudah ada

1. Login ke Simple Application Server console, pilih instans target, lalu klik Server Resetting.

2. Pilih Reset to Other Image, lalu pilih gambar OpenClaw 2026.5.19.

3. Konfigurasi ulang OpenClaw. Setelah Anda mereset sistem, API key dan token yang dikonfigurasi sebelumnya menjadi tidak valid. Buka halaman Application Details untuk mengonfigurasi ulang API key.

Reset gambar aplikasi

Jika gambar aplikasi saat ini bukan versi OpenClaw 2026.5.19, reset sistem untuk memperbarui gambar dan mengakses fitur terbaru OpenClaw.

1. Login ke Simple Application Server console, pilih instans target, lalu klik Server Resetting.

2. Pilih Reset to Other Image, lalu pilih versi OpenClaw 2026.5.19.

3. Konfigurasi ulang OpenClaw. Mereset sistem membuat API key dan token Anda tidak valid. Buka halaman Application Details untuk mengonfigurasi ulang API key.

Periksa versi gambar OpenClaw

Anda dapat memeriksa versi gambar instans OpenClaw dengan dua cara:

• Dari konsol: Login ke Simple Application Server console. Buka halaman detail instans OpenClaw target dan navigasi ke Basic Information > Images untuk melihat versi gambar saat ini.

• Menggunakan perintah terminal: Di Simple Application Server console, klik Remote Connection > Log on Now untuk membuka terminal. Jalankan perintah berikut untuk memeriksa versi:

  openclaw --version

Nomor versi dari kedua metode tersebut memiliki makna berbeda:

• Versi gambar di konsol: Ini adalah versi gambar yang digunakan untuk membuat instans.

• Versi yang dikembalikan oleh openclaw --version: Ini adalah versi aplikasi OpenClaw yang sedang berjalan, yang berubah seiring pembaruan aplikasi.

Wajar jika nomor versi ini berbeda karena berasal dari sumber yang berbeda.

Atasi error saat reset sistem

Jika terjadi error saat mereset sistem, hentikan dulu instans Simple Application Server. Anda hanya dapat mereset sistem ketika instans berada dalam status stopped.

1. Login ke Simple Application Server console. Di daftar instans, klik instans target.

2. Di pojok kanan atas halaman detail instans, klik Stop. Tunggu hingga status instans berubah menjadi stopped.

3. Saat instans berhenti, Server Resetting akan berjalan kembali.

Kegagalan perintah firewall OpenClaw

Saat menggunakan fitur One-click Firewall Passthrough untuk aplikasi OpenClaw di konsol Simple Application Server, mungkin muncul pop-up berisi pesan kesalahan: "Gagal mengambil perintah penerusan port." Pop-up tersebut juga menampilkan peringatan: "Firewall Anda akan membuka port yang tidak ditentukan untuk lalu lintas dari sumber 0.0.0.0/0. Kaji risiko keamanannya, lalu klik Confirm."

• Penyebab: Port OpenClaw yang hilang dalam file konfigurasi mencegah sistem mengambil perintah port passthrough.

• Versi yang terpengaruh: Isu ini hanya memengaruhi versi OpenClaw sebelum 2026.3.28. Versi 2026.3.28 dan seterusnya telah mencakup perbaikan.

• Solusi: Reset gambar aplikasi saat ini ke versi terbaru.

Atasi "API rate limit reached" di OpenClaw

Untuk mengatasi error ini, periksa item berikut secara berurutan:

1. Konfigurasi OpenClaw yang salah.

   Jika URL dasar atau penyedia model dikonfigurasi salah, permintaan Anda mungkin diarahkan ke titik akhir API umum alih-alih saluran Coding Plan khusus, sehingga memicu batas laju.

   • Jika Anda menggunakan Coding Plan, periksa file konfigurasi OpenClaw untuk memastikan parameter models, agents, dan gateway, termasuk field bersarang apa pun, dikonfigurasi dengan benar. Misalnya, penyedia model harus disusun sebagai berikut: { "models": { "providers": { "Model Studio": {...} } } } .

   • Jika Anda saat ini tidak menggunakan Coding Plan, pertimbangkan beralih ke Coding Plan untuk mendapatkan kuota khusus.

2. Kuota paket terlampaui: Periksa penggunaan paket Anda di halaman Coding Plan.

3. Coba reset API key: Jika masalah tetap ada setelah pemeriksaan sebelumnya, buka halaman Coding Plan untuk meresetnya.

Troubleshooting umum untuk batas laju (berlaku untuk semua penyedia model)

Jika Anda menerima error API rate limit reached saat memanggil model, hal ini juga dapat disebabkan oleh isu berikut:

• Frekuensi pemanggilan berlebihan: Mengirim terlalu banyak permintaan dalam periode singkat dapat memicu batas laju penyedia model. Kurangi frekuensi pemanggilan dan coba lagi setelah menunggu sebentar.

• Permintaan konkuren berlebihan: Sejumlah besar permintaan konkuren yang dikirim dalam periode singkat dapat menyebabkan error ini. Tinjau parameter maxConcurrent dalam konfigurasi aplikasi Anda dan pertimbangkan untuk menurunkan batas konkurensi.

• Kuota gratis habis: Jika Anda menggunakan kuota gratis, error ini mungkin menunjukkan bahwa kuota gratis Anda telah habis. Beberapa penyedia mengembalikan error 403 atau batas laju saat kuota gratis habis, bukan beralih otomatis ke penagihan berbayar.

Dukungan model pihak ketiga

Ya. Konfigurasi tergantung pada versi gambar OpenClaw Anda. Alihkan antar tab di bawah untuk melihat penyedia yang didukung dan metode integrasi untuk versi Anda.

Jika Anda hanya menggunakan model Alibaba Cloud Model Studio, Anda tidak perlu mengonfigurasi model pihak ketiga. Di halaman Application Details di konsol, bagian konfigurasi model hanya menampilkan opsi Alibaba Cloud Model Studio, seperti Model Studio Coding Plan dan Alibaba Cloud Model Studio. Ini adalah perilaku yang diharapkan, dan tidak diperlukan tindakan lebih lanjut. Model pihak ketiga diintegrasikan menggunakan jalur konfigurasi terpisah dan tidak ditambahkan dari menu drop-down ini.

Isu WebUI dengan model pihak ketiga

Jika Anda mengonfigurasi model pihak ketiga seperti DeepSeek atau MiniMax, tetapi model tersebut tidak muncul di menu drop-down WebUI atau kembali ke model default (misalnya Qwen) setelah Anda mengganti, ikuti langkah-langkah berikut:

• Periksa integritas konfigurasi: Pastikan Anda telah menambahkan model ke models.providers, menambahkan referensi ke model di agents.defaults.models dalam format provider-id/model-id, dan menentukan model default di agents.defaults.model.primary. Jika Anda hanya mengonfigurasi models.providers tanpa menambahkan referensi, WebUI tidak akan mengenali model baru tersebut.

• Restart layanan untuk menerapkan perubahan: Setelah memodifikasi file konfigurasi, jalankan perintah berikut:

  openclaw gateway restart

• Batasan konsol: Halaman "Application Details" di Simple Application Server console hanya mendukung menampilkan dan memodifikasi model dari Model Studio. Konsol tidak mendukung menampilkan atau memodifikasi model pihak ketiga. Konfigurasi untuk model pihak ketiga hanya ditentukan dalam file ~/.openclaw/openclaw.json di server. Oleh karena itu, wajar jika konsol menampilkan model Model Studio meskipun model pihak ketiga sedang aktif.

• Mengganti model:

  • Untuk mengganti model dalam chat WebUI, kirim perintah: /model provider-id/model-id

  • Untuk mengganti model dari terminal, jalankan: openclaw models set provider-id/model-id

  • Untuk menampilkan daftar model yang tersedia, jalankan: openclaw models list

  Daftar agents.defaults.models dalam file konfigurasi ~/.openclaw/openclaw.json menentukan model mana yang tersedia untuk di-switch dengan perintah di atas. Untuk menambahkan model switchable baru, pertama tambahkan konfigurasinya ke models.providers lalu tambahkan referensinya ke agents.defaults.models.

  Sebelum mengganti model, buat snapshot instans atau cadangkan file konfigurasi (cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak). Ini memastikan Anda dapat memulihkan pengaturan dengan cepat jika terjadi kesalahan konfigurasi.

• Periksa aktivasi model fallback: Jika konfigurasi benar tetapi model yang berbeda masih digunakan, periksa log OpenClaw untuk melihat apakah batas laju atau error telah mengaktifkan model fallback.

Penggantian model tidak berlaku

Setelah mengganti model di konsol, misalnya dari Qwen-Plus ke Qwen-Max, percakapan mungkin masih menggunakan model lama meskipun konfigurasi telah diperbarui. Hal ini karena perubahan hanya berlaku setelah Anda merestart layanan gateway dan merefresh halaman.

Prosedur

1. Verifikasi bahwa field agents.defaults.model.primary dalam file konfigurasi ~/.openclaw/openclaw.json telah diperbarui ke model target. Field ini menentukan model aktif.

2. Jalankan perintah berikut untuk merestart gateway dan menerapkan konfigurasi baru:

   openclaw gateway restart

3. Refresh halaman browser Anda atau regenerasi URL akses, lalu konfirmasi bahwa percakapan menggunakan model baru.

Feishu berhenti membalas setelah penggantian model

Mengganti large model membuat konfigurasi channel Feishu tidak valid, sehingga bot Feishu tidak dapat merespons pesan. Untuk mengatasi hal ini, buka halaman detail aplikasi di Simple Application Server console dan masukkan ulang App ID dan App Secret untuk channel Feishu.

Prosedur

1. Login ke Simple Application Server console dan klik instans target di daftar server.

2. Buka halaman Application Details dan temukan konfigurasi channel Feishu.

3. Masukkan ulang Feishu App ID dan App Secret. Setelah menyimpan perubahan, bot Feishu akan kembali beroperasi normal.

Error Http 401 (API key salah / Token akses tidak valid)

Error HTTP 401 biasanya menunjukkan API Key yang salah atau ketidakcocokan antara Base URL dan key tersebut. Tinjau skenario berikut:

Skenario 1: Model tujuan umum Alibaba Cloud Model Studio (pay-as-you-go)

• Format API Key: Verifikasi bahwa API Key Anda dimulai dengan sk-.

• Kesesuaian wilayah: Pastikan wilayah API Key sesuai dengan wilayah Base URL. Misalnya, key untuk wilayah China (Beijing) memerlukan URL yang sesuai.

• Base URL: Base URL standar adalah https://dashscope.aliyuncs.com/compatible-mode/v1.

• Catatan: API Key untuk Coding Plan dan layanan pay-as-you-go tidak dapat dipertukarkan.

Skenario 2: Alibaba Cloud Model Studio Token Plan

• Format API Key: Pastikan API Key Anda dimulai dengan sk-sp-.

• Base URL: Anda harus menggunakan Base URL https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1.

• Catatan: Token Plan tidak mendukung pengaturan satu klik di konsol. Anda harus mengedit file konfigurasi secara manual.

Skenario 3: Model pihak ketiga (MiniMax, DeepSeek, Tencent Cloud, dll.)

• Pastikan Anda menggunakan API Key yang disediakan oleh platform pihak ketiga, bukan key Alibaba Cloud Model Studio.

• Periksa key untuk spasi atau karakter baris baru di awal atau akhir.

• Verifikasi bahwa Base URL benar. Misalnya, Base URL untuk DeepSeek adalah https://api.deepseek.com/v1.

• Beberapa model, seperti MiniMax, mungkin mengharuskan Anda memilih Auth Method tertentu, seperti MiniMax CN atau MiniMax Global.

Langkah troubleshooting umum

• Regenerasi API Key di konsol penyedia pihak ketiga dan ganti yang lama dalam konfigurasi Anda.

• Periksa file konfigurasi ~/.openclaw/openclaw.json untuk memastikan field apiKey berisi nilai yang benar.

• Jalankan openclaw gateway restart untuk merestart layanan.

Dukungan model lokal

Saat ini, OpenClaw yang dideploy di cloud (misalnya, dari gambar Simple Application Server) tidak mendukung pemanggilan large model yang berjalan di mesin lokal atau jaringan area lokal. OpenClaw memerlukan akses ke titik akhir API yang dapat diakses publik.

Untuk menggunakan model lokal, Anda harus memenuhi persyaratan berikut:

• Pastikan layanan model lokal Anda diekspos ke jaringan publik dan dapat diakses oleh server cloud.

• Konfigurasikan Base URL publik Anda di ~/.openclaw/openclaw.json di bawah models.providers, seperti yang dijelaskan dalam "Panduan Integrasi Model Pihak Ketiga Umum."

Dampak perubahan penyedia model

Mengubah penyedia model untuk OpenClaw hanya memengaruhi aplikasi OpenClaw itu sendiri dan biasanya tidak memengaruhi aplikasi lain yang dideploy di server, seperti Hermes.

Jika terjadi kesalahan konfigurasi, Anda dapat melakukan rollback menggunakan snapshot instans dari Simple Application Server console. Sebelum setiap perubahan, buat snapshot atau cadangkan file konfigurasi (cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak).

Dukungan multi-model

Ya. OpenClaw dapat terhubung ke beberapa large model dari penyedia berbeda secara bersamaan. Di Simple Application Server console, buka halaman Application Details untuk instans OpenClaw Anda. Bagian Model Configuration memiliki dua mode:

• Model Studio Coding Plan: Mendukung seri Qwen Alibaba Cloud dan model dari penyedia pihak ketiga seperti MiniMax, GLM, dan Kimi.

• Model Studio: Mendukung seri Qwen, termasuk model vision seperti qwen3-vl-plus dan qwen3-vl-flash.

Pilih penyedia dan model spesifik dari daftar drop-down, lalu klik Apply untuk menyelesaikan konfigurasi. Model Studio mengintegrasikan model pihak ketiga, sehingga Anda tidak perlu memasukkan URL dasar atau API key secara manual.

Lihat nomor port OpenClaw

Untuk mencegah pemindaian berbahaya dan serangan yang ditargetkan, OpenClaw menghasilkan nomor port acak saat inisialisasi. Untuk melihat nomor port, buka Application Details > Basic Configuration > View Port dan klik View.

Mengontrol aplikasi lokal dengan OpenClaw

Tidak. Instans Simple Application Server berjalan di jaringan cloud yang terisolasi dari jaringan lokal Anda, sehingga mencegah OpenClaw mengontrol aplikasi di komputer Anda secara langsung.

Mengapa pencarian web tidak tersedia setelah pembaruan?

Buka Simple Application Server console. Di bagian Image Information, pastikan gambar aplikasi Anda adalah versi OpenClaw 2026.2.3 atau yang lebih baru. Jika Anda menggunakan versi sebelumnya, perbarui seperti yang dijelaskan dalam Cara mereset gambar aplikasi saat ini ke versi terbaru?. Gambar aplikasi ini menyediakan fitur pencarian web secara default di semua wilayah melalui Skill SearXNG bawaan. Fitur ini tidak memerlukan konfigurasi tambahan dan tidak dikenai biaya tambahan. Anda dapat menginstruksikan OpenClaw untuk menggunakan Skill SearXNG guna mencari web. Jika server Anda berada di wilayah China (Hong Kong) atau wilayah di luar daratan Tiongkok, lihat Cara mengonfigurasi fitur Brave Search untuk OpenClaw untuk mengonfigurasi API Brave Search guna pencarian web.

Bagaimana cara mengganti model OpenClaw?

Anda dapat mengganti model OpenClaw yang berbeda di konsol. Prosedurnya bervariasi tergantung pada versi gambar Anda:

• Untuk OpenClaw 2026.5.19 dan versi setelahnya: Buka halaman detail aplikasi. Di kartu Models, temukan model yang dikonfigurasi dan klik Switch Model untuk memilih yang berbeda, atau klik Add Model untuk menghubungkan ke penyedia model baru. Versi ini mendukung beberapa penyedia, termasuk AI coding plan, Alibaba Cloud Model Studio Token Plan, Alibaba Cloud Model Studio, deepseek, Kimi, GLM Coding Plan, dan Zhipu.

• Untuk versi sebelum OpenClaw 2026.5.19: Buka Application Details > Model Configuration > Model Configuration, hapus model default, lalu pilih model Alibaba Cloud Model Studio yang berbeda dari daftar drop-down.

Skill pra-instal

Secara default, gambar aplikasi untuk OpenClaw 2026.2.3 dan versi setelahnya hanya mencakup Skill pencarian web SearXNG bawaan. Untuk menggunakan Skill lain, Anda harus menginstalnya secara manual menggunakan salah satu metode berikut:

• Instal di chat: Beri tahu OpenClaw di chat untuk menginstal Skill yang Anda butuhkan, dan Skill tersebut akan diinstal secara otomatis.

• Instal melalui URL: Kirim URL Skill ke OpenClaw, dan Skill tersebut akan diinstal secara otomatis.

• Instal dari ClawHub: Jalankan perintah clawhub install <skill-name> untuk menginstal Skill dari marketplace skill.

Untuk langkah instalasi terperinci, lihat Cara menginstal atau menambahkan Skill di OpenClaw.

Tambah atau instal skill di OpenClaw

Anda dapat menambahkan skill ke OpenClaw dengan tiga cara: pembuatan interaktif, instalasi dari URL, dan instalasi dari sumber mirror.

• Pembuatan interaktif (untuk skill baru)

  OpenClaw memiliki komponen bawaan Skill Creator. Anda dapat berchat dengan Skill Creator, menjelaskan kebutuhan Anda, dan Skill Creator akan secara otomatis membuat skill baru.

• Instal dari URL (untuk menggunakan kembali skill yang ada)

  Untuk menginstal skill yang ada, kirim URL-nya ke OpenClaw untuk instalasi otomatis. Misalnya, untuk menginstal Web Artifacts Builder dari Anthropic, cukup beri tahu agent untuk menginstal skill tersebut selama percakapan Anda.

• Instal dari sumber mirror (untuk skenario dengan pembatasan jaringan)

  Jika lingkungan server Anda tidak dapat mengakses repositori kode eksternal seperti GitHub karena pembatasan jaringan, Anda dapat menggunakan metode mirroring.

  1. Unduh file ke mesin lokal.

  2. Unggah kode ke ruang penyimpanan yang dapat diakses (misalnya, unggah ke OSS).

  3. Dapatkan tautan unduhan baru dan kirim ke OpenClaw untuk instalasi, mengikuti prosedur yang sama seperti menginstal dari URL.

Pemuatan skill kustom dan prioritas

Ya. Di ~/.openclaw/openclaw.json, gunakan skills.load.extraDirs untuk menambahkan direktori tambahan dengan prioritas pemuatan terendah.

OpenClaw memuat skill dalam urutan prioritas berikut, dari tertinggi ke terendah: <workspace>/skills > ~/.openclaw/skills > bawaan > skills.load.extraDirs.

Secara default, clawhub menginstal ke ./skills, yang OpenClaw perlakukan sebagai <workspace>/skills.

Instal skill dari ClawHub

ClawHub adalah marketplace skill khusus untuk mencari, menginstal, dan mengelola skill pihak ketiga.

• Cari skill (misalnya, cuaca):

  clawhub search weather

• Instal skill:

  clawhub install weather

• Lihat lebih banyak perintah:

  clawhub --help

ClawHub menawarkan mirror resmi China. Mirror ini menyediakan akses lebih cepat ke skill agent yang dapat digunakan kembali dengan terus-menerus mengindeks dan mempercepat skill komunitas berkualitas tinggi. Untuk detail dan instruksi penggunaan, lihat mirror ClawHub China.

Situs mirror ClawHub China

ClawHub menawarkan situs mirror resmi China yang mengkurasi dan mencerminkan Skill komunitas berkualitas tinggi. Situs ini menyediakan akses lebih cepat ke Skill Agent yang dapat digunakan kembali bagi pengguna di daratan Tiongkok.

Kasus penggunaan: Jika Simple Application Server Anda dideploy di wilayah daratan Tiongkok, Anda mungkin mengalami latensi tinggi atau unduhan lambat saat mengunduh Skill dari sumber default. Gunakan situs mirror ClawHub China untuk mempercepat unduhan.

Prosedur:

1. Buka situs mirror ClawHub China untuk menelusuri atau mencari Skill.

2. Temukan Skill yang diinginkan dan salin URL instalasinya dari situs mirror.

3. Di chat OpenClaw, kirim URL instalasi ke Agent. Agent secara otomatis menginstal Skill tersebut.

Situs mirror ClawHub China berisi konten yang sama dengan sumber ClawHub default. Satu-satunya perbedaan adalah node unduhannya berlokasi di daratan Tiongkok untuk menyediakan akses jaringan yang lebih cepat. Pengguna di luar daratan Tiongkok dapat menggunakan sumber default.

Atasi unduhan Skill yang lambat

Menginstal Skill pada instans Simple Application Server di wilayah daratan Tiongkok bisa lambat atau timeout. Hal ini karena sumber daya Skill default dihosting di node luar negeri, yang menyebabkan latensi jaringan tinggi.

Solusi:

• Gunakan situs mirror ClawHub China: Kunjungi situs mirror ClawHub China untuk mendapatkan URL mirror Skill dan unduh lebih cepat dari node domestik. Untuk detail, lihat Cara menggunakan situs mirror ClawHub China.

• Gunakan sumber perantara untuk instalasi: Jika Anda tidak dapat mengakses repositori kode eksternal seperti GitHub, unduh file Skill, unggah ke ruang penyimpanan yang dapat diakses (seperti OSS), lalu gunakan URL baru untuk menginstal Skill di OpenClaw. Untuk detail, lihat bagian instalasi sumber perantara di Tambah atau instal Skill.

Restart OpenClaw Gateway

openclaw gateway restart

Konfigurasi Brave Search

Fitur pencarian web Brave Search hanya tersedia untuk instans Simple Application Server di wilayah di luar daratan Tiongkok, termasuk China (Hong Kong).

Gambar aplikasi OpenClaw, versi 2026.2.3 dan setelahnya, mencakup Skill pencarian web berbasis SearXNG secara default.

1. Buka website resmi Brave Search untuk membuat akun Brave Search API dan menghasilkan Kunci API.

2. Untuk mengonfigurasi ini dalam image, buka halaman OpenClaw. Di panel navigasi kiri, klik untuk membuka file konfigurasi. Ubah BRAVE_API_KEY menjadi Kunci API Brave Search Anda, copy blok kode berikut, lalu tempelkan ke lokasi konfigurasi tools.web.search.

     "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
         }
       }
     },

   Di panel navigasi kiri, buka Config > All Settings > Raw, lalu tempelkan blok kode tersebut ke bagian tools.web.search. Klik Save di pojok kanan atas.

Search coverage for Chinese platforms

Iya, tetapi cakupan pencarian bervariasi tergantung pada platformnya.

Fitur pencarian web di OpenClaw bergantung pada mesin pencari yang mendasarinya. Secara default, OpenClaw menggunakan SearXNG, mesin metapencarian sumber terbuka yang mengambil hasil dari multiple sumber. Anda juga dapat mengonfigurasi Brave Search. Cakupan hasil pencarian Anda bergantung pada konten yang telah diindeks oleh mesin pencari yang mendasarinya:

• Public web content indexed by Baidu: Umumnya dapat dicari.

• Content within closed platforms, such as WeChat Official Account articles or Zhihu answers: Cakupan mesin pencari mungkin tidak lengkap, dan beberapa konten mungkin tidak dapat diakses secara langsung.

Untuk cakupan pencarian yang lebih luas, Anda juga dapat mengonfigurasi Brave Search. Untuk petunjuknya, lihat How to configure the Brave Search web search feature for OpenClaw.

Run tools in a Docker container

OpenClaw memungkinkan Anda menjalankan tools dalam sebuah Docker container untuk mengurangi risiko keamanan. Ini merupakan fitur opsional. Saat diaktifkan, OpenClaw mengeksekusi tools dalam lingkungan sandbox yang terisolasi. Untuk instruksi konfigurasi, lihat panduan fitur sandboxing OpenClaw.

OpenClaw CLI

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

Effects of console initialization

Tidak. Inisialisasi di Konsol atau mengonfigurasi ulang Kunci API tidak menghapus Skill yang telah terpasang, memori, riwayat percakapan, atau data Pelatihan. Operasi ini hanya mereset konfigurasi koneksi model.

Data persistence on restart

Tidak. Restart tidak menyebabkan kehilangan data. Konfigurasi dan skill Anda disimpan dalam direktori ~/.openclaw dan tetap utuh kecuali Anda melakukan reset sistem atau menghapus direktori ini.

Multiple sessions after integration

Ya, hal ini diharapkan. Mengintegrasikan channel seperti Lark atau DingTalk secara otomatis membuat session yang sesuai. Anda dapat menghapus session tersebut secara manual dari antarmuka web. Namun, menghapus session akan mencegah Anda menerima pesan dari channel tersebut.

Cluster deployment

OpenClaw diterapkan pada Simple Application Server menggunakan gambar aplikasi. Setiap instans berjalan sebagai layanan mandiri dan tidak dapat diklusterkan untuk management terpusat.

Untuk meningkatkan skalabilitas layanan Anda, Anda dapat membeli beberapa instans Simple Application Server dan menerapkan OpenClaw pada masing-masing instans tersebut. Setiap instans berjalan dan dikelola secara independen.

Menggunakan OpenClaw di Model Studio di Singapura hanya dengan kuota gratis

Selain kuota gratis, Anda akan dikenai biaya untuk penggunaan model di Model Studio (Singapura). Untuk mencegah biaya tersebut, buka platform Model Studio dan aktifkan Stop when free quota is exhausted. Setelah fitur ini diaktifkan, model tersebut tidak akan tersedia begitu kuota gratisnya habis. Anda kemudian dapat beralih ke model lain yang masih memiliki kuota gratis.

Mengonfigurasi fitur Free Quota Only

Secara default, Anda dikenai biaya untuk penggunaan apa pun yang melebihi kuota gratis Anda. Ketika fitur Free Quota Only diaktifkan, panggilan API akan gagal dengan error AllocationQuota.FreeTierOnly setelah kuota gratis habis, sehingga mencegah timbulnya biaya tak terduga.

Konfigurasikan Model Studio Coding Plan

1. Salin dan simpan kunci API serta URL dasar Anda dari Langkah 2: Dapatkan kunci API dan URL dasar eksklusif paket.

2. Ganti placeholder YOUR_API_KEY pada blok kode berikut dengan kunci API yang Anda peroleh di Langkah 2: Dapatkan kunci API dan URL dasar eksklusif paket.

   "models": {"mode": "merge","providers": {"bailian": {"baseUrl": "https://coding.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": false,"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}}},

   "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": false,"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. Pada halaman Konsol Simple Application Server - Servers, klik ID instans pada kartu server OpenClaw untuk membuka halaman Server Overview.

4. Klik tab Application Details. Pada halaman Access Control page, klik Run Command di samping URL website. Di jendela pop-up, klik URL tersebut untuk membuka halaman chat OpenClaw.

5. Klik untuk membuka file konfigurasi. Salin blok kode yang telah dimodifikasi parameter "apiKey"-nya, ganti konten asli "agents"{...} dalam kode konfigurasi Anda, lalu simpan perubahan Anda.

Ubah model default menjadi qwen3.6-plus

Plan Lite tidak mendukung qwen3.6-plus.

Pada image OpenClaw 2026.4.14 dan versi yang lebih baru, Anda dapat memilih qwen3.6-plus langsung dari menu drop-down model di halaman detail aplikasi di Konsol. Untuk image versi sebelumnya, konfigurasikan model secara manual:

1. Di UI web OpenClaw, pilih Configuration > RAW dari bilah menu kiri.

2. Pada bagian models.providers.dashscope-coding.models, tambahkan konfigurasi model berikut untuk qwen3.6-plus:

   {
     "id": "qwen3.6-plus",
     "name": "Qwen3.6-Plus",
     "api": "openai-completions",
     "reasoning": false,
     "input": ["text", "image"],
     "cost": {
       "input": 0,
       "output": 0,
       "cacheRead": 0,
       "cacheWrite": 0
     },
     "contextWindow": 1000000,
     "maxTokens": 65536
   }

3. Ubah parameter agents.defaults.model.primary menjadi dashscope-coding/qwen3.6-plus.

4. Klik Save lalu Update.

Server configuration requirements

Untuk memastikan kinerja layanan, server Anda harus memiliki minimal 2 vCPU dan memori 2 GB.

Biaya tambahan

Jika Anda menggunakan kunci API Model Studio untuk pemanggilan model pada instans Anda, Anda akan dikenai biaya berdasarkan token usage. Untuk detail penagihan, lihat Model Invocation Billing.

penagihan OpenClaw API

Simple Application Server menggunakan penagihan berbasis paket. Biaya paket Anda mencakup sumber daya komputasi, penyimpanan, dan bandwidth. Memanggil operasi OpenAPI Simple Application Server, seperti mengkueri informasi instans atau mengelola aturan firewall, tidak dikenai biaya tambahan.

Memanggil model tingkat tinggi, seperti model dari platform Model Studio, melalui OpenClaw akan dikenai biaya pemanggilan model. Biaya tersebut didasarkan pada token usage dan ditagih secara terpisah dari biaya paket Simple Application Server Anda.

Periksa kuota gratis model di Singapura menggunakan Model Studio

Masuk ke Konsol Model Studio. Di bagian Free Quota, Anda dapat melihat sisa kuota model Anda.

Statistik pemanggilan model

Apa perbedaan antara wilayah Model Studio Singapura, AS (Virginia), dan China (Beijing)?

Alibaba Cloud Model Studio tersedia di wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing). Pilih wilayah terdekat untuk mengurangi latensi jaringan. Titik akhir layanan (Endpoint/Base URL) dan kunci API bersifat spesifik per wilayah. Model yang didukung, fitur platform, dan harga juga bervariasi menurut wilayah. Untuk informasi selengkapnya, lihat Pilih model.

Penggunaan API cross-region

Ya. Simple Application Server di wilayah luar negeri dapat memanggil layanan model Model Studio di wilayah China (Beijing). Namun, latensi jaringan cross-region akan meningkatkan waktu respons secara signifikan.

Penggunaan Lintas Wilayah

Ya. Langganan Coding Plan berlaku secara global dan tidak dibatasi oleh Wilayah Simple Application Server Anda. Misalnya, jika Anda membeli Coding Plan di Wilayah Tiongkok Utara, Simple Application Server di wilayah lain—seperti Amerika Serikat dan Singapura—dapat menggunakan kunci API eksklusif dari paket tersebut untuk memanggil model. Anda tidak perlu membeli ulang paket tersebut untuk setiap wilayah server.

Mengelola file

Saat Anda menggunakan OpenClaw, agen menyimpan file yang dihasilkan—seperti kode, laporan, atau gambar—di direktori /home/admin/.openclaw/ secara default.

Menemukan file yang dihasilkan:

• Di terminal, gunakan perintah ls untuk menampilkan daftar file di direktori saat ini.

• Gunakan perintah find / -name "filename" untuk mencari file tersebut di seluruh instans.

• Anda juga dapat menanyakan jalur file tersebut kepada agen melalui chat OpenClaw.

Mengunggah dan mengunduh file:

Anda dapat mengunggah dan mengunduh file menggunakan fitur manajemen file di Workbench. Untuk detailnya, lihat Upload or Download Files via Workbench.

Memecahkan masalah chat OpenClaw yang tidak responsif

1. Verifikasi konfigurasi kunci API Anda: Lakukan koneksi jarak jauh ke instans Simple Application Server Anda. Pada blok kode berikut, ganti placeholder dengan kunci API dan URL dasar untuk wilayah Anda. Jalankan perintah tersebut di terminal Anda untuk menguji panggilan API. Jika muncul error, cari kode kesalahan tersebut dalam dokumentasi error code dan ikuti solusi yang direkomendasikan. URL dasar bersifat spesifik per wilayah dan tidak dapat saling dipertukarkan:

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

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

   • Singapore: 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_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 adanya pembayaran tertunda atau pembatasan laju.

   1. Coding Plan: Paket ini memiliki batas permintaan harian (5 jam), mingguan, dan bulanan. Anda dapat memeriksa penggunaan kuota di Coding Plan console. Melebihi batas tersebut akan memicu error hour/week/month allocated quota exceeded.

      Solusi: Tunggu hingga kuota direset secara otomatis.

   2. Untuk kunci API Model Studio dengan skema pay-as-you-go:

      1. Untuk memeriksa kuota gratis Anda, masuk ke Model Studio console. Bagian Free Quota menampilkan sisa kuota untuk model tersebut.

      2. Untuk memeriksa adanya pembayaran tertunda, kunjungi pusat Biaya dan Pengeluaran dan pastikan akun Anda tidak memiliki saldo tagihan yang belum diselesaikan.

3. Periksa log error: Buka halaman OpenClaw Chat. Di panel navigasi kiri, klik Logs, lalu centang kotak WARN dan ERROR untuk melihat log error. Cari error tersebut dalam FAQ OpenClaw untuk menemukan solusinya.

   Jika log tidak menunjukkan error apa pun, restart gateway dari Konsol.

4. Reset gambar

   Jika server tidak berisi data penting, Anda dapat mereset gambar Simple Application Server ke gambar aplikasi OpenClaw terbaru dan mengonfigurasi ulang layanan tersebut.

   Penting

   Operasi Reset System akan menginstal ulang sistem operasi dan menghapus semua data dari disk sistem, termasuk konfigurasi yang tersimpan, log, dan database. Sebelum melanjutkan, Anda harus mencadangkan data penting. Kami menyarankan membuat Snapshot atau mengekspor data ke perangkat lokal. Untuk mempertahankan data ruang kerja OpenClaw Anda—seperti memori, konfigurasi identitas, dan Skills—lihat Backup dan pemulihan data untuk peningkatan OpenClaw.

OpenClaw: HTTP 400 kesalahan panjang input

Kesalahan ini terjadi ketika konteks yang terakumulasi dalam sebuah percakapan melebihi batas input model. Untuk mengatasi masalah ini, jalankan perintah /new di halaman percakapan OpenClaw untuk memulai percakapan baru.

Perintah 'openclaw skills list' gagal menampilkan daftar skill yang terinstal

Jika menjalankan openclaw skills list mengembalikan daftar kosong atau gagal menampilkan skill yang diharapkan, hal ini biasanya disebabkan oleh salah satu alasan berikut:

• Direktori saat ini berada di luar ruang kerja: Perintah openclaw skills list hanya memindai direktori skills di dalam ruang kerja saat ini dan direktori ~/.openclaw/skills. Jika Anda menjalankan perintah tersebut dari direktori lain, skill yang terinstal tidak akan terdeteksi. Pindahlah ke direktori root ruang kerja OpenClaw, lalu jalankan kembali perintah tersebut.

• Skill diinstal ke path yang berbeda: Secara default, clawhub install menginstal skill ke direktori ./skills di dalam direktori saat ini. Jika Anda menjalankan instalasi dari direktori selain ruang kerja OpenClaw, openclaw skills list tidak dapat menemukan skill tersebut. Pastikan path instalasi adalah ruang kerja OpenClaw Anda, atau copy direktori skill tersebut ke direktori ~/.openclaw/skills.

• Versi gambar aplikasi sudah usang: Instance yang dibuat sebelum 30 Januari 2026 mungkin tidak memiliki tool CLI clawhub atau subperintah openclaw skills yang telah dipra-instal. Dalam kasus ini, Anda harus mengatur ulang gambar aplikasi saat ini ke versi terbaru.

Langkah Verifikasi:

1. Pindah ke direktori root ruang kerja OpenClaw:

   cd ~/.openclaw

2. Verifikasi bahwa direktori skills ada dan berisi skill Anda:

   ls skills/

3. Jalankan kembali perintah daftar skill:

   openclaw skills list

Untuk menginstal skill baru dari pasar skill, gunakan clawhub search untuk mencari skill baru dan clawhub install untuk menginstalnya. Untuk petunjuk lengkap, lihat Instal skill dari ClawHub.

Restart the OpenClaw gateway

Jika koneksi terputus atau layanan menjadi tidak tersedia, restart OpenClaw gateway di Konsol. Buka Application Details > Basic Configuration > Restart OpenClaw Gateway dan klik Restart Server.

Error HTTP 401 di OpenClaw

Error ini biasanya terjadi jika langkah inisialisasi pada halaman detail aplikasi gagal, Anda tidak memasukkan API Key, Anda memasukkan API Key pihak ketiga (bukan dari Model Studio), atau wilayah yang Anda pilih tidak sesuai dengan wilayah API Key tersebut.

Solusi:

1. Di Konsol Simple Application Server, buka halaman Application Details untuk instans tersebut dan konfigurasi ulang API Key Model Studio atau Coding Plan pada langkah inisialisasi.

2. Restart gerbang OpenClaw.

3. Akses alamat WebUI terbaru dan pastikan error telah terselesaikan.

Kegagalan menyimpan konfigurasi

Jika Anda tidak dapat menyimpan perubahan atau melihat nilai yang sudah usang setelah mengubah kunci API atau konfigurasi model pada halaman detail aplikasi di Konsol, gunakan skenario berikut untuk pemecahan masalah.

Skenario 1: Konfigurasi model pihak ketiga menampilkan nilai lama di Konsol

Halaman detail aplikasi di Konsol Simple Application Server hanya dapat menampilkan dan memodifikasi model dari Alibaba Cloud Model Studio. Halaman ini tidak menampilkan atau mengizinkan perubahan pada model pihak ketiga, seperti DeepSeek atau MiniMax. Jika Anda telah mengintegrasikan model pihak ketiga dengan menggunakan file konfigurasi ~/.openclaw/openclaw.json di server, perilaku ini merupakan hal yang diharapkan, dan Konsol akan terus menampilkan konfigurasi Model Studio.

Untuk mengubah kunci API model pihak ketiga, edit langsung file konfigurasi di server. Setelah menyimpan perubahan, jalankan openclaw gateway restart untuk menerapkan konfigurasi baru.

Skenario 2: Terjadi error saat menyimpan kunci API Model Studio di Konsol

Jika terjadi error saat Anda menyimpan kunci API Model Studio di Konsol, ikuti langkah-langkah berikut untuk memecahkan masalah:

1. Verifikasi format kunci API: Kunci API untuk Model Studio biasanya diawali dengan sk-, sedangkan kunci API Coding Plan diawali dengan sk-sp-. Saat menempelkan kunci, pastikan tidak ada spasi atau karakter baris baru di awal maupun akhir.

2. Pastikan wilayah yang dipilih benar: Kunci API harus sesuai dengan wilayah yang dipilih. Misalnya, kunci untuk wilayah Beijing hanya dapat digunakan di Beijing, bukan di wilayah Singapura atau Virginia.

3. Periksa konektivitas jaringan Anda: Jika Anda melihat timeout permintaan atau error jaringan di developer tools browser, coba muat ulang halaman dan simpan konfigurasi kembali.

4. Verifikasi bahwa kunci API masih valid: Buka halaman Coding Plan untuk memastikan kunci tersebut masih berlaku.

Skenario 3: Perubahan pada file konfigurasi tidak berlaku

Setelah mengubah file ~/.openclaw/openclaw.json, Anda harus melakukan restart gateway agar perubahan diterapkan:

openclaw gateway restart

Setelah gateway direstart, jalankan perintah berikut untuk memverifikasi bahwa konfigurasi baru telah dimuat:

openclaw models list

Jika daftar tersebut menampilkan konfigurasi model yang telah diperbarui, berarti perubahan telah berhasil diterapkan.

OpenClaw browser tool issues

Pesan error-nya adalah:

error [tools] browser failed: timed out. Restart the OpenClaw gateway (OpenClaw.app menubar, or 'openclaw gateway'). Do NOT retry the browser tool — it will keep failing. Use an alternative approach or inform the user that the browser is currently unavailable.

Untuk mengatasi error ini, restart the OpenClaw gateway.

Instalasi skill diblokir

Antarmuka management OpenClaw menyediakan instalasi satu klik untuk beberapa skill. Namun, sebagian besar skill bergantung pada Homebrew, sehingga tidak mendukung instalasi satu klik. Untuk menggunakan skill tersebut, instal Homebrew pada server Anda, lalu instal dan konfigurasikan skill-nya.

Galat "Disconnected (1008): unauthorized"

Galat ini menunjukkan bahwa token otentikasi tidak ada dalam URL akses Anda. Konsol Web OpenClaw melarang akses langsung melalui alamat IP dan mengharuskan penggunaan URL yang berisi token otentikasi yang valid. Untuk mendapatkan URL akses yang benar, buka server console, lalu klik ID instans pada kartu server untuk membuka halaman ikhtisar server. Klik tab Application Details. Pada halaman access control page, klik Run Command untuk mengambil URL akses yang benar.

Atasi error "control ui requires device identity"

Login ke server dan ubah parameter dangerouslyDisableDeviceAuth dalam file konfigurasi OpenClaw untuk menonaktifkan verifikasi identitas perangkat.

1. Login ke Simple Application Server console. Pada halaman Servers, temukan kartu server target lalu klik Remote Connection. Di bagian Connect with One-click on Workbench, klik Log on Now.

2. Jalankan perintah berikut untuk mengedit file konfigurasi OpenClaw.

   vim ~/.openclaw/openclaw.json

3. Pada konfigurasi gateway, cari "dangerouslyDisableDeviceAuth": false lalu ubah nilai false menjadi true. Setelah itu, simpan file dan keluar.

4. Jalankan perintah berikut untuk restart layanan Gateway agar perubahan diterapkan.

   openclaw gateway restart

Atasi error "disconnected (1006): no reason"

Ikuti langkah-langkah berikut untuk memecahkan masalah ini:

1. Buat ulang token: Masuk ke Konsol Alibaba Cloud Simple Application Server, temukan instans tersebut, lalu buka halaman detail aplikasi untuk membuat ulang token.

2. Gunakan token baru untuk mengakses aplikasi: Tambahkan token baru ke URL akses dalam format http://<public IP address>:<port>/?token=<newly-generated-token> (gunakan port dari URL akses yang ditampilkan di Konsol), lalu uji URL tersebut di jendela penyamaran (incognito).

3. Konfirmasi status layanan: Hubungkan ke server menggunakan SSH dan pastikan layanan OpenClaw sedang berjalan.

4. Periksa aturan firewall: Pastikan firewall pada instans Simple Application Server Anda mengizinkan traffic TCP inbound pada port yang digunakan untuk listening.

   Koneksi WebSocket juga dapat gagal karena binding alamat IP publik yang salah atau konfigurasi reverse proxy yang tidak tepat. Pertama-tama, uji konektivitas dari mesin lokal Anda menggunakan curl atau telnet.

Atasi error "origin not allowed"

Menggunakan nama domain kustom alih-alih alamat IP untuk mengakses OpenClaw Web UI dapat menyebabkan error berikut: origin not allowed (open the Control UI from the gateway host or allow it in gateway.controlUi.allowedOrigins).

Penyebab: Secara default, gerbang OpenClaw hanya mengizinkan akses Web UI dari alamat IP server. Saat Anda mengakses UI menggunakan nama domain, gerbang memblokir permintaan tersebut karena origin-nya tidak ada dalam daftar izin.

Login ke server untuk mengubah file konfigurasi OpenClaw, openclaw.json, dan tambahkan nama domain ke parameter allowedOrigins.

1. Login ke Simple Application Server console. Di daftar server, temukan server target lalu klik Remote Connection pada kartunya. Di bagian Connect with One-click on Workbench, klik Log on Now.

2. Pada file konfigurasi OpenClaw, cari bidang allowedOrigins dan tambahkan URL akses lengkap nama domain Anda.

   "allowedOrigins": [
     "http://47.**.**.59:15386",
     "http://openclaw-us.hewushui.cn:15386"
   ]

   Ganti alamat contoh dengan protokol, nama domain atau alamat IP, serta Port aktual Anda.

3. Setelah menyimpan file, restart the OpenClaw gateway untuk menerapkan perubahan.

Atasi Masalah Akses Web UI OpenClaw

Jika Anda tidak dapat mengakses Web UI OpenClaw, masuk ke Konsol Simple Application Server dan periksa hal-hal berikut:

1. Buka port untuk OpenClaw: Di daftar server, temukan server target lalu klik Manage OpenClaw. Pada bagian OpenClaw Usage Steps, di tab Allow Port Access, klik One-Click Enable.

   Jika Anda telah mereset image, Anda harus melakukan inisialisasi ulang server untuk mendapatkan URL Web UI yang baru.

2. Verifikasi file konfigurasi: Kembali ke daftar server dan klik Remote Connection pada server target. Di bagian Connect with One-click on Workbench, klik Log on Now. Jalankan perintah berikut:

   openclaw doctor --fix

   Perintah ini secara otomatis menghapus bidang yang tidak didukung, seperti allowlist, dari openclaw.json.

3. Setelah perintah selesai, restart gerbang OpenClaw untuk menerapkan konfigurasi baru.

Atasi error "401 Unauthorized"

Saat Anda menggunakan model dari Alibaba Cloud Model Studio, Anda mungkin menerima error berikut: Failed to discover Alibaba Cloud models: 401 Unauthorized.

Kemungkinan penyebab: Error 401 biasanya terjadi karena kunci API salah, ketidaksesuaian antara wilayah kunci API dan URL dasar permintaan, atau izin pemanggilan yang tidak mencukupi untuk ruang kerja atau akun tersebut.

Pemecahan masalah dan solusi:

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": "You are a helpful assistant."
        },
        {
            "role": "user", 
            "content": "Who are you?"
        }
    ]
}'

error "openclaw: command not found"

Jalankan perintah berikut untuk membuat tautan simbolik:

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

Tidak dapat mengambil token setelah mengaktifkan Tailscale

Masalah ini terjadi karena Tailscale memodifikasi kebijakan perutean. Untuk mengambil token, jalankan perintah berikut:

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-nya.

Ketidakaksesan jaringan publik OpenClaw

Layanan OpenClaw tidak dapat diakses dari jaringan publik karena Port 18789 sedang mendengarkan pada 127.0.0.1.

Kemungkinan penyebab: Parameter bind dalam file konfigurasi OpenClaw kemungkinan telah dimodifikasi. Secara default, parameter ini diatur ke lan, yang memungkinkan akses dari jaringan publik. Jika parameter ini diubah menjadi loopback dan layanan direstart, Port tersebut hanya akan mendengarkan pada alamat loopback lokal 127.0.0.1.

Solusi:

1. Login ke server dan periksa konfigurasi. Login ke Simple Application Server Anda sebagai pengguna admin dan jalankan perintah berikut untuk memeriksa konfigurasi saat ini dari parameter bind:

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

2. Modifikasi file konfigurasi. Periksa output perintah tersebut. Jika hasilnya adalah "bind": "loopback", edit file konfigurasi dan ubah kembali parameter tersebut ke nilai default-nya, yaitu "lan".

3. Restart layanan gateway. Setelah mengubah dan menyimpan file konfigurasi, jalankan perintah berikut untuk merestart layanan gateway:

   openclaw gateway restart

   Setelah restart, layanan akan dapat diakses dari jaringan publik.

Error pada openclaw gateway restart

Saat Anda mencoba me-restart layanan gateway, perintah openclaw gateway restart menghasilkan error, dan layanan gagal dijalankan kembali.

Solusi: Jika perintah restart gagal, Anda dapat memulihkan layanan dengan menghentikan proses secara manual lalu menjalankannya kembali. Ikuti langkah-langkah berikut:

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

2. Hentikan proses yang sedang berjalan. Untuk menghentikan proses openclaw-gateway, jalankan perintah berikut:

   killall openclaw-gateway

3. Restart layanan. Kemudian, jalankan perintah berikut untuk menjalankan kembali layanan gateway:

   openclaw gateway start

   Catatan: Anda dapat mengabaikan pesan error apa pun dari perintah ini.

4. Verifikasi status layanan. Setelah menjalankan perintah start, jalankan perintah ps aux | grep gate untuk memeriksa apakah proses openclaw-gateway telah berhasil dijalankan, dan jalankan perintah netstat -nltp untuk memastikan bahwa Port terkait berada dalam status listening.

Sering terjadi downtime, kehabisan memori, atau pemicu OOM Killer

• Upgrade konfigurasi instans
  Kami menyarankan Anda upgrade konfigurasi instans menjadi minimal 2 vCPU dan 2 GB memori untuk meningkatkan stabilitas OpenClaw serta mengurangi masalah seperti downtime server, website tidak dapat diakses, dan kehabisan memori.
  
  

• Periksa dan tambahkan partisi swap
  Secara default, gambar aplikasi OpenClaw yang dirilis pada atau setelah 26 Februari 2026 telah menyertakan partisi swap. Jika instans Anda menggunakan gambar aplikasi versi sebelumnya, Anda dapat mengonfigurasi partisi swap secara manual atau mengatur ulang gambar aplikasi saat ini ke versi terbaru. Partisi swap berfungsi sebagai buffer saat memori rendah, sehingga mengurangi pemicu OOM Killer dan downtime.
  
  

Beralih dari Coding Plan ke Token Plan

Langkah-langkah:

1. Buka Konsol Model Studio dan berlangganan edisi tim Token Plan.

2. Ikuti petunjuk dalam Cara mengintegrasikan edisi tim Token Plan Model Studio dengan OpenClaw untuk mengonfigurasi Token Plan Anda.

3. Setelah konfigurasi selesai, OpenClaw secara otomatis menggunakan model Token Plan untuk percakapan.

Mengintegrasikan Paket Token (Tim) Model Studio dengan OpenClaw

Token Plan Team Edition adalah langganan bulanan dengan kuota token bersama yang memungkinkan tim mengakses berbagai model, seperti qwen3.7-max, qwen3.6-plus, deepseek-v4-pro, kimi-k2.6, glm-5.1, dan MiniMax-M2.5. Setelah diintegrasikan dengan OpenClaw, Anda dapat menggunakan model-model ini dalam percakapan.

Prosedur

1. Pastikan Anda telah berlangganan Token Plan Team Edition.

Modifikasi file konfigurasi:

Mematikan dan riwayat chat

Tidak. Mematikan (menghentikan) instans Simple Application Server tidak menghapus riwayat chat OpenClaw. Riwayat chat disimpan di disk instans tersebut. Namun, OpenClaw tidak tersedia selama instans dalam keadaan dimatikan. Anda harus melakukan restart instans untuk mengakses OpenClaw dan memulai percakapan baru.

Operasi berikut akan menghapus riwayat chat:

• Reset system: Mengatur ulang sistem sama dengan menginstal ulang sistem operasi. Operasi ini menghapus semua data pada disk sistem, termasuk riwayat chat OpenClaw, konfigurasi, dan database. Untuk menyimpan data ruang kerja OpenClaw (seperti memori, konfigurasi identitas, dan Skills), lihat Back up and restore data for OpenClaw upgrades sebelum Anda melakukan reset system.

• Release instance: Melepas instans Simple Application Server akan menghapus instans tersebut secara permanen beserta seluruh datanya, termasuk riwayat chat.

Persyaratan Sumber Daya dan Koeksistensi

• Resource requirements: Untuk memastikan OpenClaw berjalan secara stabil, instans Simple Application Server Anda harus memiliki setidaknya 2 vCPU dan memori 2 GB. Memori yang tidak mencukupi pada instans dengan spesifikasi lebih rendah dapat memicu OOM Killer, sehingga menyebabkan gangguan layanan.

• Swap partition: Image yang dirilis pada atau setelah 26 Februari 2026 telah menyertakan swap partition secara default. Untuk mengurangi tekanan memori pada image lama, konfigurasikan swap partition secara manual atau reset instans Anda ke image terbaru.

• Coexistence risk: Kami tidak menyarankan men-deploy OpenClaw dan agen lain, seperti Hermes, pada server ber-spek rendah yang sama. Hal ini dapat menyebabkan resource contention, penurunan performa, atau konflik fungsional. Kami menyarankan men-deploy setiap agen pada instans terpisah.

Menyiapkan OpenClaw untuk keluarga atau teman

Ya. Setiap instans OpenClaw memerlukan Simple Application Server khusus dan tidak dapat dibagikan oleh banyak pengguna. Untuk menyiapkan OpenClaw bagi keluarga atau teman, Anda harus membeli Simple Application Server baru dan melalui seluruh proses penerapan sekali lagi.

Ikuti langkah-langkah berikut:

1. Beli Simple Application Server baru dan pilih image OpenClaw.

2. Ikuti tutorial penerapan untuk menyelesaikan semua langkah, termasuk konfigurasi API Key dan integrasi dengan platform IM (seperti DingTalk, Lark, atau WeCom).

3. Setiap server dikonfigurasi secara independen, sehingga perubahan pada satu instans tidak memengaruhi instans lainnya.