FAQ: penyiapan awal

Gunakan agen AI lokal yang dapat melihat mesin Anda. Sebagian besar kasus "Saya mengalami kebuntuan" merupakan masalah konfigurasi atau lingkungan lokal yang tidak dapat diperiksa oleh pembantu jarak jauh, jadi cara ini lebih efektif daripada bertanya di Discord.

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Berikan seluruh checkout sumber kepada agen melalui instalasi yang dapat dimodifikasi (git) agar agen dapat membaca kode + dokumentasi dan menganalisis versi persis yang Anda jalankan:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Minta agen merencanakan dan mengawasi perbaikan langkah demi langkah, lalu jalankan hanya perintah yang diperlukan - diff yang lebih kecil lebih mudah diaudit.

Bagikan keluaran berikut saat meminta bantuan (di Discord atau masalah GitHub):

Menemukan bug atau perbaikan nyata? Ajukan masalah atau kirim PR: Masalah / Pull request.

Siklus debug cepat: 60 detik pertama jika ada yang rusak. Dokumentasi instalasi: Instalasi, Flag penginstal, Pembaruan.

Dalam mode tugas, stempel waktu jatuh tempo hanya dimajukan setelah proses heartbeat yang sebenarnya selesai. Proses yang dilewati tidak menandai tugas sebagai selesai.

Dokumentasi: Heartbeat, Otomatisasi.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Dari sumber (kontributor/pengembang):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

Belum ada instalasi global? Jalankan pnpm openclaw onboard sebagai gantinya. Jika aset Control UI tidak ada, proses orientasi akan mencoba membangunnya sendiri, dengan beralih ke pnpm ui:build jika gagal.

Orientasi membuka peramban Anda ke URL dasbor bersih (tanpa token) tepat setelah penyiapan dan mencetak tautannya dalam ringkasan. Biarkan tab tersebut tetap terbuka; jika tidak diluncurkan, salin/tempel URL yang dicetak pada mesin yang sama.

Localhost (mesin yang sama):

• Buka http://127.0.0.1:18789/.
• Jika diminta autentikasi rahasia bersama, tempel token atau kata sandi yang dikonfigurasi ke pengaturan Control UI.
• Sumber token: gateway.auth.token (atau OPENCLAW_GATEWAY_TOKEN).
• Sumber kata sandi: gateway.auth.password (atau OPENCLAW_GATEWAY_PASSWORD).
• Belum ada rahasia bersama yang dikonfigurasi? Jalankan openclaw doctor --generate-gateway-token (atau openclaw doctor --fix --generate-gateway-token).

Bukan di localhost:

• Tailscale Serve (disarankan): pertahankan bind loopback, jalankan openclaw gateway --tailscale serve, buka https://<magicdns>/. Dengan gateway.auth.allowTailscale: true, header identitas memenuhi autentikasi Control UI/WebSocket (tanpa menempelkan rahasia bersama, dengan asumsi host gateway tepercaya); API HTTP tetap memerlukan autentikasi rahasia bersama kecuali Anda sengaja menggunakan none ingress privat atau autentikasi HTTP proksi tepercaya. Upaya Serve dengan autentikasi buruk secara bersamaan dari klien yang sama diserialkan sebelum pembatas autentikasi gagal mencatatnya, sehingga percobaan buruk kedua dapat langsung menampilkan retry later.
• Bind tailnet: jalankan openclaw gateway --bind tailnet --token "<token>" (atau konfigurasikan autentikasi kata sandi), buka http://<tailscale-ip>:18789/, tempel rahasia bersama yang cocok di pengaturan dasbor.
• Proksi balik berbasis identitas: pertahankan Gateway di belakang proksi tepercaya, atur gateway.auth.mode: "trusted-proxy", buka URL proksi. Proksi loopback pada host yang sama memerlukan gateway.auth.trustedProxy.allowLoopback: true secara eksplisit.
• Terowongan SSH: ssh -N -L 18789:127.0.0.1:18789 user@gateway-host, lalu buka http://127.0.0.1:18789/. Autentikasi rahasia bersama tetap berlaku melalui terowongan; tempel token atau kata sandi yang dikonfigurasi jika diminta.

Lihat Dasbor dan Permukaan web untuk mode bind dan detail autentikasi.

Keduanya mengontrol lapisan yang berbeda:

• approvals.exec - meneruskan perintah persetujuan ke tujuan obrolan.
• channels.<channel>.execApprovals - menjadikan kanal tersebut klien persetujuan native untuk persetujuan exec.

Kebijakan exec host tetap menjadi gerbang persetujuan yang sebenarnya; konfigurasi obrolan hanya mengontrol tempat perintah muncul dan cara orang meresponsnya.

Anda jarang memerlukan keduanya:

• Jika obrolan sudah mendukung perintah dan balasan, /approve dalam obrolan yang sama berfungsi melalui jalur bersama.
• Jika kanal native yang didukung dapat menentukan pemberi persetujuan dengan aman, OpenClaw otomatis mengaktifkan persetujuan native yang mengutamakan DM jika channels.<channel>.execApprovals.enabled belum disetel atau "auto".
• Jika kartu/tombol persetujuan native tersedia, UI tersebut menjadi yang utama; sebutkan perintah manual /approve hanya jika hasil alat menyatakan persetujuan obrolan tidak tersedia.
• Gunakan approvals.exec hanya jika perintah juga harus menjangkau obrolan lain atau ruang operasi tertentu.
• Gunakan channels.<channel>.execApprovals.target: "channel" atau "both" hanya jika Anda ingin perintah persetujuan diposting kembali ke ruang/topik asal.
• Persetujuan Plugin terpisah: /approve dalam obrolan yang sama secara default, penerusan approvals.plugin opsional, dan hanya beberapa kanal native yang mempertahankan penanganan native untuk persetujuan tersebut.

Singkatnya: penerusan digunakan untuk perutean, sedangkan konfigurasi klien native digunakan untuk UX khusus kanal yang lebih kaya. Lihat Persetujuan Exec.

Node 22.22.3+, 24.15+, atau 25.9+ diperlukan (Node 24 disarankan). pnpm adalah pengelola paket repo. Bun dapat menginstal dependensi dan menjalankan skrip paket, tetapi tidak dapat menjalankan CLI atau Gateway OpenClaw karena tidak memiliki node:sqlite.

Ya, tetapi periksa RAM terlebih dahulu: Pi 5 dan Pi 4 (2 GB+) adalah pilihan ideal; Pi 3B+ (1 GB) berfungsi tetapi lambat; Pi Zero 2 W (512 MB) tidak disarankan.

Minimum mutlak: RAM 1 GB, 1 inti, ruang disk kosong 500 MB, OS 64-bit. Karena Pi hanya menjalankan Gateway (model memanggil API cloud), bahkan Pi dengan spesifikasi sederhana dapat menangani bebannya.

Pi/VPS kecil juga dapat menghosting Gateway saja sementara Anda memasangkan node di laptop/ponsel untuk layar/kamera/canvas lokal atau eksekusi perintah. Lihat Node.

Panduan lengkap penyiapan: Raspberry Pi.

• Gunakan OS 64-bit; jangan gunakan Raspberry Pi OS 32-bit.
• Tambahkan swap pada papan dengan kapasitas 2 GB atau lebih kecil.
• Utamakan SSD USB daripada kartu SD demi performa dan masa pakai.
• Utamakan instalasi yang dapat dimodifikasi (git) agar Anda dapat melihat log dan memperbarui dengan cepat.
• Mulai tanpa kanal/skills, lalu tambahkan satu per satu.
• Kegagalan biner yang aneh ("exec format error") biasanya disebabkan build ARM64 yang tidak tersedia untuk alat skill opsional.

Panduan lengkap: Raspberry Pi. Lihat juga Linux.

Layar tersebut bergantung pada Gateway yang dapat dijangkau dan diautentikasi. TUI juga secara otomatis mengirim "Bangunlah, temanku!" saat pertama kali menetas ketika penyedia model dikonfigurasi. Jika Anda melewati penyiapan model/autentikasi, orientasi menampilkan catatan "Autentikasi model tidak ada" dan membuka TUI tanpa mengirim apa pun — tambahkan penyedia dengan openclaw configure --section model. Jika Anda melihat baris bangun tersebut tanpa balasan dan token tetap 0, agen tidak pernah berjalan.

1. Mulai ulang Gateway:

openclaw gateway restart

2. Periksa status + autentikasi:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Masih macet? Jalankan:

openclaw doctor

Jika Gateway berada di mesin jarak jauh, pastikan koneksi terowongan/Tailscale aktif dan UI mengarah ke Gateway yang benar. Lihat Akses jarak jauh.

