Cara Menyelesaikan CAPTCHA di OpenClaw: Panduan Langkah demi Langkah dengan Ekstensi CapSolver

Pendahuluan

Ketika asisten AI Anda menjelajahi web untuk Anda, CAPTCHA adalah hambatan utama. Halaman yang dilindungi memblokir agen, formulir tidak dapat dikirim, dan tugas terhenti menunggu intervensi manusia.

OpenClaw adalah asisten AI pribadi yang dapat menjelajahi web, mengisi formulir, mengklik tombol, dan mengekstrak data — semuanya melalui bahasa alami. Namun, seperti otomatisasi browser lainnya, ia terjebak pada CAPTCHA.

CapSolver mengubah ini secara total. Dengan memuat ekstensi CapSolver Chrome ke dalam browser OpenClaw, CAPTCHA diselesaikan secara otomatis dan tidak terlihat di latar belakang. Tidak ada kode. Tidak ada panggilan API dari pihak Anda. Tidak ada perubahan cara Anda berbicara dengan asisten AI Anda.

Bagian terbaiknya? Anda bahkan tidak perlu menyebutkan CAPTCHA kepada AI. Anda hanya perlu memberitahu agen untuk menunggu sejenak sebelum mengirimkan — dan ketika agen mengklik Kirim, CAPTCHA sudah terselesaikan.

Apa itu OpenClaw?

OpenClaw adalah asisten AI pribadi yang Anda jalankan di perangkat Anda sendiri. Ia menjawab Anda melalui saluran yang sudah Anda gunakan — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Google Chat, Microsoft Teams, dan lainnya.

Fitur Utama

• Inbox multi-channel: Berbicara dengan AI Anda melalui WhatsApp, Discord, Telegram, Slack, dan lainnya
• Browser bawaan: Agen dapat membuka tab, menavigasi halaman, mengklik tombol, mengisi formulir, dan mengambil screenshot
• Berbasis lokal: Berjalan di perangkat keras Anda sendiri — data Anda tetap bersama Anda
• Sistem plugin: Perluas dengan ekstensi dan integrasi khusus
• Dukungan suara: Berbicara dengan agen Anda di macOS, iOS, dan Android

Alat Browser

OpenClaw menjalankan profil browser Chromium khusus yang hanya dikendalikan oleh agen. Ia sepenuhnya terisolasi dari browser pribadi Anda. Agen dapat:

• Membuka dan menavigasi ke URL apa pun
• Membaca konten halaman dan mengambil snapshot
• Mengklik tombol, mengisi formulir, memilih dropdown
• Mengambil screenshot dan menghasilkan PDF
• Mengelola beberapa tab

Bayangkan sebagai memberikan jendela browser sendiri kepada asisten AI Anda.

Apa itu CapSolver?

CapSolver adalah layanan penyelesaian CAPTCHA yang terkemuka yang menyediakan solusi berbasis AI untuk melewati berbagai tantangan CAPTCHA. Dengan dukungan untuk berbagai jenis CAPTCHA dan waktu respons cepat, CapSolver terintegrasi dengan mulus ke dalam alur kerja otomatis.

Jenis CAPTCHA yang Didukung

• reCAPTCHA v2 (berbasis gambar & tidak terlihat)
• reCAPTCHA v3 & v3 Enterprise
• Cloudflare Turnstile
• Cloudflare 5-second Challenge
• AWS WAF CAPTCHA
• CAPTCHA dan mekanisme anti-bot lainnya yang umum digunakan

Mengapa Integrasi Ini Berbeda

Kebanyakan integrasi penyelesaian CAPTCHA memerlukan Anda untuk menulis kode — membuat panggilan API, memantau hasil, menyisipkan token ke bidang formulir tersembunyi. Itu cara kerjanya dengan alat seperti Crawlee, Puppeteer, atau Playwright.

OpenClaw + CapSolver secara fundamental berbeda:

Insight utama: Ekstensi CapSolver Chrome berjalan di dalam sesi browser agen. Ketika agen menavigasi ke halaman dengan CAPTCHA, ekstensi mendeteksinya, menyelesaikannya di latar belakang, dan menyisipkan token — semua sebelum agen bahkan mencoba mengirimkan formulir.

Anda hanya perlu memberinya waktu. Daripada memberi tahu AI "selesaikan CAPTCHA", Anda cukup berkata:

"Pergi ke halaman itu, tunggu 60 detik, lalu klik Kirim."

Itu saja. AI tidak perlu tahu tentang CapSolver sama sekali.

Prasyarat

Sebelum mengatur integrasi, pastikan Anda memiliki:

1. OpenClaw terinstal dan gateway berjalan
2. Akun CapSolver dengan kunci API (daftar di sini)
3. Chromium atau Chrome untuk Pengujian (lihat catatan penting di bawah ini)

Penting: Anda Membutuhkan Chromium, Bukan Google Chrome

Google Chrome 137+ (dirilis pertengahan 2025) secara diam-diam menghapus dukungan untuk --load-extension dalam build yang diberi merek. Ini berarti ekstensi Chrome tidak dapat dimuat dalam sesi otomatis menggunakan Chrome standar. Tidak ada kesalahan — flag tersebut hanya diabaikan.

Ini memengaruhi Google Chrome dan Microsoft Edge. Anda harus menggunakan salah satu alternatif berikut:

Cara menginstal Chrome untuk Pengujian:

# Opsi 1: Melalui Playwright (direkomendasikan)
npx playwright install chromium

# Jalur biner akan berada di path seperti:
# ~/.cache/ms-playwright/chromium-XXXX/chrome-linux64/chrome  (Linux)
# ~/Library/Caches/ms-playwright/chromium-XXXX/chrome-mac/Chromium.app/Contents/MacOS/Chromium  (macOS)

# Opsi 2: Melalui unduhan langsung Chrome untuk Pengujian
# Kunjungi: https://googlechromelabs.github.io/chrome-for-testing/
# Unduh versi yang sesuai dengan sistem operasi Anda

Setelah instalasi, catat jalur lengkap ke biner — Anda akan membutuhkannya untuk konfigurasi.

Pemutaran Langkah demi Langkah

Langkah 1: Unduh Ekstensi CapSolver Chrome

Unduh ekstensi CapSolver Chrome dan ekstrak ke ~/.openclaw/capsolver-extension/:

1. Kunjungi rilis ekstensi CapSolver di GitHub
2. Unduh versi terbaru CapSolver.Browser.Extension-chrome-vX.X.X.zip
3. Ekstrak zip tersebut:

mkdir -p ~/.openclaw/capsolver-extension
unzip CapSolver.Browser.Extension-chrome-v*.zip -d ~/.openclaw/capsolver-extension/

4. Verifikasi ekstraksi berhasil:

ls ~/.openclaw/capsolver-extension/manifest.json

Anda seharusnya melihat manifest.json — ini memastikan ekstensi berada di tempat yang benar.

Langkah 2: Atur Kunci API CapSolver Anda

Buka file konfigurasi ekstensi di ~/.openclaw/capsolver-extension/assets/config.js dan ganti nilai apiKey dengan kunci Anda sendiri:

export const defaultConfig = {
  apiKey: 'CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',  // ← masukkan kunci Anda di sini
  useCapsolver: true,
  // ... konfigurasi lainnya
};

Anda dapat mendapatkan kunci API dari dashboard CapSolver.

Langkah 3: Konfigurasi Browser

Edit file konfigurasi OpenClaw Anda di ~/.openclaw/openclaw.json untuk mengaktifkan browser dan memuat ekstensi:

{
  "browser": {
    "enabled": true,
    "executablePath": "/path/to/chrome-for-testing/chrome",
    "extensions": [
      "~/.openclaw/capsolver-extension"
    ],
    "noSandbox": true,
    "defaultProfile": "openclaw"
  }
}

