Hubungkan OpenClaw untuk menggunakan model - Alibaba Cloud Model Studio

OpenClaw adalah platform asisten AI pribadi open source yang mendukung interaksi AI melalui berbagai saluran perpesanan. Konfigurasikan agar terintegrasi dengan model seri Qwen dari Alibaba Cloud Model Studio.

Catatan

OpenClaw sebelumnya dikenal sebagai Moltbot/Clawdbot, dan beberapa perintah mungkin belum sepenuhnya dimigrasikan. Jika Anda menemui error command not found: openclaw saat menggunakan perintah baru (misalnya openclaw dashboard), gunakan kembali perintah lama (misalnya clawdbot dashboard atau moltbot dashboard) untuk menjalankan operasi tersebut.

Dukungan dan Pemilihan Model

OpenClaw mendukung model generasi teks Alibaba Cloud Model Studio melalui antarmuka yang kompatibel dengan OpenAI. Daftar model yang didukung adalah sebagai berikut:

Generasi Teks - Qwen	Qwen Max、Qwen Plus、Qwen Flash、Qwen Coder
Generasi Teks - Qwen - Open Source	Qwen3、QwQ-Open Source、QwQ-Preview、Qwen2.5、Qwen-Coder
Generasi Teks - Model Pihak Ketiga	DeepSeek、Kimi、GLM

Model generasi teks pihak ketiga hanya tersedia di wilayah China (Beijing). Gunakan Base URL dan API Key untuk wilayah China (Beijing). Untuk informasi lebih lanjut, lihat Konfigurasi Model Alibaba Cloud Model Studio

Jika Anda sering menggunakan OpenClaw atau ingin mengurangi biaya, berlangganan salah satu paket berikut:

Ikhtisar Paket Coding: Paket langganan bulanan tetap yang menyediakan hingga 90.000 permintaan per bulan, cocok untuk kebutuhan coding yang sering.

Langkah-Langkah Konfigurasi

1. Aktifkan Alibaba Cloud Model Studio

Buat akun: Jika Anda belum memiliki Akun Alibaba Cloud, pertama-tama buat akun.
Jika mengalami masalah, lihat Buat Akun Alibaba Cloud.
Aktifkan Alibaba Cloud Model Studio: Gunakan Akun Alibaba Cloud Anda untuk membuka platform Alibaba Cloud Model Studio. Setelah membaca dan menyetujui Ketentuan Layanan, Alibaba Cloud Model Studio akan diaktifkan secara otomatis. Jika Ketentuan Layanan tidak muncul, artinya Anda telah mengaktifkannya sebelumnya.
Jika muncul pesan "Anda belum menyelesaikan verifikasi identitas" saat mengaktifkan layanan, pertama-tama selesaikan verifikasi identitas.

Setelah mengaktifkan Alibaba Cloud Model Studio untuk pertama kali, klaim kuota gratis pengguna baru (berlaku selama 90 hari setelah aktivasi) untuk layanan inferensi model. Untuk detail cara mengklaim kuota gratis, lihat halaman Kuota Gratis Pengguna Baru.

Catatan

Melebihi kuota atau periode validitas akan dikenakan biaya. Aktifkan fitur batas pengeluaran untuk menghindari biaya dalam situasi ini. Rujuk penawaran aktual dan tagihan akhir di Konsol untuk biaya spesifik.

2. Instal OpenClaw

Persyaratan Lingkungan

OpenClaw memerlukan Node.js 22 atau versi yang lebih baru. Periksa versi Node.js Anda menggunakan perintah berikut:

node --version

Jika Node.js belum terinstal atau versinya terlalu rendah, kunjungi situs web resmi Node.js untuk mengunduh dan menginstalnya.

Metode Instalasi

macOS / Linux

Gunakan skrip instalasi resmi:

curl -fsSL https://openclaw.ai/install.sh | bash

Atau instal secara global melalui npm:

npm install -g openclaw@latest

Windows

Jalankan di PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

Alternatifnya, Anda dapat menginstal secara global menggunakan npm:

npm install -g openclaw@latest

Selesaikan Wizard Konfigurasi Awal

Setelah instalasi pertama, OpenClaw secara otomatis menjalankan wizard konfigurasi untuk membantu Anda menyelesaikan pengaturan awal dengan cepat. Anda juga dapat menjalankan perintah openclaw onboard secara manual untuk melakukan konfigurasi.