Ya. Salin direktori status dan ruang kerja, lalu jalankan Doctor satu kali:

1. Instal OpenClaw di mesin baru.
2. Salin $OPENCLAW_STATE_DIR (default: ~/.openclaw) dari mesin lama.
3. Salin ruang kerja Anda (default: ~/.openclaw/workspace).
4. Jalankan openclaw doctor dan mulai ulang layanan Gateway.

Tindakan ini mempertahankan konfigurasi, profil autentikasi, kredensial WhatsApp, sesi, dan memori - bot Anda tetap sama persis, asalkan Anda menyalin kedua lokasi. Dalam mode jarak jauh, host gateway memiliki penyimpanan sesi dan ruang kerja.

Penting: jika Anda hanya melakukan commit/push ruang kerja ke GitHub, Anda mencadangkan memori + file bootstrap, tetapi bukan riwayat sesi atau autentikasi. Data tersebut berada di ~/.openclaw/ (misalnya ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite).

Terkait: Migrasi, Lokasi berbagai hal di disk, Ruang kerja agen, Doctor, Mode jarak jauh.

Periksa log perubahan GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Entri terbaru berada di bagian atas. Jika bagian teratas adalah Belum Dirilis, bagian bertanggal berikutnya adalah versi terbaru yang telah dirilis. Entri dikelompokkan dalam Sorotan, Perubahan, dan Perbaikan (serta bagian dokumentasi/lainnya jika diperlukan).

Beberapa koneksi Comcast/Xfinity secara keliru memblokir docs.openclaw.ai melalui Xfinity Advanced Security. Nonaktifkan fitur tersebut atau tambahkan docs.openclaw.ai ke daftar yang diizinkan, lalu coba lagi. Bantu kami agar pemblokirannya dicabut: https://spa.xfinity.com/check_url_status.

Masih terblokir? Dokumentasi dicerminkan di GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Stabil dan beta adalah dist-tag npm, bukan jalur kode yang terpisah:

• latest = stabil
• beta = build awal untuk pengujian (kembali menggunakan latest ketika beta tidak tersedia atau lebih lama daripada rilis stabil saat ini)

Rilis stabil biasanya masuk ke beta terlebih dahulu, lalu langkah promosi eksplisit memindahkan versi yang sama ke latest tanpa mengubah nomor versi. Pengelola juga dapat langsung menerbitkan ke latest. Itulah sebabnya beta dan stabil dapat menunjuk ke versi yang sama setelah promosi.

Lihat perubahannya: CHANGELOG.md.

Untuk perintah instalasi satu baris dan perbedaan antara beta dan dev, lihat akordeon berikutnya.

Beta adalah dist-tag npm beta (dapat sama dengan latest setelah promosi). Dev adalah ujung bergerak dari main (git); ketika diterbitkan ke npm, versi ini menggunakan dist-tag dev.

Perintah satu baris (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Penginstal Windows (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex

Detail selengkapnya: Saluran pengembangan dan Flag penginstal.

Dua opsi:

1. Saluran dev (instalasi yang sudah ada):

openclaw update --channel dev

Ini beralih ke checkout git dari main, melakukan rebase terhadap upstream, melakukan build, dan menginstal CLI dari checkout tersebut.

2. Instalasi yang dapat dimodifikasi (git) (mesin baru):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Sebaiknya gunakan kloning manual:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Dokumentasi: Pembaruan, Saluran pengembangan, Instalasi.

Panduan kasar:

• Instalasi: 2-5 menit.
• Orientasi QuickStart: beberapa menit (gateway loopback, token otomatis, ruang kerja bawaan).
• Orientasi lanjutan/lengkap: lebih lama jika proses masuk penyedia, pemasangan saluran, instalasi daemon, unduhan jaringan, atau skills memerlukan penyiapan tambahan.

Wizard menampilkan linimasa ini sejak awal. Lewati langkah opsional dan kembali lagi nanti dengan openclaw configure.

Macet? Lihat Saya mengalami kebuntuan di atas.

Jalankan ulang dengan --verbose:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

install.ps1 tidak memiliki opsi verbose khusus; jalankan melalui Set-PSDebug -Trace 1 / -Trace 0 sebagai gantinya. Referensi flag lengkap: Flag penginstal.

Dua masalah Windows yang umum:

1) Kesalahan npm spawn git / git tidak ditemukan

• Instal Git for Windows, pastikan git tersedia di PATH.
• Tutup dan buka kembali PowerShell, lalu jalankan ulang penginstal.

2) openclaw tidak dikenali setelah instalasi