Ganti /path/to/chrome-for-testing/chrome dengan jalur sebenarnya ke biner Chrome untuk Pengujian atau Chromium Anda. Contohnya:

• Linux (Playwright): ~/.cache/ms-playwright/chromium-1200/chrome-linux64/chrome
• macOS (Playwright): ~/Library/Caches/ms-playwright/chromium-1200/chrome-mac/Chromium.app/Contents/MacOS/Chromium

Catatan: noSandbox: true diperlukan di sebagian besar lingkungan server, kontainer Docker, dan sistem CI di mana sandbox Chrome tidak dapat diinisialisasi. Di sistem desktop dengan sandboxing yang tepat, Anda dapat menghilangkan ini.

Langkah 4: Restart Gateway

# Jika menggunakan PM2:
pm2 restart opencrawl --update-env

# Jika dijalankan langsung:
openclaw gateway restart

Langkah 5: Verifikasi Pemutaran

Periksa log gateway untuk memastikan semuanya dimuat dengan benar:

pm2 logs opencrawl --lines 20 --nostream

Anda seharusnya melihat baris kunci ini:

[browser/chrome] Memuat 1 ekstensi(s)
[browser/chrome] Memulai Chrome: /path/to/chrome-for-testing (arg: 15)

Pemeriksaan lanjutan — verifikasi ekstensi aktif melalui Chrome DevTools Protocol:

curl -s http://127.0.0.1:8091/json/list

Cari entri service_worker dengan chrome-extension:// dalam URL:

{
  "title": "Service Worker chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js",
  "type": "service_worker",
  "url": "chrome-extension://cnopfoopenkdblckmekkipihdnambjhf/background.js"
}

Jika Anda melihat ini, CapSolver dimuat dan berjalan.

Cara Menggunakannya

Ini adalah bagian yang paling penting. Setelah pemutaran selesai, menggunakan CapSolver dengan OpenClaw adalah sangat sederhana.

Aturan Emas

Jangan sebutkan CAPTCHA atau CapSolver kepada AI. Berikan saja waktu sebelum mengirim formulir.

Agen AI tidak perlu tahu tentang CAPTCHA. Ekstensi menangani semuanya di latar belakang. Yang Anda butuhkan hanyalah menyertakan waktu tunggu dalam instruksi Anda sehingga ekstensi memiliki waktu untuk menyelesaikan tantangan sebelum formulir dikirim.

Contoh 1:

Kirimkan ini ke agen OpenClaw Anda (melalui Discord, WhatsApp, Telegram, atau saluran lainnya):

Pergi ke https://example.com, tunggu 60 detik,
lalu klik Kirim dan beri tahu saya teks apa yang muncul di halaman.

Apa yang terjadi di balik layar:

1. Agen menavigasi ke halaman demo reCAPTCHA
2. Skrip konten CapSolver mendeteksi widget reCAPTCHA
3. Ekstensi memanggil API CapSolver dan menyelesaikan tantangan (biasanya dalam 10-20 detik)
4. Token disisipkan ke bidang formulir tersembunyi
5. Setelah 60 detik, agen mengklik Kirim
6. Halaman menampilkan: "Verifikasi Berhasil... Hooray!"

Contoh 2: Masuk ke Situs yang Dilindungi

Pergi ke https://example.com/login, isi kolom email dengan
"[email protected]" dan kata sandi dengan "mypassword123",
lalu tunggu 30 detik dan klik tombol Masuk.
Beritahu saya halaman apa yang muncul setelah masuk.

Contoh 3: Kirim Formulir di Balik Turnstile

Buka https://example.com/kontak, isi formulir kontak:
- Nama: "John Doe"
- Email: "[email protected]"
- Pesan: "Halo, saya punya pertanyaan tentang layanan Anda."
Tunggu 45 detik, lalu klik Kirim Pesan. Apa konfirmasi yang muncul?

Waktu Tunggu yang Direkomendasikan

