FAQ: penyiapan saat pertama kali dijalankan

Gunakan agen AI lokal yang dapat melihat mesin Anda. Itu jauh lebih efektif daripada bertanya di Discord, karena sebagian besar kasus "Saya macet" adalah masalah konfigurasi atau lingkungan lokal yang tidak dapat diperiksa oleh pembantu jarak jauh.

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

Alat ini dapat membaca repo, menjalankan perintah, memeriksa log, dan membantu memperbaiki penyiapan tingkat mesin Anda (PATH, layanan, izin, file auth). Berikan kepada mereka checkout sumber lengkap melalui instalasi hackable (git):

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

Ini menginstal OpenClaw dari checkout git, sehingga agen dapat membaca kode + docs dan bernalar tentang versi persis yang sedang Anda jalankan. Anda selalu dapat kembali ke stable nanti dengan menjalankan ulang installer tanpa --install-method git.

Tips: minta agen untuk merencanakan dan mengawasi perbaikan (langkah demi langkah), lalu jalankan hanya perintah yang diperlukan. Itu menjaga perubahan tetap kecil dan lebih mudah diaudit.

Jika Anda menemukan bug atau perbaikan nyata, silakan buat issue GitHub atau kirim PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pulls

Mulai dengan perintah ini (bagikan output saat meminta bantuan):

openclaw statusopenclaw models statusopenclaw doctor

Fungsinya:

• openclaw status: snapshot cepat kesehatan gateway/agen + konfigurasi dasar.
• openclaw models status: memeriksa auth penyedia + ketersediaan model.
• openclaw doctor: memvalidasi dan memperbaiki masalah konfigurasi/state umum.

Pemeriksaan CLI berguna lainnya: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose.

Loop debug cepat: 60 detik pertama jika ada yang rusak. Docs instalasi: Instal, Flag installer, Memperbarui.

Alasan skip heartbeat umum:

• quiet-hours: di luar jendela jam aktif yang dikonfigurasi
• empty-heartbeat-file: HEARTBEAT.md ada tetapi hanya berisi scaffolding kosong, komentar, header, fence, atau checklist kosong
• no-tasks-due: mode tugas HEARTBEAT.md aktif tetapi belum ada interval tugas yang jatuh tempo
• alerts-disabled: semua visibilitas heartbeat dinonaktifkan (showOk, showAlerts, dan useIndicator semuanya mati)

Dalam mode tugas, timestamp jatuh tempo hanya dimajukan setelah heartbeat nyata selesai berjalan. Run yang dilewati tidak menandai tugas sebagai selesai.

Docs: Heartbeat, Automasi.

Repo merekomendasikan menjalankan dari sumber dan menggunakan onboarding:

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Wizard juga dapat membangun aset UI secara otomatis. Setelah onboarding, Anda biasanya menjalankan Gateway pada port 18789.

Dari sumber (kontributor/dev):

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

Jika Anda belum memiliki instalasi global, jalankan melalui pnpm openclaw onboard.

Wizard membuka browser Anda dengan URL dashboard yang bersih (tanpa token) tepat setelah onboarding dan juga mencetak tautannya di ringkasan. Biarkan tab itu terbuka; jika tidak terbuka, salin/tempel URL yang dicetak di mesin yang sama.

Localhost (mesin yang sama):

• Buka http://127.0.0.1:18789/.
• Jika meminta auth shared-secret, 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).
• Jika belum ada shared secret yang dikonfigurasi, buat token dengan openclaw doctor --generate-gateway-token.

Bukan di localhost:

