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 lokal atau lingkungan 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 alat tersebut checkout sumber lengkap lewat instalasi yang dapat diutak-atik (git):

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

Ini memasang OpenClaw dari checkout git, sehingga agen dapat membaca kode + dokumentasi dan menalar versi persis yang sedang Anda jalankan. Anda selalu dapat beralih kembali ke stabil nanti dengan menjalankan ulang pemasang tanpa --install-method git.

Tip: 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, harap 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 status
openclaw models status
openclaw doctor

Yang dilakukan perintah tersebut:

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

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

Loop debug cepat: 60 detik pertama jika ada yang rusak. Dokumentasi instalasi: Instalasi, Flag pemasang, Memperbarui.

Alasan umum Heartbeat dilewati:

• quiet-hours: di luar jendela jam aktif yang dikonfigurasi
• empty-heartbeat-file: HEARTBEAT.md ada tetapi hanya berisi kerangka kosong/hanya header
• 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 proses heartbeat sungguhan selesai. Proses yang dilewati tidak menandai tugas sebagai selesai.

Dokumentasi: Heartbeat, Otomasi & Tugas.

Repo merekomendasikan menjalankan dari sumber dan menggunakan onboarding:

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

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

Dari sumber (kontributor/dev):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
openclaw onboard

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

Wizard membuka browser Anda dengan URL dasbor bersih (tanpa token) tepat setelah onboarding dan juga mencetak tautannya di ringkasan. Biarkan tab itu tetap 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 bernilai true, header identitas memenuhi auth Control UI/WebSocket (tanpa shared secret yang ditempel, dengan asumsi host gateway tepercaya); API HTTP 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 diserialkan sebelum pembatas failed-auth mencatatnya, sehingga percobaan ulang buruk kedua sudah dapat menampilkan retry later.
• Bind tailnet: jalankan openclaw gateway --bind tailnet --token "<token>" (atau konfigurasikan auth kata sandi), buka http://<tailscale-ip>:18789/, lalu tempel shared secret yang cocok di pengaturan dasbor.
• Reverse proxy sadar identitas: pertahankan Gateway di belakang proxy tepercaya, konfigurasikan 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 Dasbor 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 sekarang otomatis mengaktifkan persetujuan native DM-first saat channels.<channel>.execApprovals.enabled tidak disetel atau "auto".
• Saat kartu/tombol persetujuan native tersedia, UI native tersebut adalah jalur utama; agen seharusnya hanya 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: forwarding untuk routing, konfigurasi klien native untuk UX khusus channel yang lebih kaya. Lihat Persetujuan Exec.

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

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

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

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

Versi singkat: ini berfungsi, tetapi mungkin ada beberapa sisi kasar.

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

Dokumentasi: Linux, Instalasi.

Layar itu bergantung pada Gateway yang dapat dijangkau dan diautentikasi. TUI juga mengirim "Wake up, my friend!" secara otomatis pada penetasan 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 status
openclaw models status
openclaw 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 jarak jauh.

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

1. Pasang 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 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, Lokasi penyimpanan di disk, Workspace agen, Doctor, Mode remote.

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

Entri terbaru berada di bagian atas. Jika bagian teratas ditandai Unreleased, bagian bertanggal berikutnya adalah versi terbaru yang sudah dirilis. Entri dikelompokkan menurut Sorotan, Perubahan, dan Perbaikan (ditambah bagian dokumentasi/lainnya jika diperlukan).

Beberapa koneksi Comcast/Xfinity secara keliru memblokir docs.openclaw.ai melalui Xfinity Advanced Security. Nonaktifkan atau masukkan docs.openclaw.ai ke allowlist, lalu coba lagi. Harap 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. Itu 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 instalasi satu baris dan perbedaan antara beta dan dev, lihat accordion di bawah.

Beta adalah npm dist-tag beta (dapat cocok 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 lebih lanjut: Kanal pengembangan dan Flag installer.

Dua opsi:

1. Kanal dev (git checkout):

openclaw update --channel dev

Ini beralih ke cabang main dan memperbarui dari sumber.

2. Instalasi yang dapat diretas (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.git
cd openclaw
pnpm install
pnpm build

Dokumentasi: Update, Kanal pengembangan, Instal.

Panduan kasar:

• Instalasi: 2-5 menit
• Onboarding: 5-15 menit tergantung berapa banyak kanal/model yang Anda konfigurasi

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 diretas (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))) -NoOnboard
Set-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 jalurnya:

  npm config get prefix
  

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

• Tutup dan buka kembali PowerShell setelah memperbarui PATH.

Jika Anda menginginkan penyiapan Windows yang paling lancar, gunakan WSL2 alih-alih Windows native. Dokumentasi: Windows.

Ini biasanya ketidakcocokan code page konsol pada shell Windows native.

Gejala:

• Output system.run/exec merender bahasa 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 di OpenClaw terbaru, lacak/laporkan di:

• Issue #30640