Tips: Jika ragu, gunakan 60 detik. Lebih baik menunggu sedikit lebih lama daripada mengirim terlalu dini. Waktu tambahan tidak memengaruhi hasil.

Pola Bahasa Alami yang Berfungsi

Berikut adalah frasa yang telah terbukti dapat digunakan:

• "Pergi ke [URL], tunggu 60 detik, lalu kirim formulir"
• "Navigasi ke [URL], isi [bidang], tunggu 30 detik, lalu klik [tombol]"
• "Buka [URL] dan setelah sekitar satu menit, klik Kirim dan beri tahu saya hasilnya"
• "Kunjungi [URL], tunggu sejenak hingga halaman selesai dimuat, lalu kirim"

Apa yang Harus Dihindari

Hindari ini — bisa membingungkan AI atau memicu penolakan:

• "Tunggu hingga CAPTCHA diselesaikan" (AI tidak tahu tentang CAPTCHA)
• "Gunakan CapSolver untuk menyelesaikan verifikasi" (AI tidak bisa mengendalikan ekstensi)
• "Klik kotak reCAPTCHA" (ekstensi menangani ini — mengklik bisa mengganggu)

Cara Kerja di Balik Layar

Untuk yang tertarik secara teknis, berikut yang terjadi ketika ekstensi CapSolver dimuat:

  Pesan Anda                    Gateway OpenClaw
  ───────────────────────────────────────────────────
  "pergi ke halaman,          ──► Agen AI menerima pesan
   tunggu 60s, kirim"         │
                              ▼
                         Alat Browser: navigasi ke URL
                              │
                              ▼
                         Chromium memuat halaman
                         ┌─────────────────────────────┐
                         │  Halaman dengan widget reCAPTCHA  │
                         │                              │
                         │  Ekstensi CapSolver:        │
                         │  1. Skrip konten mendeteksi │
                         │     reCAPTCHA di halaman     │
                         │  2. Pekerja layanan memanggil │
                         │     API CapSolver            │
                         │  3. Token diterima           │
                         │  4. Token disisipkan ke     │
                         │     bidang formulir tersembunyi │
                         └─────────────────────────────┘
                              │
                              ▼
                         Agen AI menunggu 60 detik...
                              │
                              ▼
                         Alat Browser: klik Kirim
                              │
                              ▼
                         Formulir dikirim DENGAN token yang valid
                              │
                              ▼
                         "Verifikasi Berhasil!"

Cara Ekstensi Dimuat

Ketika browser OpenClaw dimulai, ia membaca daftar extensions dari konfigurasi Anda dan meneruskan setiap jalur ke Chrome melalui bendera --load-extension. Ini adalah mekanisme yang sama yang digunakan Chrome untuk ekstensi pengembang — tidak diperlukan sistem plugin khusus.

1. Chrome dijalankan dengan --load-extension=~/.openclaw/capsolver-extension
2. Ekstensi aktif — pekerja layanan dimulai dan skrip konten diinjeksikan ke setiap halaman
3. Di halaman dengan CAPTCHA — skrip konten mendeteksi widget, memanggil API CapSolver, dan menyisipkan token penyelesaian ke halaman

Referensi Konfigurasi Lengkap

Berikut adalah konfigurasi lengkap ~/.openclaw/openclaw.json dengan ekstensi CapSolver:

{
  "browser": {
    "enabled": true,
    "executablePath": "/path/to/chrome-for-testing/chrome",
    "extensions": [
      "~/.openclaw/capsolver-extension"
    ],
    "noSandbox": true,
    "defaultProfile": "openclaw"
  }
}

"browser": {
"enabled": true,
"executablePath": "/path/to/chrome-for-testing/chrome",
"extensions": [
"~/.openclaw/capsolver-extension"
],
"noSandbox": true,
"defaultProfile": "openclaw"
}
}

### Opsi Konfigurasi