• Tailscale Serve (direkomendasikan): pertahankan bind loopback, jalankan openclaw gateway --tailscale serve, buka https://<magicdns>/. Jika gateway.auth.allowTailscale adalah true, header identitas memenuhi auth Control UI/WebSocket (tanpa shared secret yang ditempel, mengasumsikan host gateway tepercaya); HTTP API tetap memerlukan auth shared-secret kecuali Anda sengaja menggunakan private-ingress none atau auth HTTP trusted-proxy. Upaya auth Serve bersamaan yang buruk dari klien yang sama diserialisasi sebelum limiter failed-auth mencatatnya, sehingga retry buruk kedua sudah dapat menampilkan retry later.
• Bind tailnet: jalankan openclaw gateway --bind tailnet --token "<token>" (atau konfigurasi auth kata sandi), buka http://<tailscale-ip>:18789/, lalu tempel shared secret yang cocok di pengaturan dashboard.
• Reverse proxy sadar identitas: pertahankan Gateway di belakang proxy tepercaya, konfigurasi gateway.auth.mode: "trusted-proxy", lalu buka URL proxy. Proxy loopback host yang sama memerlukan gateway.auth.trustedProxy.allowLoopback = true eksplisit.
• Tunnel SSH: ssh -N -L 18789:127.0.0.1:18789 user@host lalu buka http://127.0.0.1:18789/. Auth shared-secret tetap berlaku melalui tunnel; tempel token atau kata sandi yang dikonfigurasi jika diminta.

Lihat Dashboard dan Permukaan web untuk mode bind dan detail auth.

Keduanya mengontrol lapisan yang berbeda:

• approvals.exec: meneruskan prompt persetujuan ke tujuan chat
• channels.<channel>.execApprovals: membuat channel tersebut bertindak sebagai klien persetujuan native untuk persetujuan exec

Kebijakan exec host tetap menjadi gerbang persetujuan yang sebenarnya. Konfigurasi chat hanya mengontrol di mana prompt persetujuan muncul dan bagaimana orang dapat menjawabnya.

Di sebagian besar penyiapan, Anda tidak memerlukan keduanya:

• Jika chat sudah mendukung perintah dan balasan, /approve di chat yang sama berfungsi melalui jalur bersama.
• Jika channel native yang didukung dapat menyimpulkan pemberi persetujuan dengan aman, OpenClaw kini otomatis mengaktifkan persetujuan native yang memprioritaskan DM saat channels.<channel>.execApprovals.enabled tidak disetel atau "auto".
• Saat kartu/tombol persetujuan native tersedia, UI native tersebut adalah jalur utama; agen hanya boleh menyertakan perintah manual /approve jika hasil alat mengatakan persetujuan chat tidak tersedia atau persetujuan manual adalah satu-satunya jalur.
• Gunakan approvals.exec hanya saat prompt juga harus diteruskan ke chat lain atau ruang ops eksplisit.
• Gunakan channels.<channel>.execApprovals.target: "channel" atau "both" hanya saat Anda secara eksplisit ingin prompt persetujuan diposting kembali ke ruang/topik asal.
• Persetujuan Plugin terpisah lagi: secara default menggunakan /approve di chat yang sama, penerusan approvals.plugin opsional, dan hanya beberapa channel native yang mempertahankan penanganan plugin-approval-native di atasnya.

Versi singkat: penerusan adalah untuk routing, konfigurasi klien native adalah untuk UX khusus channel yang lebih kaya. Lihat Persetujuan Exec.

Node >= 22 diperlukan. pnpm direkomendasikan. Bun tidak direkomendasikan untuk Gateway.

Ya. Gateway ringan - docs mencantumkan 512MB-1GB RAM, 1 core, dan sekitar 500MB disk sebagai cukup untuk penggunaan pribadi, dan mencatat bahwa Raspberry Pi 4 dapat menjalankannya.

Jika Anda ingin headroom ekstra (log, media, layanan lain), 2GB direkomendasikan, tetapi itu bukan minimum keras.

Tips: Raspberry Pi/VPS kecil dapat meng-host Gateway, dan Anda dapat memasangkan node di laptop/ponsel Anda untuk layar/kamera/kanvas lokal atau eksekusi perintah. Lihat Node.

Versi singkat: ini berfungsi, tetapi perkirakan ada bagian yang belum mulus.

