Skip to main content

OpenClaw

Gunakan model Alibaba Cloud Model Studio di OpenClaw.

Mulai Cepat

  1. 1

    Instal plugin Qwen

    openclaw plugins install @openclaw/qwen-provider
    
    Jika plugin tidak dapat diinstal, lihat Konfigurasikan dengan file konfigurasi.
  2. 2

    Dapatkan kunci API

    • Token Plan
    • Bayar sesuai penggunaan
    • Coding Plan
    Dapatkan kunci API Token Plan sesuai edisi Anda:
  3. 3

    Konfigurasikan model

    Jalankan perintah untuk paket penagihan Anda dan masukkan kunci API saat diminta.
    • Token Plan
    • Bayar sesuai penggunaan
    • Coding Plan
    openclaw onboard --auth-choice qwen-token-plan-cn
    
  4. 4

    Verifikasi

    Jalankan perintah berikut untuk memeriksa daftar model dan melakukan panggilan uji:
    openclaw models list --provider qwen-token-plan
    openclaw agent --model qwen-token-plan/qwen3.8-max --message "Reply with: ok"
    

Konfigurasikan dengan file konfigurasi

Gunakan metode ini jika plugin Qwen tidak dapat diinstal atau Anda lebih memilih mengelola konfigurasi secara manual.
  1. 1

    Buka atau buat file konfigurasi

    ~/.openclaw/openclaw.jsonPerbarui hanya kolom yang relevan di models, agents, dan gateway. Jangan ganti seluruh file.
  2. 2

    Tulis konfigurasi

    • Token Plan Edisi Personal
    • Token Plan Edisi Tim
    • Bayar sesuai penggunaan
    • Coding Plan
    Ganti YOUR_API_KEY dengan kunci API Token Plan Edisi Personal Anda.
    {
      "models": {
        "mode": "merge",
        "providers": {
          "bailian-token-plan": {
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
            "apiKey": "YOUR_API_KEY",
            "api": "anthropic-messages",
            "models": [
              {
                "id": "auto",
                "name": "auto",
                "reasoning": false,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 393216,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen4-max-preview",
                "name": "qwen4-max-preview",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 131072,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen4-max",
                "name": "qwen4-max",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 262144,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.8-max",
                "name": "qwen3.8-max",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 131072,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.8-flash",
                "name": "qwen3.8-flash",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 131072,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.7-max",
                "name": "qwen3.7-max",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.7-plus",
                "name": "qwen3.7-plus",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "qwen3.6-flash",
                "name": "qwen3.6-flash",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4.1-flash",
                "name": "deepseek-v4.1-flash",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4.1-flash-1017",
                "name": "deepseek-v4.1-flash-1017",
                "reasoning": true,
                "input": [
                  "text",
                  "image"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4-pro",
                "name": "deepseek-v4-pro",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4-pro-0813",
                "name": "deepseek-v4-pro-0813",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "deepseek-v4-flash-0731",
                "name": "deepseek-v4-flash-0731",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 1000000,
                "maxTokens": 65536,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "glm-5.3",
                "name": "glm-5.3",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 202752,
                "maxTokens": 16384,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              },
              {
                "id": "glm-5.2",
                "name": "glm-5.2",
                "reasoning": true,
                "input": [
                  "text"
                ],
                "contextWindow": 202752,
                "maxTokens": 16384,
                "cost": {
                  "input": 0,
                  "output": 0,
                  "cacheRead": 0,
                  "cacheWrite": 0
                }
              }
            ]
          }
        }
      },
      "agents": {
        "defaults": {
          "model": {
            "primary": "bailian-token-plan/auto"
          }
        }
      },
      "gateway": {
        "mode": "local",
        "auth": {
          "mode": "none"
        }
      }
    }
    
    Saat menggunakan qwen4-max-preview, gunakan params.cacheRetention untuk menyetel short, long, atau none; long menggunakan TTL 1 jam.
    Saat menggunakan qwen4-max, setel params.cacheRetention ke short, long, atau none. long memetakan ke TTL 1 jam. qwen4-max memiliki konteks 1M Token. Output maksimum adalah 131.072 Token dalam mode non-thinking dan 262.144 Token untuk thinking dan jawaban akhir secara gabungan. Nilai default adalah reasoning_effort=high dan thinking_budget=131072.
gateway.auth.mode: none hanya cocok untuk penggunaan lokal pada satu mesin. Untuk berbagi atau mengakses dari jarak jauh, jalankan openclaw doctor --generate-gateway-token untuk membuat token, lalu mulai ulang Gateway.

Hubungkan saluran pesan

  • DingTalk
  • WeChat
  • QQ
Jika Anda men-deploy OpenClaw menggunakan Simple Application Server atau Elastic Desktop Service, plugin DingTalk biasanya sudah terinstal sebelumnya dan dapat dikonfigurasi di antarmuka pengguna grafis.
  1. 1

    Buat aplikasi DingTalk dan dapatkan kredensial

    1. Masuk ke DingTalk Open Platform, pilih organisasi yang Anda memiliki izin pengembang untuknya, atau buat organisasi lalu dapatkan izin pengembang.
    2. Di bilah menu atas, pilih Application Development, klik Create Application, masukkan nama dan deskripsi aplikasi, lalu klik Save.
    3. Di halaman Add Application Capabilities, tambahkan Bot. Aktifkan Bot Configuration, isi kolom yang wajib diisi, pertahankan Stream mode default untuk message receiving mode, lalu klik Publish.
    4. Di halaman Credentials and Basic Information, dapatkan Client ID dan Client Secret.
    5. Di halaman Version Management and Release, buat versi, atur rentang visibilitas, simpan, dan publikasikan.
  2. 2

    Instal plugin saluran DingTalk

    openclaw plugins install @soimy/dingtalk
    openclaw plugins list
    
    Output harus menyertakan plugin dingtalk dengan status loaded.
  3. 3

    Konfigurasikan saluran DingTalk

    Tambahkan konfigurasi berikut ke ~/.openclaw/openclaw.json. Ganti YOUR_DINGTALK_APPKEY dan YOUR_DINGTALK_APPSECRET dengan kredensial dari Langkah 1. Jangan timpa konfigurasi yang sudah ada seperti models dan agents.
    {
      "channels": {
        "dingtalk": {
          "enabled": true,
          "clientId": "YOUR_DINGTALK_APPKEY",
          "clientSecret": "YOUR_DINGTALK_APPSECRET",
          "robotCode": "YOUR_DINGTALK_APPKEY",
          "dmPolicy": "open",
          "groupPolicy": "open",
          "messageType": "markdown"
        }
      },
      "plugins": {
        "allow": ["dingtalk"],
        "entries": {
          "dingtalk": {
            "enabled": true
          }
        }
      }
    }
    
    Menyetel dmPolicy dan groupPolicy ke open cocok untuk pengujian atau penggunaan pribadi. Di lingkungan produksi, setel keduanya ke allowlist dan tambahkan kolom allowFrom:
    "dmPolicy": "allowlist",
    "groupPolicy": "allowlist",
    "allowFrom": ["your-employee-id", "group-id"]
    
  4. 4

    Verifikasi

    openclaw gateway restart
    openclaw status
    
    Di bagian Channels, DingTalk harus ON dengan status OK - configured. Kirim pesan ke bot di obrolan grup DingTalk untuk menguji koneksi.

Lark

  1. 1

    Buat aplikasi Lark

    1. Buka Lark Open Platform, klik Create Custom Enterprise App, masukkan nama dan deskripsi aplikasi, pilih ikon, lalu klik Create.
    2. Di halaman Credentials and Basic Information, salin App ID (dengan format cli_xxx) dan App Secret.
    3. Di halaman Permission Management, klik Batch Import/Export Permissions, tempel JSON berikut, klik Next, Confirm New Permissions, lalu klik Apply for Activation.
    {
      "scopes": {
        "tenant": [
          "aily:file:read",
          "aily:file:write",
          "application:application.app_message_stats.overview:readonly",
          "application:application:self_manage",
          "application:bot.menu:write",
          "cardkit:card:write",
          "contact:user.employee_id:readonly",
          "corehr:file:download",
          "docs:document.content:read",
          "event:ip_list",
          "im:chat",
          "im:chat.access_event.bot_p2p_chat:read",
          "im:chat.members:bot_access",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.group_msg",
          "im:message.p2p_msg:readonly",
          "im:message:readonly",
          "im:message:send_as_bot",
          "im:resource",
          "sheets:spreadsheet",
          "wiki:wiki:readonly"
        ],
        "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
      }
    }
    
    1. Di halaman Add Application Capabilities, pilih tab Add by Capability, temukan kartu Robot, lalu klik Configure.
    2. Di bawah Events & Callbacks, pada tab Event Configuration, setel Subscription Method ke Use long-lived connection to receive events lalu simpan. Kemudian tambahkan peristiwa im.message.receive_v1.
    3. Di halaman Version Management and Release, buat versi, masukkan nomor versi dan deskripsi pembaruan, simpan, lalu kirim untuk ditinjau dan dipublikasikan.
  2. 2

    Konfigurasikan bot Lark

    Jalankan openclaw channels add, pilih Feishu, lalu masukkan App ID dan App Secret. Kemudian mulai ulang gateway:
    openclaw gateway restart
    
    Tambahkan bot ke obrolan grup Lark, atau kirim pesan ke bot. Bot akan membalas dengan pesan yang berisi kode pemasangan. Salin baris terakhir dan kirim di obrolan OpenClaw untuk menyelesaikan pemasangan.
  3. 3

    Verifikasi

    openclaw status
    
    Di bagian Channels, Lark harus ON dengan status OK. Kirim pesan di Lark untuk menguji koneksi.

Kode error

Jika Anda mengalami error selama konfigurasi, lihat dokumentasi FAQ untuk paket penagihan Anda:

FAQ

Pengaturan pay-as-you-go tetap sama: gunakan API key Model Studio umum dan Base URL. Setelah membeli paket penghematan, paket berlaku otomatis dan penggunaan yang memenuhi syarat dipotong secara otomatis. Lihat Paket penghematan.
Masukkan openclaw tui di terminal untuk memulai baris perintah terminal OpenClaw, lalu masukkan /model untuk melihat daftar model. Tekan Enter untuk memilih model dan Esc untuk keluar dari daftar.
Kemungkinan penyebab:
  1. Kunci API tidak valid, sudah kedaluwarsa, kosong, formatnya salah, atau untuk endpoint yang salah. Pastikan kunci API sesuai dengan metode pembayaran Anda, disalin sepenuhnya tanpa spasi tambahan, dan langganan Anda aktif.
  2. OpenClaw menggunakan konfigurasi yang salah dan sudah usang dari cache konfigurasinya. Hapus item konfigurasi providers dari ~/.openclaw/agents/main/agent/models.json dan mulai ulang OpenClaw.
  3. invalid_iam_token menunjukkan bahwa kunci API gagal melakukan autentikasi IAM. Skenario umum meliputi: kunci API telah dicabut atau dinonaktifkan; region kunci API tidak cocok dengan region Base URL (misalnya, kunci API dibuat di Singapura, tetapi Base URL mengarah ke region lain); atau kredensial sementara STS telah kedaluwarsa. Verifikasikan bahwa kunci API dan Base URL berada di region yang sama dan status kunci API aktif.
  • Jangan gunakan fungsi ganti semua. Fungsi tersebut menimpa konfigurasi kustom. Ubah hanya bagian yang relevan.
  • Jika OpenClaw merespons secara normal, masukkan perintah langsung di obrolan OpenClaw untuk menggabungkan konfigurasi.
  • Jika OpenClaw tidak memiliki model yang dikonfigurasi atau tidak merespons, edit ~/.openclaw/openclaw.json secara manual. Ubah hanya kolom yang relevan dan biarkan konfigurasi yang ada tidak berubah.
Setelah memulai ulang gateway, sesi yang ada mungkin tidak berfungsi dengan benar. Mulai sesi baru.
Pesan error:
http://127.0.0.1:18791/15:05:56 [ws] closed before connect conn=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx remote=127.0.0.1 fwd=n/a origin=n/a host=127.0.0.1:18789 ua=n/a code=1008 reason=device identity required
Penyebab:Klien terhubung ke gateway tanpa memberikan identitas perangkat. Penyebab umum meliputi:
  • Anda mengakses URL di browser untuk pertama kalinya, dan pemasangan perangkat belum selesai.
  • Cache browser telah dihapus, sehingga kunci perangkat hilang.
  • Setelah menginstal ulang atau meningkatkan OpenClaw, file kunci di direktori ~/.openclaw/identity/ tidak ada.
Solusi:Jalankan perintah berikut untuk menyetujui perangkat saat ini dan membuat URL akses browser baru:
openclaw devices approve --latest
openclaw dashboard --no-open
Jika masalah berlanjut, hapus catatan perangkat yang tidak normal dan coba lagi:
openclaw devices clear --pending --yes
openclaw dashboard --no-open
Jalankan openclaw devices list untuk memastikan perangkat muncul di daftar Paired.
Penyebab: OpenClaw memiliki mekanisme heartbeat bawaan. Saat gateway berjalan, OpenClaw secara otomatis memanggil model yang dikonfigurasi pada interval tetap (setiap 30 menit secara default) untuk memeriksa tugas yang tertunda. Setiap heartbeat mengonsumsi sejumlah kecil token.Cara memverifikasi: Periksa file log sesi (.jsonl) di ~/.openclaw/agents/main/sessions/. Panggilan heartbeat ditandai dengan [OpenClaw heartbeat poll].Solusi:
  • Hentikan gateway: jalankan openclaw gateway stop saat tidak digunakan. Ini menghentikan heartbeat segera.
  • Tingkatkan interval heartbeat: setel agents.defaults.heartbeat.every di ~/.openclaw/openclaw.json. Misalnya, "2h" menyetel interval menjadi setiap 2 jam.