• Folder bin global npm Anda tidak tersedia di PATH.
• Periksa dengan: npm config get prefix.
• Tambahkan direktori tersebut ke PATH pengguna Anda (akhiran \bin tidak diperlukan; pada sebagian besar sistem lokasinya adalah %AppData%\npm).
• Tutup dan buka kembali PowerShell.

Lebih memilih aplikasi desktop? Gunakan Windows Hub. Penyiapan khusus terminal: penginstal PowerShell dan jalur Gateway WSL2 keduanya didukung. Dokumentasi: Windows.

Biasanya disebabkan oleh ketidakcocokan halaman kode konsol pada shell Windows native.

Gejala: output system.run/exec menampilkan bahasa Mandarin sebagai mojibake; perintah yang sama terlihat normal di profil terminal lain.

Solusi sementara di PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Kemudian mulai ulang Gateway dan coba lagi:

openclaw gateway restart

Masih terjadi pada OpenClaw terbaru? Pantau/laporkan di: Isu #30640.

Gunakan instalasi yang dapat dimodifikasi (git) agar Anda memiliki seluruh kode sumber dan dokumentasi secara lokal, lalu tanyakan kepada bot Anda (atau Claude/Codex) dari folder tersebut agar dapat membaca repo dan menjawab secara tepat.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Detail selengkapnya: Instalasi dan Flag penginstal.

• Jalur cepat Linux + instalasi layanan: Linux.
• Panduan lengkap: Memulai.
• Penginstal + pembaruan: Instalasi & pembaruan.

VPS Linux apa pun dapat digunakan. Instal di server, lalu akses Gateway melalui SSH/Tailscale.

Panduan: exe.dev, Hetzner, Fly.io. Akses jarak jauh: Gateway jarak jauh.

Pusat hosting dengan penyedia umum:

• Hosting VPS (semua penyedia di satu tempat)
• Fly.io
• Hetzner
• exe.dev

Di cloud, Gateway berjalan di server dan Anda mengaksesnya dari laptop/ponsel melalui UI Kontrol (atau Tailscale/SSH). Status + ruang kerja Anda berada di server, jadi perlakukan host sebagai sumber kebenaran dan cadangkan host tersebut.

Pasangkan node (Mac/iOS/Android/headless) ke Gateway cloud tersebut untuk layar/kamera/canvas lokal atau eksekusi perintah di laptop Anda sementara Gateway tetap berada di cloud.

Pusat: Platform. Akses jarak jauh: Gateway jarak jauh. Node: Node, CLI Node.

Bisa, tetapi tidak disarankan. Alur pembaruan dapat memulai ulang Gateway (memutus sesi aktif), mungkin memerlukan checkout git yang bersih, dan dapat meminta konfirmasi. Lebih aman menjalankan pembaruan dari shell sebagai operator.

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Mengotomatiskan dari agen:

openclaw update --yes --no-restartopenclaw gateway restart

Dokumentasi: Pembaruan, Memperbarui.

openclaw onboard adalah jalur penyiapan yang direkomendasikan. Dalam mode lokal, proses ini memandu Anda melalui:

1. Model/Autentikasi - OAuth penyedia, kunci API, atau autentikasi manual (termasuk opsi lokal seperti LM Studio); pilih model bawaan.
2. Ruang kerja - lokasi + file bootstrap.
3. Gateway - port, alamat bind, mode autentikasi, eksposur Tailscale.
4. Saluran - saluran obrolan bawaan dan plugin resmi: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp, dan lainnya.
5. Daemon - LaunchAgent (macOS), unit pengguna systemd (Linux/WSL2), atau Windows Scheduled Task native.
6. Pemeriksaan kesehatan - memulai Gateway dan memverifikasi bahwa Gateway berjalan.
7. Skills - menginstal skill yang direkomendasikan dan dependensi opsional.

Proses ini menetapkan ekspektasi durasi sejak awal dan memperingatkan jika model yang dikonfigurasi tidak dikenal atau autentikasi tidak tersedia. Rincian lengkap: Orientasi (CLI).