Gunakan instalasi yang dapat diretas (git) agar Anda memiliki sumber lengkap dan dokumentasi secara lokal, lalu tanyakan kepada 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 lebih lanjut: Instal dan Flag installer.

Jawaban singkat: ikuti panduan Linux, lalu jalankan onboarding.

• Jalur cepat Linux + instalasi service: Linux.
• Panduan lengkap: Mulai.
• Installer + pembaruan: Instal & pembaruan.

VPS Linux apa pun bisa 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 Anda 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 itu untuk mengakses layar/kamera/canvas lokal atau menjalankan perintah di laptop Anda sambil menjaga Gateway tetap di cloud.

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

Jawaban singkat: bisa, tidak direkomendasikan. 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 update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart

Jika Anda harus mengotomatiskan dari agent:

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

Dokumentasi: Update, Memperbarui.

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

• Penyiapan model/auth (OAuth penyedia, kunci API, 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)
• Health check dan pemilihan skills

Ini juga memperingatkan jika model yang dikonfigurasi tidak dikenal atau tidak memiliki auth.

Tidak. Anda dapat menjalankan OpenClaw dengan kunci API (Anthropic/OpenAI/lainnya) atau dengan model khusus 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:

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

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

OpenClaw juga mendukung opsi bergaya langganan terhosting lain termasuk Qwen Cloud Coding Plan, MiniMax Coding Plan, dan Z.AI / GLM Coding Plan.

Dokumentasi: Anthropic, OpenAI, Qwen Cloud, MiniMax, Model GLM, Model lokal, Model.

Ya.

Staf Anthropic memberi tahu kami bahwa penggunaan Claude CLI bergaya OpenClaw diizinkan kembali, 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 dapat diprediksi, gunakan kunci API Anthropic sebagai gantinya.

Ya.

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

Setup-token Anthropic tetap tersedia sebagai jalur token OpenClaw yang didukung, tetapi OpenClaw sekarang lebih memilih penggunaan ulang Claude CLI dan claude -p bila tersedia. Untuk beban kerja produksi atau multi-pengguna, auth kunci API Anthropic tetap merupakan pilihan yang lebih aman dan lebih dapat diprediksi. Jika Anda menginginkan opsi terhosting bergaya langganan lain 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 beta konteks 1M Anthropic (context1m: true). Itu hanya berfungsi ketika kredensial Anda memenuhi syarat untuk penagihan konteks panjang (penagihan kunci API atau jalur login Claude OpenClaw dengan Extra Usage diaktifkan).

Tip: atur model fallback agar OpenClaw dapat terus membalas saat penyedia terkena batas laju. Lihat Model, OAuth, dan /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.

Ya. OpenClaw memiliki penyedia Amazon Bedrock (Converse) bawaan. Dengan penanda env AWS tersedia, OpenClaw dapat menemukan otomatis katalog streaming/teks Bedrock dan menggabungkannya sebagai penyedia implisit amazon-bedrock; jika tidak, Anda dapat mengaktifkan plugins.entries.amazon-bedrock.config.discovery.enabled secara eksplisit atau menambahkan entri penyedia manual. Lihat Amazon Bedrock dan Penyedia 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 dengan agentRuntime.id: "codex" untuk penyiapan umum: auth langganan ChatGPT/Codex plus eksekusi server aplikasi Codex native. Gunakan openai-codex/gpt-5.5 hanya saat Anda menginginkan OAuth Codex melalui runtime Codex default. Akses kunci API OpenAI langsung tetap tersedia untuk permukaan API OpenAI non-agen dan untuk model agen melalui profil kunci API openai-codex yang berurutan. Lihat Penyedia model dan Onboarding (CLI).

openai-codex adalah id penyedia dan profil auth untuk OAuth ChatGPT/Codex. Konfigurasi lama juga menggunakannya sebagai prefiks model:

• openai/gpt-5.5 = auth langganan ChatGPT/Codex dengan runtime Codex native untuk giliran agen
• openai-codex/gpt-5.5 = rute model legacy yang diperbaiki oleh openclaw doctor --fix
• openai/gpt-5.5 plus profil kunci API openai-codex yang berurutan = auth kunci API untuk model agen OpenAI
• openai-codex:... = id profil auth, bukan referensi model

