OpenClaw adalah platform asisten AI pribadi sumber terbuka yang memungkinkan Anda berinteraksi dengan AI melalui berbagai saluran pesan. Platform ini dapat dikonfigurasi untuk mengakses model AI dari Alibaba Cloud Model Studio dan mendukung empat metode akses: pay-as-you-go, Coding Plan, Token Plan Personal Edition, dan Token Plan Team Edition.
Instal OpenClaw
OpenClaw memerlukan Node.js 22.19.0 atau versi yang lebih baru. Untuk memeriksa versi Anda:
- macOS / Linux
- Windows
openclaw onboard untuk mengonfigurasinya secara manual.
Parameter | Rekomendasi |
Saya memahami ini sangat kuat dan secara inheren berisiko. Lanjutkan? | Pilih Yes |
Mode onboarding | Pilih QuickStart |
Penyedia model/otentikasi | Pilih Skip for now (Anda dapat mengonfigurasi model Studio Model nanti) |
Filter model berdasarkan penyedia | Pilih All providers |
Model default | Pilih Keep current |
Pilih saluran (QuickStart) | Pilih Skip for now (Anda dapat mengonfigurasi saluran nanti) |
Konfigurasi skill sekarang? (disarankan) | Pilih No |
Aktifkan hooks? | Tekan tombol Spasi untuk memilih opsi, lalu tekan Enter. |
Bagaimana Anda ingin menetaskan bot Anda? | Pilih Do this later |
Konfigurasi kredensial akses
Token Plan Personal Edition
Item | Deskripsi |
|---|---|
API Key | API Key eksklusif untuk Token Plan Personal Edition |
Base URL |
|
Model yang tersedia | Semua model yang termasuk dalam Token Plan Personal Edition |
~/.openclaw/openclaw.json. OpenClaw secara otomatis membaca file ini saat startup.
auth.mode: none), hanya cocok untuk penggunaan lokal pada satu mesin. Untuk akses bersama atau jarak jauh, jalankan openclaw doctor --fix untuk mengaktifkan otentikasi token.YOUR_API_KEY dengan API Key Anda untuk Token Plan Personal Edition.
Untuk konfigurasi yang sudah ada: Untuk mempertahankan pengaturan Anda saat ini, jangan mengganti seluruh isi file. Lihat Cara memodifikasi konfigurasi yang sudah ada dengan aman.
Token Plan Team Edition
Item | Deskripsi |
|---|---|
API Key | API Key eksklusif untuk Token Plan Team Edition |
Base URL |
|
Model yang tersedia | Semua model yang termasuk dalam Token Plan Team Edition |
~/.openclaw/openclaw.json. OpenClaw secara otomatis membaca file ini saat startup.
auth.mode: none), hanya cocok untuk penggunaan lokal pada satu mesin. Untuk akses bersama atau jarak jauh, jalankan openclaw doctor --fix untuk mengaktifkan otentikasi token.- Metode 1: Terminal
- Metode 2: Web UI
- Buka file konfigurasi
-
Tambahkan konfigurasi
Untuk konfigurasi baru: Salin konten berikut ke dalam file konfigurasi. Ganti
YOUR_API_KEYdengan API Key Anda untuk Token Plan Team Edition. Untuk konfigurasi yang sudah ada: Untuk mempertahankan pengaturan Anda saat ini, jangan mengganti seluruh isi file. Lihat Cara memodifikasi konfigurasi yang sudah ada dengan aman.
-
Simpan dan keluar
Tekan
Ctrl+X, tekanYuntuk mengonfirmasi penyimpanan, lalu tekanEnteruntuk mengonfirmasi nama file. - Terapkan konfigurasi Untuk menerapkan perubahan, restart gateway dengan perintah berikut:
Coding Plan
Item | Deskripsi |
|---|---|
API Key | API Key eksklusif untuk Coding Plan, dalam format |
Base URL | |
Model yang tersedia | Semua model yang termasuk dalam Coding Plan |
~/.openclaw/openclaw.json. OpenClaw secara otomatis membaca file ini saat startup.
auth.mode: none), hanya cocok untuk penggunaan lokal pada satu mesin. Untuk akses bersama atau jarak jauh, jalankan openclaw doctor --fix untuk mengaktifkan otentikasi token.- Metode 1: Terminal
- Metode 2: Web UI
- Buka file konfigurasi
-
Tambahkan konfigurasi
Untuk konfigurasi baru: Salin konten berikut ke dalam file konfigurasi. Ganti
YOUR_API_KEYdengan API Key Coding Plan Anda. Untuk konfigurasi yang sudah ada: Untuk mempertahankan pengaturan Anda saat ini, jangan mengganti seluruh isi file. Lihat Cara memodifikasi konfigurasi yang sudah ada dengan aman.
-
Simpan dan keluar
Tekan
Ctrl+X, tekanYuntuk mengonfirmasi penyimpanan, lalu tekanEnteruntuk mengonfirmasi nama file. - Terapkan konfigurasi Untuk menerapkan perubahan, restart gateway dengan perintah berikut:
Pay-as-you-go
Item | Deskripsi |
|---|---|
API Key | Model Studio API Key, dalam format |
Base URL | Pastikan Base URL, API Key, dan model Anda semuanya sesuai dengan wilayah yang sama:
|
Model yang tersedia | Semua model yang tersedia di Model Market |
~/.openclaw/openclaw.json. OpenClaw secara otomatis membaca file ini saat startup. Contoh berikut menggunakan wilayah China (Beijing). Jika Anda menggunakan wilayah lain, ganti baseUrl dengan URL yang sesuai dari tabel di atas.
auth.mode: none), hanya cocok untuk penggunaan lokal pada satu mesin. Untuk akses bersama atau jarak jauh, jalankan openclaw doctor --fix untuk mengaktifkan otentikasi token.- Metode 1: Terminal
- Metode 2: Web UI
- Buka file konfigurasi
-
Tambahkan konfigurasi
Untuk konfigurasi baru: Salin konten berikut ke dalam file konfigurasi. Ganti
YOUR_API_KEYdengan Model Studio API Key Anda. Untuk konfigurasi yang sudah ada: Untuk mempertahankan pengaturan Anda saat ini, jangan mengganti seluruh isi file. Lihat Cara memodifikasi konfigurasi yang sudah ada dengan aman.
-
Simpan dan keluar
Tekan
Ctrl+X, tekanYuntuk mengonfirmasi penyimpanan, lalu tekanEnteruntuk mengonfirmasi nama file. - Terapkan konfigurasi Untuk menerapkan perubahan, restart gateway dengan perintah berikut:
Hubungkan ke saluran pesan
WhatsApp
Langkah 1: Instal plugin WhatsApp
Saluran WhatsApp dihubungkan melalui plugin. Jalankan perintah berikut untuk menginstalnya:
Langkah 2: Konfigurasi saluran WhatsApp
Masukkan prompt berikut di obrolan OpenClaw Anda. OpenClaw akan meminta nomor telepon Anda dalam format E.164 (tanda + diikuti kode negara dan nomor), lalu secara otomatis menambahkan nomor tersebut ke konfigurasi dan menyelesaikan penyiapan.
selfChatMode. Bot kemudian hanya akan merespons di obrolan "Message yourself" Anda, sehingga obrolan lain tidak terganggu.Langkah 3: Hubungkan dengan WhatsApp
- Mulai proses penghubungan WhatsApp. Terminal menampilkan kode QR.
- Buka WhatsApp di ponsel Anda dan pindai kode QR di terminal untuk menghubungkan akun Anda.
- Restart gateway.
Langkah 4: Uji coba
- Periksa status saluran WhatsApp:
ON dengan status OK.
2. Di WhatsApp, kirim pesan ke diri sendiri untuk memverifikasi bahwa bot merespons dengan benar.
Telegram
-
Buat bot menggunakanBotFather
Kirim perintah
/newbot, ikuti petunjuk untuk memasukkan nama bot dan username (username harus diakhiri denganbot), lalu salin dan simpan token bot yang dikembalikan (format:123456789:ABCdefGHIjklMNOpqrsTUVwxyz). -
Di obrolan OpenClaw Anda, masukkan prompt berikut dan ganti
xxxxdengan token bot Anda yang sebenarnya. OpenClaw akan secara otomatis menerapkan konfigurasi.
- Setelah konfigurasi selesai, restart gateway.
- Di Telegram, kirim pesan ke bot Anda. Saat Anda mengirim pesan pertama, Anda akan menerima kode pairing.
- Di terminal Anda, jalankan perintah berikut, ganti
xxxdengan kode pairing yang sebenarnya:
Discord
Langkah 1: Buat aplikasi dan bot Discord
- Buat aplikasi Discord Buka Discord Developer Portal, klik New Application, masukkan nama aplikasi, lalu klik Create.
-
Buat bot dan aktifkan izin
- Di panel navigasi kiri, klik Bot dan atur username untuk bot.
-
Di halaman Bot, gulir ke bawah ke Privileged Gateway Intents dan aktifkan intent berikut:
- Message Content Intent
- Server Members Intent
- Presence Intent
- Dapatkan token bot Di bagian atas halaman Bot, klik Reset Token untuk menghasilkan token. Token ini hanya ditampilkan sekali, jadi salin dan simpan segera di lokasi yang aman.
-
Tambahkan bot ke server
- Di panel navigasi kiri, klik OAuth2 dan gulir ke bawah ke OAuth2 URL Generator.
-
Di bawah Scopes, pilih kotak centang
botdanapplications.commands. -
Di bagian Bot Permissions yang muncul, pilih izin berikut:
- View Channels
- Send Messages
- Read Message History
- Embed Links
- Attach Files
- Salin URL yang dihasilkan di bagian bawah halaman, buka di browser Anda, pilih server target, lalu klik Continue untuk menambahkan bot.
Langkah 2: Konfigurasi Discord di OpenClaw
- Di mesin tempat OpenClaw berjalan, atur token bot sebagai variabel lingkungan.
- Selesaikan konfigurasi Discord:
- Restart gateway untuk menerapkan konfigurasi.
Langkah 3: Pairing dan uji coba
- Di Discord, kirim pesan langsung ke bot. Saat Anda mengirim pesan pertama, Anda akan menerima kode pairing.
- Di terminal Anda, jalankan perintah berikut untuk menyelesaikan pairing, ganti
xxxdengan kode pairing yang sebenarnya:
- Periksa status saluran Discord:
ON dengan status OK.
4. Kirim pesan di Discord untuk menguji koneksi.
Perintah umum
Perintah | Deskripsi | Contoh |
|---|---|---|
/help | Menampilkan daftar perintah yang tersedia. | /help |
/status | Menampilkan status model, sesi, dan gateway saat ini. | /status |
/model <model_name> | Beralih ke model lain untuk sesi saat ini. | /model qwen3.7-max |
/new | Memulai sesi baru. | /new |
/compact | Mengompresi riwayat percakapan untuk mengosongkan ruang jendela konteks. | /compact |
/think <level> | Mengatur kedalaman inferensi. Level yang tersedia adalah off, low, medium, dan high. | /think high |
/skills | Menampilkan daftar skill yang tersedia. | /skills |
Kasus penggunaan
Kasus penggunaan 1: Otomatisasi X (Twitter)
Anda dapat menggunakan OpenClaw untuk mengotomatiskan akun X (Twitter) Anda, termasuk posting, membalas, mencari, dan menelusuri timeline Anda.
Langkah konfigurasi
Langkah konfigurasi
- Instal twitter-cli:
- Masukkan perintah berikut di dialog OpenClaw untuk menginstal Skill secara otomatis.
- Restart gateway untuk mengaktifkan Skill.
- Verifikasi instalasi:
- twitter-cli menggunakan cookie browser untuk autentikasi. Pastikan Anda telah login ke x.com di browser yang didukung, seperti Chrome, Edge, Firefox, Arc, atau Brave. twitter-cli secara otomatis mengambil cookie tersebut. Atau, Anda dapat mengatur informasi autentikasi secara manual menggunakan variabel lingkungan:
auth_token dan ct0.Contoh 1: Posting otomatis
Contoh 1: Posting otomatis
Check Sam Altman's recent tweets, summarize the key points, and then help me post a tweet with my thoughts di dialog OpenClaw. OpenClaw secara otomatis mengambil feed, menganalisis konten, lalu mempostingnya.Contoh 2: Cari topik yang sedang tren
Contoh 2: Cari topik yang sedang tren
Search for tweets about harness engineering from yesterday. OpenClaw mencari tweet yang relevan dan meringkas poin utamanya.Kasus penggunaan 2: Analisis dan unduh video YouTube
Anda dapat menggunakan OpenClaw untuk mencari video YouTube, mengekstrak informasi video, dan mengunduh video. Fitur ini mendukung pencarian berdasarkan kata kunci, pengurutan berdasarkan tanggal, dan pengambilan metadata video secara massal.
Langkah konfigurasi
Langkah konfigurasi
- Instal yt-dlp:
- Verifikasi instalasi:
- (Opsional) Konfigurasi autentikasi cookie. Ini diperlukan untuk mengakses video yang dibatasi usia, khusus anggota, atau privat. Pastikan Anda telah login ke youtube.com di browser Anda, lalu masukkan berikut di dialog OpenClaw:
yt-dlp untuk melakukan operasi terkait video.Contoh 1: Ringkas konten video
Contoh 1: Ringkas konten video
Summarize the main points of this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0 di dialog OpenClaw. OpenClaw mengambil informasi video dan menghasilkan ringkasan.Contoh 2: Unduh video
Contoh 2: Unduh video
Download this video: https://www.youtube.com/watch?v=XRgGFQ0EgM0 di dialog OpenClaw. OpenClaw menjalankan yt-dlp untuk mengunduh video ke mesin lokal Anda.Kasus penggunaan 3: Jadwalkan pengiriman berita AI harian
Anda dapat menggunakan fitur cron OpenClaw untuk mengambil berita AI terbaru secara otomatis dan mendorongnya ke WhatsApp setiap hari.
Langkah konfigurasi
Langkah konfigurasi
- Di terminal Anda:
Parameter | Deskripsi |
|---|---|
| Nama tugas. |
| Ekspresi cron. |
| Zona waktu. Atur ke |
| Prompt yang dikirim ke agen, yang menentukan konten apa yang harus diambil dan cara meringkasnya. |
| Saluran push. Atur ke |
| Mendorong output tugas ke penerima yang ditentukan. |
| Nomor telepon penerima WhatsApp dalam format E.164, yang mencakup tanda plus, kode negara, dan nomor telepon. |
- Daftar semua tugas untuk mendapatkan ID tugas:
- Picu tugas secara manual:
- Periksa hasil eksekusi:
"status": "ok" dan "delivered": true, berita telah berhasil dikirim ke WhatsApp.Kasus penggunaan 4: Analisis pasar saham
Anda dapat menggunakan OpenClaw untuk menganalisis tren saham serta menerima analisis teknis dan saran investasi.
Langkah konfigurasi
Langkah konfigurasi
- Instal Skill. Masukkan instruksi berikut di dialog OpenClaw. OpenClaw akan secara otomatis menyelesaikan instalasi.
- Restart gateway untuk mengaktifkan Skill.
- Di dialog OpenClaw, ajukan pertanyaan terkait saham, seperti
Analyze NVDA stock.
Pelajari lebih lanjut
Skill
Skill adalah modul ekstensibel yang menyediakan kemampuan baru. Agen secara otomatis mencocokkan dan memuat Skill yang sesuai berdasarkan permintaan pengguna. OpenClaw memungkinkan Anda melihat dan mengaktifkan Skill bawaan, menginstal Skill komunitas dari ClawHub, atau membuat Skill kustom.
Menampilkan skill yang ada
- Lihat Skill yang telah Anda instal dan statusnya:
- Skill bawaan dinonaktifkan secara default. Untuk mengaktifkannya, Anda harus menambahkannya ke daftar izin
skills.allowBundleddi~/.openclaw/openclaw.json. OpenClaw hanya memuat Skill bawaan yang tercantum dalam array ini.
skills.entries di ~/.openclaw/openclaw.json. Untuk detailnya, lihat dokumentasi Konfigurasi Skill.
Menemukan lebih banyak skill
Anda dapat menemukan dan menginstal lebih banyak Skill menggunakan salah satu metode berikut.
- Cari dan instal dari ClawHub ClawHub menawarkan lebih dari 3.000 Skill komunitas. Anda dapat menelusurinya di situs web atau mencarinya dari command line.
-
Tanyakan langsung ke OpenClaw
Jelaskan kebutuhan Anda langsung di obrolan, misalnya,
Help me find a Skill that can check the weather. OpenClaw akan secara otomatis mencari dan menginstal Skill yang sesuai.
Membuat skill kustom
- Buat direktori untuk Skill Anda.
- Di direktori ini, buat file
SKILL.md. File ini terdiri dari dua bagian: YAML front matter dan instruksi Markdown. Bidangnamedandescriptionwajib diisi. Agen menggunakandescriptionuntuk menentukan apakah akan memuat Skill. Pastikan deskripsi akurat.
- Restart gateway untuk menerapkan Skill.
FAQ
Bagaimana cara melihat model yang telah saya konfigurasi?
Bagaimana cara melihat model yang telah saya konfigurasi?
openclaw tui di terminal Anda. Lalu, masukkan /model untuk melihat daftar model. Tekan Enter untuk memilih model dan Esc untuk keluar dari daftar.Mengapa saya mendapatkan error HTTP 401: Incorrect API key provided. , No API key found for provider xxx , atau HTTP 401: invalid_iam_token ?
Mengapa saya mendapatkan error HTTP 401: Incorrect API key provided. , No API key found for provider xxx , atau HTTP 401: invalid_iam_token ?
- Kunci API mungkin tidak valid, kedaluwarsa, kosong, formatnya salah, atau untuk endpoint yang salah. Pastikan kunci API sesuai dengan metode pembayaran Anda, disalin sepenuhnya tanpa spasi tambahan, dan langganan akun Anda aktif.
- OpenClaw mungkin menggunakan konfigurasi cache yang salah atau kedaluwarsa. Untuk mengatasi ini, hapus item konfigurasi
providersdari file~/.openclaw/agents/main/agent/models.jsondan restart OpenClaw. invalid_iam_tokenmenunjukkan bahwa kunci API gagal dalam otentikasi IAM. Skenario umum meliputi: kunci API telah dicabut atau dinonaktifkan; wilayah kunci API tidak sesuai dengan wilayah Base URL (misalnya, kunci API dibuat di China (Beijing), tetapi Base URL mengarah ke Singapura); atau kredensial sementara STS telah kedaluwarsa. Verifikasi bahwa kunci API dan Base URL berada di wilayah yang sama dan status kunci API aktif.
Saya telah mengonfigurasi saluran lain seperti DingTalk. Bagaimana cara menambahkan model untuk rencana baru tanpa kehilangan konfigurasi yang sudah ada?
Saya telah mengonfigurasi saluran lain seperti DingTalk. Bagaimana cara menambahkan model untuk rencana baru tanpa kehilangan konfigurasi yang sudah ada?
- Jangan gunakan fungsi "Ganti Semua", karena ini akan menimpa konfigurasi kustom Anda. Sebagai gantinya, modifikasi hanya bagian yang relevan.
-
Gunakan salah satu metode berikut untuk menyelesaikan konfigurasi:
- Jika OpenClaw merespons secara normal: Masukkan perintah langsung di obrolan OpenClaw untuk menggabungkan konfigurasi.
- Jika OpenClaw belum mengonfigurasi model atau tidak merespons: Edit secara manual file
~/.openclaw/openclaw.json. Modifikasi hanya bidang yang relevan dan biarkan konfigurasi yang sudah ada tidak berubah.
Apa yang harus saya lakukan jika mendapatkan error device identity required ?
Apa yang harus saya lakukan jika mendapatkan error device identity required ?
- Anda mengakses URL di browser untuk pertama kalinya, dan pairing perangkat belum selesai.
- Cache browser dihapus, menyebabkan kunci perangkat hilang.
- Setelah menginstal ulang atau memperbarui OpenClaw, file kunci di direktori
~/.openclaw/identity/hilang.
openclaw devices list untuk mengonfirmasi perangkat muncul di daftar Paired.Konsumsi token terjadi bahkan ketika OpenClaw tidak digunakan secara aktif
Konsumsi token terjadi bahkan ketika OpenClaw tidak digunakan secara aktif
~/.openclaw/agents/main/sessions/. Panggilan detak jantung ditandai dengan [OpenClaw heartbeat poll].Solusi:- Hentikan gateway: Jalankan
openclaw gateway stopsaat tidak digunakan. Ini akan segera menghentikan detak jantung. - Tingkatkan interval detak jantung: Atur
agents.defaults.heartbeat.everydi~/.openclaw/openclaw.json. Misalnya,"2h"mengatur interval menjadi setiap 2 jam.