• Gunakan OS 64-bit dan pertahankan Node >= 22.
• Lebih baik gunakan instalasi hackable (git) agar Anda dapat melihat log dan memperbarui dengan cepat.
• Mulai tanpa channel/skills, lalu tambahkan satu per satu.
• Jika Anda mengalami masalah binary yang aneh, biasanya itu adalah masalah kompatibilitas ARM.

Docs: Linux, Instal.

Layar itu bergantung pada Gateway yang dapat dijangkau dan diautentikasi. TUI juga mengirim "Wake up, my friend!" secara otomatis pada hatch pertama. Jika Anda melihat baris itu dengan tanpa balasan dan token tetap 0, agen tidak pernah berjalan.

1. Mulai ulang Gateway:

openclaw gateway restart

2. Periksa status + auth:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Jika masih macet, jalankan:

openclaw doctor

Jika Gateway remote, pastikan koneksi tunnel/Tailscale aktif dan UI diarahkan ke Gateway yang benar. Lihat Akses remote.

Bisa. Salin direktori state dan workspace, lalu jalankan Doctor sekali. Ini menjaga bot Anda "persis sama" (memori, riwayat sesi, auth, dan state channel) selama Anda menyalin kedua lokasi:

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

Itu mempertahankan konfigurasi, profil auth, kredensial WhatsApp, sesi, dan memori. Jika Anda berada dalam mode remote, ingat bahwa host gateway memiliki penyimpanan sesi dan workspace.

Penting: jika Anda hanya commit/push workspace Anda ke GitHub, Anda mencadangkan memori + file bootstrap, tetapi bukan riwayat sesi atau auth. Itu berada di bawah ~/.openclaw/ (misalnya ~/.openclaw/agents/<agentId>/sessions/).

Terkait: Migrasi, Di mana hal-hal berada di disk, Workspace agen, Doctor, Mode remote.

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

Entri terbaru ada di bagian atas. Jika bagian teratas ditandai Unreleased, bagian bertanggal berikutnya adalah versi rilis terbaru. Entri dikelompokkan berdasarkan Highlights, Changes, dan Fixes (ditambah bagian docs/lainnya saat diperlukan).

Beberapa koneksi Comcast/Xfinity secara keliru memblokir docs.openclaw.ai melalui Xfinity Advanced Security. Nonaktifkan atau allowlist docs.openclaw.ai, lalu coba lagi. Mohon bantu kami membuka blokirnya dengan melaporkan di sini: https://spa.xfinity.com/check_url_status.

Jika Anda masih tidak dapat mengakses situs, dokumentasi dicerminkan di GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Stable dan beta adalah npm dist-tags, bukan baris kode terpisah:

• latest = stable
• beta = build awal untuk pengujian

Biasanya, rilis stable masuk ke beta terlebih dahulu, lalu langkah promosi eksplisit memindahkan versi yang sama itu ke latest. Maintainer juga dapat menerbitkan langsung ke latest bila diperlukan. Itulah sebabnya beta dan stable dapat menunjuk ke versi yang sama setelah promosi.

Lihat apa yang berubah: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Untuk perintah instal satu baris dan perbedaan antara beta dan dev, lihat accordion di bawah.

Beta adalah npm dist-tag beta (dapat sama dengan latest setelah promosi). Dev adalah head bergerak dari main (git); saat diterbitkan, ia menggunakan npm 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

Installer Windows (PowerShell): https://openclaw.ai/install.ps1

Detail selengkapnya: Kanal pengembangan dan Flag installer.

Dua opsi:

1. Kanal dev (git checkout):

openclaw update --channel dev

Ini beralih ke branch main dan memperbarui dari sumber.

2. Instalasi yang dapat diutak-atik (dari situs installer):

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

Itu memberi Anda repo lokal yang dapat Anda edit, lalu perbarui melalui git.

Jika Anda lebih suka clone bersih secara manual, gunakan:

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

Dokumentasi: Pembaruan, Kanal pengembangan, Instal.

Panduan kasar:

• Instalasi: 2-5 menit
• Onboarding QuickStart: biasanya beberapa menit
• Onboarding lengkap: lebih lama ketika masuk ke penyedia, pairing kanal, instalasi daemon, unduhan jaringan, skills, atau plugin opsional memerlukan penyiapan tambahan

Wizard CLI menampilkan linimasa ini di awal. Anda dapat melewati langkah opsional dan kembali nanti dengan openclaw configure.

Jika macet, gunakan Installer macet dan loop debug cepat di Saya macet.

Jalankan ulang installer dengan output verbose:

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

Instalasi beta dengan verbose:

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

Untuk instalasi yang dapat diutak-atik (git):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

Padanan Windows (PowerShell):

# install.ps1 has no dedicated -Verbose flag yet.Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0

Opsi lainnya: Flag installer.

Dua masalah umum Windows:

1) npm error spawn git / git tidak ditemukan

• Instal Git for Windows dan pastikan git ada di PATH Anda.
• Tutup dan buka kembali PowerShell, lalu jalankan ulang installer.

2) openclaw tidak dikenali setelah instalasi

• Folder bin global npm Anda tidak ada di PATH.

• Periksa path:

  npm config get prefix

• Tambahkan direktori tersebut ke PATH pengguna Anda (tidak perlu akhiran \bin di Windows; pada sebagian besar sistem nilainya adalah %AppData%\npm).

• Tutup dan buka kembali PowerShell setelah memperbarui PATH.

Untuk penyiapan desktop, gunakan aplikasi native Windows Hub. Untuk penyiapan hanya-terminal, installer PowerShell dan jalur WSL2 Gateway keduanya didukung. Dokumentasi: Windows.

Ini biasanya ketidakcocokan code page konsol pada shell Windows native.

Gejala:

• Output system.run/exec merender Mandarin sebagai mojibake
• Perintah yang sama terlihat baik di profil terminal lain

Solusi cepat di PowerShell:

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

Lalu mulai ulang Gateway dan coba kembali perintah Anda:

openclaw gateway restart

Jika Anda masih dapat mereproduksi ini pada OpenClaw terbaru, lacak/laporkan di:

• Issue #30640

Gunakan instalasi yang dapat diutak-atik (git) sehingga Anda memiliki seluruh sumber dan dokumentasi secara lokal, lalu tanyakan bot Anda (atau Claude/Codex) dari folder itu agar dapat membaca repo dan menjawab dengan tepat.

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

Detail selengkapnya: Instal dan Flag installer.

Jawaban singkat: ikuti panduan Linux, lalu jalankan onboarding.

• Jalur cepat Linux + instalasi layanan: Linux.
• Panduan lengkap: Memulai.
• Installer + pembaruan: Instal & pembaruan.

VPS Linux apa pun dapat digunakan. Instal di server, lalu gunakan SSH/Tailscale untuk mengakses Gateway.

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

Kami menyediakan hub hosting dengan penyedia umum. Pilih satu dan ikuti panduannya:

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

Cara kerjanya di cloud: Gateway berjalan di server, dan Anda mengaksesnya dari laptop/ponsel melalui Control UI (atau Tailscale/SSH). State + workspace Anda berada di server, jadi perlakukan host sebagai sumber kebenaran dan cadangkan.

Anda dapat memasangkan node (Mac/iOS/Android/headless) ke Gateway cloud tersebut untuk mengakses layar/kamera/canvas lokal atau menjalankan perintah di laptop sambil tetap menjalankan Gateway di cloud.

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

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

Gunakan CLI:

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

Jika Anda harus mengotomatiskan dari agen:

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

Dokumentasi: Pembaruan, Memperbarui.

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

• Penyiapan model/auth (OAuth penyedia, API key, setup-token Anthropic, plus opsi model lokal seperti LM Studio)
• Lokasi workspace + file bootstrap
• Pengaturan Gateway (bind/port/auth/tailscale)
• Kanal (WhatsApp, Telegram, Discord, Mattermost, Signal, iMessage, plus plugin kanal bawaan seperti QQ Bot)
• Instalasi daemon (LaunchAgent di macOS; unit pengguna systemd di Linux/WSL2)
• Pemilihan health check dan skills