Tidak. Jalankan OpenClaw dengan kunci API (Anthropic/OpenAI/lainnya) atau model khusus lokal agar data Anda tetap berada di perangkat. Langganan (Claude Pro/Max, ChatGPT/Codex) adalah cara opsional untuk mengautentikasi penyedia tersebut.

Untuk Anthropic: kunci API menggunakan penagihan bayar sesuai pemakaian standar; Claude CLI menggunakan kembali login Claude Code yang sudah ada pada host yang sama. Anthropic saat ini menganggap jalur noninteraktif claude -p milik Claude CLI sebagai penggunaan Agent SDK/programatis yang tetap mengurangi batas paket langganan Anda — periksa dokumentasi penagihan Anthropic terbaru sebelum mengandalkan perilaku langganan. Untuk host Gateway jangka panjang dan otomatisasi bersama, kunci API Anthropic adalah pilihan yang lebih dapat diprediksi.

OAuth OpenAI Codex (langganan ChatGPT/Codex) didukung sepenuhnya untuk model agen. OpenClaw juga mendukung opsi yang dihosting dengan gaya langganan, termasuk Qwen Cloud Coding Plan, MiniMax Coding Plan, dan Z.AI / GLM Coding Plan.

Dokumentasi: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Model lokal, Model.

Ya. OpenClaw mendukung penggunaan kembali Claude CLI untuk paket Pro/Max/Team/Enterprise. Anthropic saat ini menganggap jalur claude -p yang digunakan OpenClaw sebagai penggunaan paket langganan yang tunduk pada batas paket Anda, bukan kuota gratis terpisah — lihat Anthropic untuk detail penagihan terkini dan tautan ke artikel dukungan Anthropic. Untuk penyiapan sisi server yang paling dapat diprediksi, gunakan kunci API Anthropic sebagai gantinya.

Ya, melalui penggunaan kembali Claude CLI. Perlakuan penagihan Anthropic terhadap penggunaan claude -p/Agent SDK telah berubah seiring waktu; lihat Anthropic untuk status terkini dan tautan bertanggal ke artikel dukungan Anthropic sebelum mengandalkan perilaku penagihan tertentu.

Autentikasi setup-token Anthropic juga masih merupakan jalur token yang didukung, tetapi OpenClaw lebih memilih penggunaan ulang Claude CLI dan claude -p jika tersedia. Untuk beban kerja produksi atau multi-pengguna, kunci API Anthropic tetap menjadi pilihan yang lebih aman dan lebih mudah diprediksi. Opsi hosted bergaya langganan lainnya: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM).

Kuota/batas laju Anthropic Anda telah habis untuk jendela saat ini. Di Claude CLI, tunggu hingga jendela diatur ulang atau tingkatkan paket Anda. Jika menggunakan kunci API Anthropic, periksa penggunaan/penagihan di Anthropic Console dan naikkan batas sesuai kebutuhan.

Jika pesannya secara khusus adalah Extra usage is required for long context requests, permintaan tersebut mencoba menggunakan jendela konteks 1M Anthropic (model Claude 4.x 1M yang mendukung GA, atau konfigurasi lama params.context1m: true), dan kredensial Anda saat ini tidak memenuhi syarat untuk penagihan konteks panjang.

Tetapkan model fallback agar OpenClaw tetap merespons saat suatu penyedia terkena batas laju. Lihat Model, OAuth, dan Penggunaan tambahan Anthropic 429 diperlukan untuk konteks panjang.

Ya. OpenClaw memiliki penyedia Amazon Bedrock (Converse) bawaan. Jika penanda env AWS tersedia (AWS_ACCESS_KEY_ID, AWS_PROFILE, AWS_BEARER_TOKEN_BEDROCK), OpenClaw secara otomatis mengaktifkan penyedia Bedrock implisit untuk penemuan model; jika tidak, tetapkan plugins.entries.amazon-bedrock.config.discovery.enabled: true atau tambahkan entri penyedia secara manual. Lihat Amazon Bedrock dan Penyedia model. Proksi kompatibel OpenAI di depan Bedrock tetap merupakan opsi yang valid jika Anda lebih memilih alur kunci terkelola.