Item Konfigurasi	Konfigurasi yang Direkomendasikan
Saya memahami ini sangat kuat dan secara inheren berisiko. Lanjutkan?	Pilih Yes
Mode onboarding	Pilih QuickStart
Model/Penyedia Autentikasi	Pilih Skip for now (konfigurasi model Alibaba Cloud Model Studio nanti)
Filter model berdasarkan penyedia	Pilih All providers
Model default	Pilih Keep current
Pilih saluran (QuickStart)	Pilih Skip for now (konfigurasi saluran nanti)
Konfigurasi keterampilan sekarang? (disarankan)	Pilih No
Aktifkan hooks?	Tekan tombol spasi untuk memilih opsi, lalu tekan Enter untuk melanjutkan.
Bagaimana Anda ingin menetaskan bot Anda?	Pilih Do this later

Selanjutnya, konfigurasikan model Alibaba Cloud Model Studio untuk OpenClaw agar mengaktifkan kemampuan Chat AI.

3. Konfigurasi Model Alibaba Cloud Model Studio

Untuk mengintegrasikan OpenClaw dengan layanan model Alibaba Cloud Model Studio, konfigurasikan parameter berikut:

Pastikan Base URL, API Key, dan model berasal dari wilayah yang sama.

Base URL

Bervariasi berdasarkan wilayah:

China (Beijing):https://dashscope.aliyuncs.com/compatible-mode/v1
Singapura:https://dashscope-intl.aliyuncs.com/compatible-mode/v1
AS (Virginia):https://dashscope-us.aliyuncs.com/compatible-mode/v1

API Key

Kredensial akses Model Studio, yang digunakan untuk verifikasi identitas dan penagihan, tersedia di halaman Manajemen API Key (Beijing), halaman Manajemen API Key (Singapura), atau halaman Manajemen API Key (Virginia).

Model ID

Tentukan model yang akan diintegrasikan, seperti qwen3.5-plus atau qwen3-coder-next. Untuk daftar lengkap model yang didukung di setiap wilayah, lihat Dukungan dan Pemilihan Model.

Model yang didukung bervariasi berdasarkan wilayah. Misalnya, wilayah AS (Virginia) saat ini tidak mendukung model qwen3-coder-next, dan model generasi teks pihak ketiga hanya tersedia di wilayah China (Beijing).

Catatan

Saat mengonfigurasi parameter, nonaktifkan mode reasoning ("reasoning": false). Jika tidak, konten respons akan kosong.

OpenClaw menyediakan dua metode konfigurasi. Konfigurasi melalui konsol web direkomendasikan.

Metode Satu: Konfigurasi Konsol Web

OpenClaw menyediakan editor berbasis web untuk memodifikasi file konfigurasi openclaw.json.

Jalankan konsol web
Jalankan perintah berikut di terminal:
```
openclaw dashboard
```
Browser akan membuka halaman konsol OpenClaw secara otomatis (biasanya http://127.0.0.1:18789). Jika browser tidak terbuka secara otomatis, akses alamat ini secara manual.
Buka halaman konfigurasi
Di panel navigasi sebelah kiri, pilih Configuration > RAW (atau Config > RAW).

Tambahkan konfigurasi Model Studio

Di panel navigasi sebelah kiri, pilih Configuration > RAW (atau Config > RAW). Salin informasi konfigurasi berikut. Ganti bagian "agents": {...}, yang asli. Ganti DASHSCOPE_API_KEY dengan API Key Alibaba Cloud Model Studio Anda.

Penting

Dokumen ini hanya berlaku untuk mode penagihan bayar sesuai penggunaan. Paket Coding memerlukan Base URL dan API Key khusus untuk akses dan hanya mendukung model tertentu. Untuk informasi lebih lanjut, lihat dokumentasi Paket Coding OpenClaw untuk konfigurasi.

Konfigurasi berikut menggunakan model qwen3.5-plus dan qwen3-coder-next di wilayah Singapura. Pastikan wilayah Base URL dan API Key konsisten.

Untuk menggunakan model lain, tambahkan definisi model ke providers.bailian.models (atur parameter reasoning ke false). Tambahkan entri "bailian/Model ID": {} ke agents.defaults.models. Untuk model yang didukung di setiap wilayah dalam mode penagihan bayar sesuai penggunaan, lihat Daftar Model.

  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "apiKey": "DASHSCOPE_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen3-coder-next",
            "name": "qwen3-coder-next",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-coder-next": {}
      }
    }
  },