Ini juga menetapkan ekspektasi durasi sebelum prompt utama dimulai dan memperingatkan jika model yang dikonfigurasi tidak dikenal atau auth tidak ada.

Tidak. Anda dapat menjalankan OpenClaw dengan API key (Anthropic/OpenAI/lainnya) atau dengan model hanya-lokal agar data Anda tetap berada di perangkat Anda. Langganan (Claude Pro/Max atau OpenAI Codex) adalah cara opsional untuk mengautentikasi penyedia tersebut.

Untuk Anthropic di OpenClaw, pembagian praktisnya adalah:

• API key Anthropic: billing API Anthropic normal
• Claude CLI / auth langganan Claude di OpenClaw: staf Anthropic memberi tahu kami bahwa penggunaan ini diizinkan lagi, dan OpenClaw memperlakukan penggunaan claude -p sebagai disetujui untuk integrasi ini kecuali Anthropic menerbitkan kebijakan baru

Untuk host gateway jangka panjang, API key Anthropic masih merupakan penyiapan yang lebih mudah diprediksi. OAuth OpenAI Codex didukung secara eksplisit untuk alat eksternal seperti OpenClaw.

OpenClaw juga mendukung opsi lain yang dihosting bergaya 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.

Staf Anthropic memberi tahu kami bahwa penggunaan Claude CLI bergaya OpenClaw diizinkan lagi, jadi OpenClaw memperlakukan auth langganan Claude dan penggunaan claude -p sebagai disetujui untuk integrasi ini kecuali Anthropic menerbitkan kebijakan baru. Jika Anda menginginkan penyiapan sisi-server yang paling mudah diprediksi, gunakan API key Anthropic sebagai gantinya.

Ya.

Staf Anthropic memberi tahu kami bahwa penggunaan ini diizinkan lagi, jadi OpenClaw memperlakukan penggunaan ulang Claude CLI dan penggunaan claude -p sebagai disetujui untuk integrasi ini kecuali Anthropic menerbitkan kebijakan baru.

Setup-token Anthropic masih tersedia sebagai jalur token OpenClaw yang didukung, tetapi OpenClaw sekarang lebih memilih penggunaan ulang Claude CLI dan claude -p jika tersedia. Untuk beban kerja produksi atau multi-pengguna, auth API key Anthropic masih menjadi pilihan yang lebih aman dan lebih mudah diprediksi. Jika Anda menginginkan opsi lain yang dihosting bergaya langganan di OpenClaw, lihat OpenAI, Qwen / Model Cloud, MiniMax, dan Model GLM.

Itu berarti kuota/batas laju Anthropic Anda habis untuk jendela saat ini. Jika Anda menggunakan Claude CLI, tunggu sampai jendela direset atau tingkatkan paket Anda. Jika Anda menggunakan kunci API Anthropic, periksa Anthropic Console untuk penggunaan/penagihan dan naikkan batas sesuai kebutuhan.

Jika pesannya secara spesifik: Extra usage is required for long context requests, permintaan tersebut mencoba menggunakan jendela konteks 1M Anthropic (model Claude 4.x 1M berkemampuan GA atau konfigurasi lama context1m: true). Itu hanya berfungsi saat kredensial Anda memenuhi syarat untuk penagihan konteks panjang (penagihan kunci API atau jalur login Claude OpenClaw dengan Extra Usage diaktifkan).

Kiat: tetapkan model fallback agar OpenClaw dapat tetap membalas saat sebuah provider dibatasi lajunya. Lihat Model, OAuth, dan /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Ya. OpenClaw memiliki provider Amazon Bedrock (Converse) bawaan. Dengan penanda env AWS yang tersedia, OpenClaw dapat otomatis menemukan katalog streaming/teks Bedrock dan menggabungkannya sebagai provider amazon-bedrock implisit; jika tidak, Anda dapat mengaktifkan plugins.entries.amazon-bedrock.config.discovery.enabled secara eksplisit atau menambahkan entri provider manual. Lihat Amazon Bedrock dan Provider model. Jika Anda lebih memilih alur kunci terkelola, proxy yang kompatibel dengan OpenAI di depan Bedrock tetap merupakan opsi yang valid.