OpenClaw mendukung OpenAI Codex melalui OAuth (masuk dengan ChatGPT). Penyiapan baru tanpa model utama menggunakan tepat openai/gpt-5.6-sol untuk autentikasi langganan ChatGPT/Codex serta eksekusi app-server Codex native. Autentikasi ulang mempertahankan model eksplisit yang sudah ada, termasuk openai/gpt-5.5. Jika ruang kerja Codex tidak menyediakan GPT-5.6, pilih openai/gpt-5.5 secara eksplisit; OpenClaw tidak menurunkan versi secara diam-diam. Referensi model berawalan Codex lama adalah konfigurasi lama yang diperbaiki oleh openclaw doctor --fix. Akses langsung dengan kunci API OpenAI tetap tersedia untuk permukaan API OpenAI non-agen dan, melalui profil kunci API openai yang diurutkan, juga untuk model agen. Lihat Penyedia model dan Orientasi awal (CLI).

openai adalah id penyedia dan profil autentikasi saat ini untuk kunci API OpenAI maupun OAuth ChatGPT/Codex—OpenAI Codex telah digabungkan ke dalamnya. Anda mungkin masih melihat prefiks lama openai-codex dalam konfigurasi lama dan peringatan migrasi:

• openai/gpt-5.6-sol = penyiapan langganan ChatGPT/Codex baru dengan runtime Codex native untuk giliran agen.
• openai/gpt-5.5 = pilihan eksplisit yang didukung untuk konfigurasi yang sudah ada atau akun tanpa akses GPT-5.6.
• Referensi model openai-codex/* lama = rute lama yang diperbaiki oleh openclaw doctor --fix.
• openai/gpt-5.5 ditambah profil kunci API openai yang diurutkan = autentikasi kunci API untuk model agen OpenAI.
• Id profil autentikasi openai-codex lama = id lama yang dimigrasikan oleh openclaw doctor --fix.

Ingin penagihan langsung OpenAI Platform? Tetapkan OPENAI_API_KEY. Ingin autentikasi langganan ChatGPT/Codex? Jalankan openclaw models auth login --provider openai. Pertahankan referensi model di bawah penyedia kanonis openai/*. Penyiapan langganan baru menggunakan tepat openai/gpt-5.6-sol; doctor memperbaiki referensi lama berawalan Codex tanpa meningkatkan pilihan eksplisit openai/gpt-5.5.

OAuth Codex menggunakan jendela kuota yang dikelola OpenAI dan bergantung pada paket, yang dapat berbeda dari pengalaman situs web/aplikasi ChatGPT, bahkan pada akun yang sama.

openclaw models status menampilkan jendela penggunaan/kuota penyedia yang saat ini terlihat, tetapi tidak menciptakan atau menormalisasi hak akses web ChatGPT menjadi akses API langsung. Untuk jalur penagihan/batas langsung OpenAI Platform, gunakan openai/* dengan kunci API.

Ya, sepenuhnya. OpenAI secara eksplisit mengizinkan penggunaan OAuth langganan di alat/alur kerja eksternal seperti OpenClaw. Orientasi awal dapat menjalankan alur OAuth untuk Anda.

Lihat OAuth, Penyedia model, dan Orientasi awal (CLI).

Gemini CLI menggunakan alur autentikasi Plugin, bukan id klien atau rahasia di openclaw.json.

1. Instal Gemini CLI secara lokal agar gemini tersedia di PATH:
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Aktifkan Plugin: openclaw plugins enable google
3. Masuk: openclaw models auth login --provider google-gemini-cli --set-default
4. Model default setelah masuk: google/gemini-3.1-pro-preview (runtime google-gemini-cli)
5. Permintaan gagal setelah masuk? Tetapkan GOOGLE_CLOUD_PROJECT atau GOOGLE_CLOUD_PROJECT_ID pada host gateway dan coba lagi.

Token OAuth disimpan dalam profil autentikasi pada host gateway. Detail: Google, Penyedia model.

Biasanya tidak. OpenClaw membutuhkan konteks besar + keamanan yang kuat; kartu kecil memotong konteks dan melewati filter keamanan sisi penyedia. Jika harus, jalankan build model terbesar yang dapat dijalankan secara lokal (LM Studio)—lihat Model lokal. Model yang lebih kecil/terkuantisasi meningkatkan risiko injeksi prompt—lihat Keamanan.

Pilih endpoint yang terikat pada wilayah. OpenRouter menyediakan opsi yang di-host di AS untuk MiniMax, Kimi, dan GLM; pilih varian yang di-host di AS untuk menjaga data tetap di dalam wilayah. Anthropic/OpenAI tetap dapat dicantumkan bersama opsi tersebut menggunakan models.mode: "merge" agar fallback tetap tersedia sembari mematuhi penyedia regional yang Anda pilih.

Tidak. OpenClaw berjalan di macOS atau Linux (Windows melalui WSL2). Mac mini adalah pilihan host selalu aktif yang populer, tetapi VPS kecil, server rumahan, atau perangkat kelas Raspberry Pi juga dapat digunakan.

Mac hanya diperlukan untuk alat khusus macOS. Untuk iMessage, gunakan iMessage dengan imsg pada Mac mana pun yang masuk ke Messages—jika Gateway berjalan di Linux atau tempat lain, tetapkan channels.imessage.cliPath ke wrapper SSH yang menjalankan imsg pada Mac tersebut. Untuk alat khusus macOS lainnya, jalankan Gateway pada Mac atau pasangkan Node macOS.

Dokumentasi: iMessage, Node, Mode jarak jauh Mac.

Anda memerlukan perangkat macOS apa pun yang masuk ke Messages—tidak harus Mac mini, Mac apa pun dapat digunakan. Gunakan iMessage dengan imsg; Gateway dapat berjalan pada Mac tersebut, atau di tempat lain dengan wrapper SSH cliPath.

Penyiapan umum:

• Gateway di Linux/VPS, channels.imessage.cliPath ditetapkan ke wrapper SSH yang menjalankan imsg pada Mac yang masuk ke Messages.
• Semuanya pada satu Mac untuk penyiapan satu mesin yang paling sederhana.

Dokumentasi: iMessage, Node, Mode jarak jauh Mac.

Ya. Mac mini dapat menjalankan Gateway, dan MacBook Pro Anda terhubung sebagai Node (perangkat pendamping). Node tidak menjalankan Gateway—Node menambahkan kemampuan seperti layar/kamera/kanvas dan system.run pada perangkat tersebut.

Pola umum: Gateway pada Mac mini yang selalu aktif; MacBook Pro menjalankan aplikasi macOS atau host Node dan berpasangan dengan Gateway. Periksa dengan openclaw nodes status / openclaw nodes list.

Dokumentasi: Node, CLI Node.

Bun dapat digunakan untuk menginstal dependensi atau menjalankan skrip paket. CLI dan Gateway OpenClaw memerlukan Node karena penyimpanan status kanonis menggunakan node:sqlite; Bun tidak menyediakan API tersebut.

channels.telegram.allowFrom adalah ID pengguna Telegram milik pengirim manusia (numerik), bukan nama pengguna bot. Penyiapan hanya meminta ID pengguna numerik; openclaw doctor --fix dapat mencoba menyelesaikan entri lama @username.

Lebih aman (tanpa bot pihak ketiga): kirim DM ke bot Anda, jalankan openclaw logs --follow, baca from.id.

Bot API resmi: kirim DM ke bot Anda, panggil https://api.telegram.org/bot<bot_token>/getUpdates, baca message.from.id.

Pihak ketiga (kurang privat): kirim DM ke @userinfobot atau @getidsbot.

Lihat Kontrol akses Telegram.

Ya, melalui perutean multi-agen. Ikat DM WhatsApp setiap pengirim (peer: { kind: "direct", id: "+15551234567" }) ke agentId yang berbeda, sehingga setiap orang memiliki ruang kerja dan penyimpanan sesi sendiri. Balasan tetap berasal dari akun WhatsApp yang sama; kontrol akses DM (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) bersifat global per akun. Lihat Perutean Multi-Agen dan WhatsApp.

Ya. Gunakan perutean multi-agen: berikan setiap agen model defaultnya sendiri, lalu ikat rute masuk (akun penyedia atau rekan tertentu) ke setiap agen. Contoh konfigurasi: Perutean Multi-Agen. Lihat juga Model dan Konfigurasi.

Ya, melalui Linuxbrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

Saat menjalankan OpenClaw melalui systemd: pastikan PATH layanan menyertakan /home/linuxbrew/.linuxbrew/bin (atau prefiks brew Anda) agar alat yang diinstal melalui brew dapat ditemukan dalam shell non-login. Build terbaru juga menambahkan direktori bin pengguna umum di awal PATH pada layanan systemd Linux (misalnya ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) dan mematuhi PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR, dan FNM_DIR saat ditetapkan.

• Instalasi yang dapat dimodifikasi (git): checkout sumber lengkap, dapat diedit, paling cocok untuk kontributor. Anda melakukan build secara lokal dan dapat menambal kode/dokumentasi.
• Instalasi npm: instalasi CLI global, tanpa repo, paling cocok untuk "langsung jalankan." Pembaruan berasal dari dist-tag npm.

Dokumentasi: Memulai, Memperbarui.

Ya, dengan openclaw update --channel ... pada instalasi yang sudah ada. Tindakan ini tidak menghapus data Anda—hanya instalasi kode OpenClaw yang berubah. Status (~/.openclaw) dan ruang kerja (~/.openclaw/workspace) tetap tidak tersentuh.

npm ke git:

openclaw update --channel dev

git ke npm:

openclaw update --channel stable

Tambahkan --dry-run untuk melihat pratinjau peralihan mode yang direncanakan terlebih dahulu. Pembaru menjalankan tindak lanjut Doctor, menyegarkan sumber plugin untuk kanal target, dan memulai ulang gateway kecuali jika Anda meneruskan --no-restart.

Penginstal juga dapat memaksakan salah satu mode:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm

Kiat pencadangan: Lokasi berbagai hal disimpan pada disk.

Menginginkan keandalan 24/7? Gunakan VPS. Menginginkan cara termudah dan tidak keberatan dengan mode tidur/mulai ulang? Jalankan secara lokal.

Laptop (Gateway lokal)

• Kelebihan: tanpa biaya server, akses langsung ke file lokal, jendela browser aktif.
• Kekurangan: mode tidur/terputusnya jaringan memutus koneksi, pembaruan/mulai ulang OS mengganggu layanan, harus tetap aktif.

VPS / cloud

• Kelebihan: selalu aktif, jaringan stabil, tanpa masalah mode tidur laptop, lebih mudah untuk terus dijalankan.
• Kekurangan: sering kali tanpa antarmuka grafis (gunakan tangkapan layar), hanya akses file jarak jauh, memerlukan SSH untuk pembaruan.

WhatsApp/Telegram/Slack/Mattermost/Discord semuanya berfungsi dengan baik dari VPS—pertimbangan utamanya adalah browser tanpa antarmuka grafis dibandingkan jendela yang terlihat. Lihat Browser.

Rekomendasi bawaan: VPS jika Anda pernah mengalami gateway terputus sebelumnya; lokal sangat cocok ketika Anda sedang aktif menggunakan Mac dan menginginkan akses file lokal atau otomatisasi UI dengan browser yang terlihat.

Tidak wajib, tetapi disarankan demi keandalan dan isolasi.

• Host khusus (VPS/Mac mini/Raspberry Pi): selalu aktif, lebih sedikit gangguan akibat mode tidur/mulai ulang, izin lebih tertata, lebih mudah untuk terus dijalankan.
• Laptop/desktop bersama: cocok untuk pengujian dan penggunaan aktif, tetapi bersiaplah menghadapi jeda saat mesin masuk mode tidur atau diperbarui.

Solusi terbaik dari keduanya: pertahankan Gateway pada host khusus dan pasangkan laptop Anda sebagai node untuk alat layar/kamera/eksekusi lokal. Lihat Node dan Keamanan.

• Minimum mutlak: 1 vCPU, RAM 1 GB, disk ~500 MB.
• Direkomendasikan: 1-2 vCPU, RAM 2 GB+ untuk kapasitas tambahan (log, media, beberapa kanal). Alat Node dan otomatisasi browser dapat menghabiskan banyak sumber daya.

OS: Ubuntu LTS (atau Debian/Ubuntu modern apa pun)—jalur instalasi Linux yang paling teruji.

Dokumentasi: Linux, Hosting VPS.

Ya. Perlakukan VM seperti VPS: VM harus selalu aktif, dapat dijangkau, dan memiliki RAM yang cukup untuk Gateway serta setiap kanal yang Anda aktifkan.

• Minimum mutlak: 1 vCPU, RAM 1 GB.
• Direkomendasikan: RAM 2 GB+ untuk beberapa kanal, otomatisasi browser, atau alat media.
• OS: Ubuntu LTS atau Debian/Ubuntu modern lainnya.

Di Windows, gunakan Windows Hub untuk penyiapan desktop, atau WSL2 untuk VM Gateway bergaya Linux dengan kompatibilitas alat yang luas. Lihat Windows, Hosting VPS. Menjalankan macOS dalam VM: lihat VM macOS.