Jika Anda menginginkan jalur penagihan/batas OpenAI Platform langsung, atur OPENAI_API_KEY. Jika Anda menginginkan auth langganan ChatGPT/Codex, masuk dengan openclaw models auth login --provider openai-codex. Pertahankan referensi model sebagai openai/gpt-5.5; referensi model openai-codex/* adalah konfigurasi legacy 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, bahkan ketika keduanya terikat ke akun yang sama.

OpenClaw dapat menampilkan jendela penggunaan/kuota penyedia yang saat ini terlihat di openclaw models status, tetapi tidak menciptakan 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 di alat/alur kerja eksternal seperti OpenClaw. Onboarding dapat menjalankan alur OAuth untuk Anda.

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

Gemini CLI menggunakan alur auth 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, atur GOOGLE_CLOUD_PROJECT atau GOOGLE_CLOUD_PROJECT_ID pada host gateway

Ini menyimpan token OAuth dalam profil auth pada host gateway. Detail: Penyedia model.

Biasanya tidak. OpenClaw membutuhkan konteks besar + keamanan 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 dihosting di AS untuk MiniMax, Kimi, dan GLM; pilih varian yang dihosting di AS untuk menjaga data tetap dalam wilayah. Anda masih dapat mencantumkan Anthropic/OpenAI bersama ini dengan menggunakan models.mode: "merge" agar fallback tetap tersedia sambil menghormati penyedia 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 rumah, atau perangkat kelas Raspberry Pi juga berfungsi.

Anda hanya membutuhkan Mac untuk alat khusus macOS. Untuk iMessage, gunakan BlueBubbles (direkomendasikan) - server BlueBubbles berjalan di Mac mana pun, dan Gateway dapat berjalan di Linux atau di tempat lain. Jika Anda menginginkan alat khusus macOS lainnya, jalankan Gateway di Mac atau pasangkan node macOS.

Dokumentasi: BlueBubbles, Node, Mode jarak jauh Mac.

Anda memerlukan perangkat macOS tertentu yang masuk ke Messages. Perangkat itu tidak harus Mac mini - Mac apa pun bisa. Gunakan BlueBubbles (direkomendasikan) untuk iMessage - server BlueBubbles berjalan di macOS, sementara Gateway dapat berjalan di Linux atau di tempat lain.

Penyiapan umum:

• Jalankan Gateway di Linux/VPS, dan jalankan server BlueBubbles di Mac mana pun yang masuk ke Messages.
• Jalankan semuanya di Mac jika Anda menginginkan penyiapan satu mesin yang paling sederhana.

Dokumentasi: BlueBubbles, 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 di gateway non-produksi tanpa WhatsApp/Telegram.

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

Penyiapan hanya meminta ID pengguna numerik. Jika Anda sudah memiliki entri @username legacy di 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 sesi mereka 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: beri setiap agen model defaultnya sendiri, lalu ikat rute masuk (akun penyedia atau peer tertentu) ke setiap agen. Contoh konfigurasi ada 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)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>

Jika Anda menjalankan OpenClaw melalui systemd, pastikan service PATH menyertakan /home/linuxbrew/.linuxbrew/bin (atau prefiks brew Anda) agar alat yang diinstal brew dapat ditemukan di shell non-login. Build terbaru juga menambahkan direktori bin pengguna umum di Linux systemd services di awal (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 diatur.

• Instalasi yang dapat di-hack (git): checkout sumber lengkap, dapat diedit, terbaik untuk kontributor. Anda menjalankan build secara lokal dan dapat menambal kode/dokumentasi.
• Instalasi npm: instalasi CLI global, tanpa repo, terbaik untuk "langsung jalankan saja." 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 Anda (~/.openclaw) dan workspace (~/.openclaw/workspace) 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. Updater menjalankan tindak lanjut Doctor, menyegarkan sumber plugin untuk channel target, dan me-restart gateway kecuali Anda meneruskan --no-restart.

Installer juga dapat memaksa salah satu mode:

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

Tips backup: lihat Strategi backup.

Jawaban singkat: jika Anda menginginkan keandalan 24/7, gunakan VPS. Jika Anda menginginkan hambatan paling rendah dan Anda tidak keberatan dengan sleep/restart, jalankan secara lokal.

Laptop (Gateway lokal)

• Kelebihan: tidak ada biaya server, akses langsung ke file lokal, jendela browser langsung.
• Kekurangan: mode tidur/gangguan jaringan = terputus, pembaruan/reboot OS mengganggu, harus tetap aktif.

VPS / cloud

• Kelebihan: selalu aktif, jaringan stabil, tidak ada masalah laptop tidur, lebih mudah dijaga tetap berjalan.
• Kekurangan: sering berjalan tanpa antarmuka grafis (gunakan tangkapan layar), hanya akses file 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 tanpa antarmuka grafis vs jendela yang terlihat. Lihat Browser.

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

Tidak wajib, tetapi direkomendasikan untuk keandalan dan isolasi.

• Host khusus (VPS/Mac mini/Pi): selalu aktif, lebih sedikit gangguan tidur/reboot, izin lebih bersih, lebih mudah dijaga tetap berjalan.
• Laptop/desktop bersama: sangat boleh untuk pengujian dan penggunaan aktif, tetapi perkirakan jeda saat mesin tidur atau diperbarui.

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

OpenClaw ringan. Untuk Gateway dasar + satu channel chat:

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

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

Dokumentasi: Linux, hosting VPS.

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

Panduan dasar:

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

Jika Anda menggunakan Windows, WSL2 adalah setup bergaya VM yang paling mudah dan memiliki kompatibilitas tooling terbaik. Lihat Windows, hosting VPS. Jika Anda menjalankan macOS di VM, lihat VM macOS.