OpenClaw mendukung OpenAI Code (Codex) melalui OAuth (masuk ChatGPT). Gunakan openai/gpt-5.5 untuk penyiapan umum: autentikasi langganan ChatGPT/Codex plus eksekusi app-server Codex native. Referensi GPT 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 untuk model agen melalui profil kunci API openai yang diurutkan. Lihat Provider model dan Onboarding (CLI).

openai adalah id provider dan profil autentikasi untuk kunci API OpenAI maupun OAuth ChatGPT/Codex. Anda mungkin masih melihat prefiks lama OpenAI Codex dalam konfigurasi lama dan peringatan migrasi. Konfigurasi lama juga menggunakannya sebagai prefiks model:

• openai/gpt-5.5 = autentikasi langganan ChatGPT/Codex dengan runtime Codex native untuk giliran agen
• referensi GPT-5.5 Codex lama = rute model lama yang diperbaiki oleh openclaw doctor --fix
• openai/gpt-5.5 plus profil kunci API openai yang diurutkan = autentikasi kunci API untuk model agen OpenAI
• id profil autentikasi Codex lama = id profil autentikasi lama yang dimigrasikan oleh openclaw doctor --fix

Jika Anda menginginkan jalur penagihan/batas OpenAI Platform langsung, tetapkan OPENAI_API_KEY. Jika Anda menginginkan autentikasi langganan ChatGPT/Codex, masuk dengan openclaw models auth login --provider openai. Pertahankan referensi model sebagai openai/gpt-5.5; referensi model Codex lama adalah konfigurasi lama yang ditulis ulang oleh openclaw doctor --fix.

OAuth Codex menggunakan jendela kuota yang dikelola OpenAI dan bergantung pada paket. Dalam praktiknya, batas tersebut dapat berbeda dari pengalaman situs web/aplikasi ChatGPT, meskipun keduanya terhubung ke akun yang sama.