| Opsi | Deskripsi |
|--------|-------------|
| `browser.executablePath` | Jalur ke Chrome untuk Pengujian atau biner Chromium (wajib) |
| `browser.extensions` | Daftar jalur direktori ekstensi yang akan dimuat ke Chrome |
| `browser.noSandbox` | Atur ke `true` di server/Docker (sandbox Chrome memerlukan kemampuan kernel khusus) |
| `browser.defaultProfile` | Nama profil peramban (default: `"chrome"") |

Kunci API CapSolver dikonfigurasikan langsung di file `assets/config.js` ekstensi (lihat Langkah 2 di atas).

---

## Troubleshooting

### Ekstensi Tidak Dimuat

**Gejala**: Log Gateway menunjukkan `Loading 1 extension(s)` tetapi tidak ada `chrome-extension://` target yang muncul di CDP.

**Penyebab**: Anda menggunakan Google Chrome bermerek versi 137+ yang secara diam-diam mengabaikan `--load-extension`.

**Solusi**: Beralih ke Chrome untuk Pengujian atau Chromium. Perbarui `browser.executablePath` dalam konfigurasi Anda untuk menunjuk ke biner yang benar.

**Periksa versi Chrome Anda**:
```bash
/path/to/your/chrome --version
# Chrome untuk Pengujian: "Chromium 143.0.7499.4"
# Chrome bermerek: "Google Chrome 143.0.7499.109"

CAPTCHA Tidak Diselesaikan (Form Gagal)

Kemungkinan penyebab:

1. Waktu tunggu tidak cukup — Tingkatkan menjadi 60 detik
2. Kunci API tidak valid — Periksa dashboard CapSolver Anda
3. Saldo tidak cukup — Isi ulang akun CapSolver Anda
4. Ekstensi tidak dimuat — Lihat "Ekstensi Tidak Dimuat" di atas

Timeout Peramban pada Tindakan Pertama

Gejala: Tindakan peramban pertama setelah restart gateway mengalami timeout, tetapi tindakan berikutnya berjalan.

Penyebab: Start dingin Chromium + retry koneksi CDP Playwright melebihi timeout alat 20 detik pada percobaan pertama.

Solusi: Ini adalah masalah yang diketahui. Coba ulangi perintah — percobaan kedua akan berhasil karena peramban sekarang sudah panas.

Chrome Crash Setelah Beralih Peramban

Gejala: Setelah beralih dari Chrome bermerek ke Chrome untuk Pengujian, peramban crash dengan error cache disk.

Penyebab: Direktori data pengguna dibuat oleh versi Chrome berbeda dan tidak kompatibel.

Solusi: Hapus profil browser lama dan restart:

rm -rf ~/.openclaw/browser/openclaw/user-data
# Lalu restart gateway

Praktik Terbaik

1. Selalu Gunakan Waktu Tunggu yang Cukup

Waktu tunggu yang lebih lama lebih aman. CAPTCHA biasanya diselesaikan dalam 5-20 detik, tetapi latensi jaringan, tantangan kompleks, atau retry bisa menambah waktu. 30-60 detik adalah titik optimal.

2. Pertahankan Pesan yang Alami

Alih-alih:

"Navigasi ke URL, tunggu solver CAPTCHA, lalu kirim"

Gunakan:

"Pergi ke URL, tunggu sekitar satu menit, lalu kirim formulir"

Frasa alami bekerja lebih baik dengan AI dan menghindari penolakan keamanan.

3. Pantau Saldo CapSolver Anda

Setiap penyelesaian CAPTCHA memakan kredit. Periksa saldo Anda di capsolver.com/dashboard secara teratur untuk menghindari gangguan.

4. Gunakan noSandbox di Server

Ketika menjalankan OpenClaw di server jarak jauh, container Docker, atau lingkungan CI, selalu atur noSandbox: true dalam konfigurasi browser Anda. Sandbox Chrome memerlukan kemampuan kernel khusus yang tidak tersedia di sebagian besar lingkungan server.

5. Atur DISPLAY untuk Server Tanpa Layar

Ekstensi Chrome memerlukan tampilan, bahkan di server tanpa layar. Gunakan Xvfb untuk membuat layar virtual:

# Instal Xvfb
sudo apt-get install xvfb

# Mulai layar virtual
Xvfb :99 -screen 0 1280x720x24 &

# Atur DISPLAY untuk OpenClaw
export DISPLAY=:99

Kesimpulan

Integrasi OpenClaw + CapSolver mewakili pendekatan baru secara fundamental dalam menyelesaikan CAPTCHA. Alih-alih menulis kode untuk mendeteksi CAPTCHA, memanggil API, dan menyisipkan token, Anda hanya perlu:

1. Unduh ekstensi dan tambahkan ke konfigurasi Anda
2. Arahkan ke Chromium (bukan Chrome bermerek)
3. Bicara dengan AI Anda secara alami — cukup sertakan waktu tunggu sebelum pengiriman formulir

Ekstensi CapSolver menangani semuanya — mendeteksi CAPTCHA, menyelesaikannya melalui API CapSolver, dan menyisipkan token ke halaman. Asisten AI Anda tidak pernah perlu tahu tentang CAPTCHA sama sekali.

Ini adalah cara menyelesaikan CAPTCHA ketika Anda memiliki asisten AI: tak terlihat, otomatis, dan tanpa kode.

Siap memulai? Daftar di CapSolver dan gunakan kode bonus OPENCLAW untuk bonus tambahan 6% pada pengisian ulang pertama!

FAQ

Apakah saya perlu memberi tahu AI tentang CapSolver?

Tidak. Sebaliknya, hindari menyebut CAPTCHA atau CapSolver dalam pesan Anda. Ekstensi bekerja secara diam-diam di latar belakang. Cukup sertakan waktu tunggu dalam instruksi Anda (misalnya, "tunggu 60 detik, lalu kirim") untuk memberi ekstensi waktu menyelesaikan CAPTCHA apa pun di halaman.

Mengapa saya tidak bisa menggunakan Chrome bermerek?

Chrome 137+ (dirilis pertengahan 2025) menghapus dukungan untuk flag baris perintah --load-extension di build bermerek. Ini berarti ekstensi Chrome tidak dapat dimuat dalam sesi otomatis. Anda memerlukan Chrome untuk Pengujian atau Chromium standalone, yang masih mendukung flag ini.

Tipe CAPTCHA apa yang didukung CapSolver?

CapSolver mendukung reCAPTCHA v2 (checkbox dan invisible), reCAPTCHA v3, Cloudflare Turnstile, AWS WAF CAPTCHA, dan lainnya. Ekstensi Chrome secara otomatis mendeteksi jenis CAPTCHA dan menyelesaikannya sesuai.

Berapa biaya CapSolver?

CapSolver menawarkan harga kompetitif berdasarkan jenis CAPTCHA dan volume. Kunjungi capsolver.com untuk harga saat ini.

Apakah OpenClaw gratis?

OpenClaw open-source dan gratis untuk dijalankan di perangkat keras Anda sendiri. Anda memerlukan kunci API untuk penyedia model AI pilihan Anda dan, untuk menyelesaikan CAPTCHA, akun CapSolver dengan kredit.

Berapa lama waktu yang harus saya beri tahu AI untuk menunggu?

Untuk kebanyakan CAPTCHA, 30-60 detik cukup. Waktu penyelesaian sebenarnya biasanya 5-20 detik, tetapi menambah buffer tambahan memastikan keandalan. Jika ragu, gunakan 60 detik.

Apakah saya bisa menggunakan ini di server tanpa layar?

Ya. Anda memerlukan Xvfb (X Virtual Framebuffer) untuk layar karena ekstensi Chrome memerlukan konteks layar. Atur DISPLAY=:99 dan jalankan Xvfb :99 di latar belakang. Juga atur noSandbox: true dalam konfigurasi browser Anda.