Simpan dan terapkan konfigurasi
Setelah dikonfigurasi, klik Save di pojok kanan atas untuk menyimpan konfigurasi. Lalu klik Update.

Metode Dua: Edit File Konfigurasi

Jika Anda lebih suka mengedit file konfigurasi secara langsung, ikuti langkah-langkah berikut. File konfigurasi berada di ~/.openclaw/openclaw.json. OpenClaw akan membacanya secara otomatis saat startup.

Buka file konfigurasi
Buka file konfigurasi menggunakan editor teks. Jika file belum ada, editor akan membuatnya secara otomatis:
```
# Anda juga dapat menggunakan editor lain, seperti vim.
# vim ~/.openclaw/openclaw.json
nano ~/.openclaw/openclaw.json
```

Tambahkan konfigurasi Model Studio

Salin dan tempel konten konfigurasi berikut. Ganti DASHSCOPE_API_KEY dengan API Key Alibaba Cloud Model Studio Anda:

Penting

Konfigurasi berikut menggunakan model qwen3.5-plus dan qwen3-coder-next di wilayah Singapura. Pastikan wilayah Base URL dan API Key konsisten.

{
  "meta": {
    "lastTouchedVersion": "2026.2.1",
    "lastTouchedAt": "2026-02-03T08:20:00.000Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "apiKey": "DASHSCOPE_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen3-coder-next",
            "name": "qwen3-coder-next",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 262144,
            "maxTokens": 65536
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-coder-next": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "test123"
    }
  }
}

Simpan file konfigurasi
Jika menggunakan editor nano:
1. Tekan Ctrl+X untuk keluar dari editor.
2. Tekan Y untuk mengonfirmasi saat diminta menyimpan.
3. Tekan Enter untuk mengonfirmasi nama file.
Jika menggunakan editor vim:
1. Tekan Esc untuk memastikan Anda keluar dari mode insert.
2. Masukkan :wq dan tekan Enter untuk menyimpan dan keluar.
Verifikasi konfigurasi
Gunakan perintah berikut untuk melihat isi file konfigurasi dan memastikan konfigurasi sudah benar:
```
cat ~/.openclaw/openclaw.json
```

4. Mulai Percakapan

Command Line

Jalankan perintah berikut di server cloud atau terminal lokal Anda untuk memulai percakapan melalui command line.

openclaw tui

Antarmuka Web

Jalankan perintah berikut di server cloud atau terminal lokal Anda untuk memulai percakapan melalui antarmuka Web.

openclaw dashboard

Ganti Model

Switch model in current session (temporary)
Masukkan openclaw tui di terminal untuk masuk ke antarmuka TUI. Gunakan /model <nama model> untuk mengganti model dalam session saat ini.
```
/model qwen3-coder-next
```
Antarmuka akan mengembalikan "model set to qwen3-coder-next" untuk mengonfirmasi perubahan.
Ganti model default (permanen)
Untuk menggunakan model tertentu di setiap session baru, ubah field agents.defaults.model.primary menjadi model target.
```
{
    "agents": {
        "defaults": {
            "model": {
                "primary": "bailian/qwen3.5-plus"
            }
        }
    }
}
```

FAQ

Masalah 1: Model tidak ditemukan atau respons kosong

Konfirmasi hal berikut:

ID model dieja dengan benar.
Nama provider dalam konfigurasi sesuai dengan nama yang digunakan dalam referensi (misalnya, jika bailian ada di konfigurasi, gunakan bailian/qwen3.5-plus dalam referensi).
Parameter reasoning dalam konfigurasi harus diatur ke false.

Masalah 2: "command not found" saat menjalankan perintah openclaw

Hal ini mungkin disebabkan oleh alasan berikut:

Instalasi OpenClaw gagal. Jalankan openclaw --version di server cloud atau terminal lokal Anda. Jika nomor versi muncul, instalasi berhasil.
Beberapa perintah mungkin belum sepenuhnya dimigrasikan selama proses penggantian nama OpenClaw. Coba langkah berikut:
1. Gunakan perintah lama moltbot atau clawdbot sebagai gantinya.
2. Instal ulang versi terbaru: npm install -g openclaw@latest.