OpenClaw dapat menampilkan jendela penggunaan/kuota provider yang saat ini terlihat di openclaw models status, tetapi tidak membuat atau menormalkan hak ChatGPT-web menjadi akses API langsung. Jika Anda menginginkan jalur penagihan/batas OpenAI Platform langsung, gunakan openai/* dengan kunci API.

Ya. OpenClaw sepenuhnya mendukung OAuth langganan OpenAI Code (Codex). OpenAI secara eksplisit mengizinkan penggunaan OAuth langganan dalam alat/alur kerja eksternal seperti OpenClaw. Onboarding dapat menjalankan alur OAuth untuk Anda.

Lihat OAuth, Provider model, dan Onboarding (CLI).

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

Langkah-langkah:

1. Instal Gemini CLI secara lokal agar gemini ada di PATH
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Aktifkan Plugin: openclaw plugins enable google
3. Login: openclaw models auth login --provider google-gemini-cli --set-default
4. Model default setelah login: google-gemini-cli/gemini-3-flash-preview
5. Jika permintaan gagal, tetapkan GOOGLE_CLOUD_PROJECT atau GOOGLE_CLOUD_PROJECT_ID pada host gateway

Ini menyimpan token OAuth dalam profil autentikasi di host gateway. Detail: Provider model.

Biasanya tidak. OpenClaw membutuhkan konteks besar + keamanan yang kuat; kartu kecil memotong dan membocorkan. Jika harus, jalankan build model terbesar yang dapat Anda jalankan secara lokal (LM Studio) dan lihat /gateway/local-models. Model yang lebih kecil/terkuantisasi meningkatkan risiko injeksi prompt - lihat Keamanan.

Pilih endpoint yang dipatok wilayah. OpenRouter menyediakan opsi yang di-host di AS untuk MiniMax, Kimi, dan GLM; pilih varian yang di-host di AS agar data tetap di dalam wilayah. Anda masih dapat mencantumkan Anthropic/OpenAI bersama ini dengan menggunakan models.mode: "merge" sehingga fallback tetap tersedia sambil menghormati provider regional yang Anda pilih.

Tidak. OpenClaw berjalan di macOS atau Linux (Windows melalui WSL2). Mac mini bersifat opsional - sebagian orang membelinya sebagai host yang selalu aktif, tetapi VPS kecil, server rumahan, atau kotak sekelas Raspberry Pi juga bisa.

Anda hanya membutuhkan Mac untuk alat khusus macOS. Untuk iMessage, gunakan iMessage dengan imsg pada Mac apa 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. Jika Anda menginginkan alat khusus macOS lainnya, jalankan Gateway di Mac atau pasangkan node macOS.

Dokumentasi: iMessage, Node, Mode jarak jauh Mac.

Anda membutuhkan perangkat macOS apa pun yang masuk ke Messages. Itu tidak harus Mac mini - Mac apa pun bisa. Gunakan iMessage dengan imsg; Gateway dapat berjalan di Mac tersebut, atau dapat berjalan di tempat lain dengan wrapper SSH cliPath.

Penyiapan umum:

• Jalankan Gateway di Linux/VPS, dan tetapkan channels.imessage.cliPath ke wrapper SSH yang menjalankan imsg pada Mac yang masuk ke Messages.
• Jalankan semuanya di Mac jika Anda menginginkan penyiapan satu mesin yang paling sederhana.

Dokumentasi: iMessage, Node, Mode jarak jauh Mac.

Ya. Mac mini dapat menjalankan Gateway, dan MacBook Pro Anda dapat terhubung sebagai node (perangkat pendamping). Node tidak menjalankan Gateway - node menyediakan kemampuan tambahan seperti layar/kamera/canvas dan system.run pada perangkat tersebut.

Pola umum:

• Gateway di Mac mini (selalu aktif).
• MacBook Pro menjalankan aplikasi macOS atau host node dan dipasangkan ke Gateway.
• Gunakan openclaw nodes status / openclaw nodes list untuk melihatnya.

Dokumentasi: Node, CLI Node.

Bun tidak direkomendasikan. Kami melihat bug runtime, terutama dengan WhatsApp dan Telegram. Gunakan Node untuk gateway yang stabil.

Jika Anda tetap ingin bereksperimen dengan Bun, lakukan pada gateway non-produksi tanpa WhatsApp/Telegram.

channels.telegram.allowFrom adalah ID pengguna Telegram pengirim manusia (numerik). Itu bukan nama pengguna bot.

Penyiapan hanya meminta ID pengguna numerik. Jika Anda sudah memiliki entri @username lama dalam konfigurasi, openclaw doctor --fix dapat mencoba menyelesaikannya.

Lebih aman (tanpa bot pihak ketiga):

• DM bot Anda, lalu jalankan openclaw logs --follow dan baca from.id.

API Bot resmi:

• DM bot Anda, lalu panggil https://api.telegram.org/bot<bot_token>/getUpdates dan baca message.from.id.

Pihak ketiga (kurang privat):

• DM @userinfobot atau @getidsbot.

Lihat /channels/telegram.

Ya, melalui routing multi-agen. Ikat DM WhatsApp setiap pengirim (peer kind: "direct", pengirim E.164 seperti +15551234567) ke agentId yang berbeda, sehingga setiap orang mendapatkan workspace dan penyimpanan sesinya sendiri. Balasan tetap berasal dari akun WhatsApp yang sama, dan kontrol akses DM (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) bersifat global per akun WhatsApp. Lihat Routing Multi-Agen dan WhatsApp.

Ya. Gunakan routing multi-agen: berikan setiap agen model defaultnya sendiri, lalu ikat rute masuk (akun provider atau peer tertentu) ke setiap agen. Contoh konfigurasi tersedia di Routing Multi-Agen. Lihat juga Model dan Konfigurasi.

Ya. Homebrew mendukung Linux (Linuxbrew). Penyiapan cepat:

/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>

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

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

Dokumentasi: Memulai, Memperbarui.

Ya. Gunakan openclaw update --channel ... saat OpenClaw sudah terinstal. Ini tidak menghapus data Anda - ini hanya mengubah instalasi kode OpenClaw. State (~/.openclaw) dan workspace (~/.openclaw/workspace) Anda tetap tidak tersentuh.

Dari npm ke git:

openclaw update --channel dev

Dari git ke npm:

openclaw update --channel stable

Tambahkan --dry-run untuk meninjau peralihan mode yang direncanakan terlebih dahulu. Pembaru menjalankan tindak lanjut Doctor, menyegarkan sumber Plugin untuk kanal target, dan memulai ulang Gateway kecuali Anda meneruskan --no-restart.

Penginstal juga dapat memaksa salah satu mode:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Kiat pencadangan: lihat Strategi pencadangan.

Jawaban singkat: jika Anda menginginkan keandalan 24/7, gunakan VPS. Jika Anda menginginkan gesekan terendah 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 langsung.
• Kekurangan: tidur/jaringan terputus = koneksi terputus, pembaruan/reboot OS mengganggu, harus tetap menyala.

VPS / cloud

• Kelebihan: selalu aktif, jaringan stabil, tidak ada masalah laptop tidur, lebih mudah dipertahankan tetap berjalan.
• Kekurangan: sering berjalan headless (gunakan tangkapan layar), akses file hanya jarak jauh, Anda harus SSH untuk pembaruan.

Catatan khusus OpenClaw: WhatsApp/Telegram/Slack/Mattermost/Discord semuanya berfungsi baik dari VPS. Satu-satunya trade-off nyata adalah browser headless vs jendela yang terlihat. Lihat Browser.

Default yang disarankan: VPS jika Anda pernah mengalami Gateway terputus sebelumnya. Lokal sangat baik saat Anda aktif menggunakan Mac dan menginginkan akses file lokal atau otomatisasi UI dengan browser yang terlihat.

Tidak wajib, tetapi disarankan untuk keandalan dan isolasi.

• Host khusus (VPS/Mac mini/Raspberry Pi): selalu aktif, lebih sedikit gangguan tidur/reboot, izin lebih bersih, lebih mudah dipertahankan tetap berjalan.
• Laptop/desktop bersama: sepenuhnya memadai untuk pengujian dan penggunaan aktif, tetapi siap menghadapi jeda saat mesin tidur atau diperbarui.

Jika Anda menginginkan yang terbaik dari keduanya, jalankan Gateway di host khusus dan pasangkan laptop Anda sebagai node untuk alat layar/kamera/exec lokal. Lihat Node. Untuk panduan keamanan, baca Keamanan.

OpenClaw ringan. Untuk Gateway dasar + satu kanal chat:

• Minimum absolut: 1 vCPU, RAM 1GB, disk ~500MB.
• Disarankan: 1-2 vCPU, RAM 2GB atau lebih untuk ruang cadangan (log, media, beberapa kanal). Alat Node dan otomatisasi browser dapat memakan banyak sumber daya.

OS: gunakan Ubuntu LTS (atau Debian/Ubuntu modern apa pun). Jalur instal Linux paling teruji di sana.

Dokumen: Linux, Hosting VPS.

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

Panduan dasar:

• Minimum absolut: 1 vCPU, RAM 1GB.
• Disarankan: RAM 2GB atau lebih jika Anda menjalankan beberapa kanal, otomatisasi browser, atau alat media.
• OS: Ubuntu LTS atau Debian/Ubuntu modern lainnya.

Jika Anda menggunakan Windows, gunakan Windows Hub untuk penyiapan desktop, atau WSL2 saat Anda secara khusus menginginkan VM Gateway bergaya Linux dengan kompatibilitas tooling yang luas. Lihat Windows, Hosting VPS. Jika Anda menjalankan macOS di VM, lihat VM macOS.