Catatan dari bengkel
Cara kami memandang agen yang hidup di aplikasi perpesanan Anda, apa yang kami pelajari saat membangunnya, dan hal-hal praktis yang dapat Anda gunakan hari ini.
329 artikel
Semua artikel
Apa yang dikirim OpenClaw ke servernya
Secara default, OpenClaw membuat satu permintaan keluar per hari, dan dokumentasinya menyebutkan dengan persis apa isinya: versi, sistem operasi, versi Node.js, arsitektur, dan surface, tanpa pengenal instalasi. Berikut gambaran lengkapnya, termasuk lokasi turunan Cloudflare yang disimpan selama tiga bulan, ditambah setiap sakelar yang menghentikan permintaan tersebut.
Control UI OpenClaw
Gateway menyajikan dasbor browser di port 18789, dan hal pertama yang ditampilkannya adalah satu kolom Gateway secret. Apa yang diterima kolom itu, mengapa browser di mesin yang sama tetap harus mengisinya, apa fungsi daftar agen dan mode tim, dan apa yang perlu dijalankan saat URL LAN diblokir.
Failed to start Chrome CDP on port 18800
Error-nya hanya satu baris tanpa petunjuk apa pun. Di server Linux, penyebabnya hampir selalu browsernya: apt install chromium memberi Anda wrapper snap yang confinement-nya merusak cara OpenClaw meluncurkan dan memantau Chrome. Berikut perbaikannya, enam pengaturan yang penting, dan pemeriksaan yang membedakan kegagalan startup CDP dari pemblokiran navigasi.
Relay browser OpenClaw
OpenClaw dapat mengendalikan browser yang tidak berada di mesin Gateway: node host meneruskan aksinya, atau cdpUrl terhubung ke Chromium yang di-hosting. Berikut perilaku perutean, profil, dan kredensial.
Agen ACP OpenClaw
OpenClaw menjalankan harness coding eksternal melalui Agent Client Protocol: Claude Code, Gemini CLI, Cursor, Copilot, Droid, OpenCode, dan sebelas lainnya, dijalankan dari sebuah pesan chat dan dilacak sebagai tugas latar belakang. Instalasi acpx dengan dua perintah, jebakan saat pertama dijalankan termasuk jebakan plugins.allow, daftar periksa prasyarat yang menentukan apakah jalur ini ditawarkan sama sekali, dan tujuh belas ID target harness.
Memicu OpenClaw dari Gmail
Event kotak masuk Gmail sampai ke OpenClaw melalui topik Google Pub/Sub, proses watcher, dan hook HTTP Gateway, dan preset bawaan memberi setiap email sesinya sendiri tanpa membatasi hal lain. Berikut penyiapan topik dan watch dengan gcloud, model dua token, agen mail_reader yang dibatasi dan berjalan di sandbox seperti yang direkomendasikan dokumentasi, dan uji batas yang memberi tahu Anda apakah pembaca itu benar-benar terkurung.
Keluar dari sandbox dengan sengaja
Mode elevated memungkinkan agen OpenClaw yang berada di sandbox menjalankan perintah di luar sandbox-nya, di bawah gerbang persetujuan yang tetap dapat dikonfigurasi. Mode ini tidak berpengaruh apa pun pada agen yang tidak pernah di-sandbox, dan tidak dapat menimpa kebijakan alat atau peran yang sejak awal mewajibkan sandbox. Artikel ini membahas keempat direktif, urutan resolusinya, gerbang dan daftar izin yang semuanya harus lolos, serta hal-hal yang sengaja tidak disentuh oleh elevasi.
Mesin konteks OpenClaw
Mesin konteks menentukan pesan mana yang sampai ke model, bagaimana riwayat lama diringkas, dan bagaimana konteks melintasi batas sub-agen; OpenClaw menyertakan mesin legacy dan memakainya secara default, mesin plugin dipilih melalui slot konfigurasi, antarmukanya mewajibkan ingest, assemble, dan compact dengan hook opsional bootstrap, maintain, batch ingest, dan subagent, mesin plugin yang gagal dikarantina selama proses berjalan dan pekerjaan beralih ke legacy, dan ownsCompaction bernilai false tidak memulihkan jalur compaction legacy.
Exec latar belakang OpenClaw dan alat process
Perintah yang berjalan melewati jeda yield mengembalikan ID sesi dan potongan akhir output yang singkat alih-alih memblokir; output tetap di memori hingga batas agregat, sesi yang selesai kedaluwarsa berdasarkan masa hidup yang dihitung sejak selesai, dengan paling banyak 50 sesi selesai dan dua juta karakter yang disimpan, lingkungan worker berbasis node menjaga perintah latar belakang tetap hidup antar giliran, dan alat process dapat melakukan polling, membaca log berhalaman, menulis ke stdin, mengirim tombol, mengirim Enter, menempel teks, menghentikan, dan membersihkan.
Alat exec OpenClaw
Exec menjalankan perintah shell di ruang kerja dan dapat membuat, mengedit, atau menghapus file di mana pun host yang dipilih mengizinkannya, sehingga menonaktifkan alat file tidak menjadikannya baca-saja; parameter host di-resolve ke sandbox saat runtime sandbox aktif dan ke gateway jika tidak, kunci mode mengatur deny, allowlist, ask, auto, atau full, peninjau otomatis mengembalikan allow, deny, atau ask untuk perintah di luar daftar izin yang memenuhi syarat, dengan seluruh rantai dispatch diikat dan diperiksa ulang sebelum dijalankan, dan perintah sesi hanya dapat memperketat kebijakan.
API OpenResponses OpenClaw
Gateway menyajikan endpoint responses yang kompatibel dengan OpenResponses setelah gateway.http.endpoints.responses diaktifkan, dengan aturan autentikasi, scope, dan target agen yang sama seperti chat completions; input berupa string atau daftar item, hasil alat dikembalikan sebagai function_call_output, previous_response_id menggunakan ulang sesi dalam scope agen, pengguna, dan sesi yang sama, file didekode ke dalam system prompt sebagai konten tidak tepercaya dengan PDF dirasterisasi jika teksnya sedikit, dan streaming mengirim peristiwa respons bertipe yang diakhiri DONE.
Autentikasi proxy tepercaya OpenClaw
Dalam mode trusted-proxy, gateway hanya memercayai header identitas pengguna dari alamat sumber yang tercantum sebagai proxy tepercaya, menolak sumber loopback kecuali opt-in sengaja diaktifkan, menolak sumber yang cocok dengan antarmukanya sendiri, mewajibkan header yang dikonfigurasi dan kecocokan dengan daftar izin, menolak untuk dimulai jika token bersama juga dikonfigurasi, dan audit keamanan sengaja menandai mode ini sebagai kritis; scope identitas memberikan scope khusus sesi kepada pengguna terverifikasi, persetujuan perangkat otomatis dapat menjadikan identitas proxy sebagai batas pendaftaran perangkat, dan header scope hanya mempersempit.
Persetujuan exec OpenClaw tingkat lanjut
Safe bins seperti cut, head, tail, tr, uniq, dan wc berjalan dalam mode allowlist tanpa entri karena menolak argumen file dan token yang menyerupai path; grep dan sort bersifat opt-in, awk, sed, dan jq tidak pernah menjadi safe bins, interpreter tidak pernah boleh ada di sana, safe bins harus di-resolve dari direktori sistem default kecuali ada direktori lain yang dipercaya, chaining diizinkan jika setiap segmen lolos, eksekusi interpreter mengikat seluruh rantai dispatch sebelum ditinjau, menyelesaikan persetujuan memerlukan scope approvals khusus, bukan write, dan permintaan persetujuan dapat diteruskan ke Slack, Telegram, Discord, dan lainnya.
Pemecahan masalah gateway OpenClaw
Runbook gateway mendalam dimulai dengan lima perintah yang sama secara berurutan, mengharapkan runtime yang berjalan, probe konektivitas ok, dan sebuah baris kapabilitas, lalu mengarahkan berdasarkan gejala ke enam halaman: pembaruan dan rollback, skill dan penyedia model, balasan agen dan antarmuka kontrol, layanan dan proses gateway, validasi konfigurasi dan probe, pengiriman saluran dan alat; sebagian besar kerusakan setelah pembaruan adalah pergeseran konfigurasi atau default yang lebih ketat, yang diperiksa melalui mode gateway dan URL remote, bind non-loopback yang kini memerlukan jalur autentikasi yang sesungguhnya, serta persetujuan penyandingan perangkat atau pesan langsung yang masih tertunda.
API HTTP OpenClaw yang kompatibel dengan OpenAI
Gateway dapat melayani chat completions, models, dan embeddings di port-nya sendiri setelah gateway.http.endpoints.chatCompletions diaktifkan; token yang valid setara dengan akses tingkat pemilik, jadi dokumentasi menyarankan agar tetap di loopback, tailnet, atau ingress privat; kolom model menyebut agen seperti openclaw/default, bukan model penyedia, string user menurunkan kunci sesi yang stabil, x-openclaw-model mengganti model backend, dan function tools, tool_choice, serta streaming SSE mengikuti bentuk OpenAI dengan batasan yang terdokumentasi.
Scope operator OpenClaw
Scope membatasi apa yang dapat dilakukan klien gateway setelah terautentikasi, sebagai pagar pengaman di dalam satu domain operator tepercaya, bukan isolasi multi-tenant terhadap pihak yang saling tidak tepercaya; operator.write mencakup read dan talk, operator.admin mencakup semuanya, peran bernama membatasi scope dan dapat mewajibkan sandbox per pembuat, pemberian berbasis identitas melekatkan scope ke identitas proxy terverifikasi atau identitas Tailscale, setiap RPC memiliki scope metode dengan hak akses minimum, dan menyetujui permintaan perangkat hanya dapat menerbitkan scope yang sudah dimiliki pemberi persetujuan.
Kontrol akses Matrix OpenClaw
Siapa yang boleh menjangkau OpenClaw melalui Matrix dan apa yang disimpannya di sekitar sebuah pesan: pesan dari akun Matrix OpenClaw lain yang dikonfigurasi diabaikan secara default, pengaturan allow-bots dengan true atau mentions serta override per ruangan, perlindungan loop bersama dan urutan prioritasnya, aturan ID diri sendiri, definisi dibuat oleh bot di platform tanpa flag bot, tiga mode visibilitas konteks yang menyaring balasan yang diambil, akar utas, dan riwayat tertunda tanpa menentukan pemicu, contoh kebijakan pesan langsung dan ruangan dengan daftar izin dan ruangan yang mewajibkan mention, menonaktifkan pesan langsung sepenuhnya, perintah penyandingan dan kode tertunda yang digunakan ulang dengan pengingat setelah cooldown, serta perintah slash yang dikenali di ruangan jika diawali mention bot itu sendiri dan tetap tunduk pada otorisasi yang sama.
Aturan push Matrix OpenClaw untuk pratinjau senyap
Penyiapan sisi homeserver yang membuat streaming senyap Matrix berbunyi pada saat yang tepat: pratinjau dikirim sebagai notice yang tidak memicu notifikasi dengan editan final membawa penanda, klien hanya memberi notifikasi saat aturan push per pengguna cocok dengannya, mode progress melakukan finalisasi melalui jalur yang sama, prasyarat berupa pengguna penerima, pengguna bot, token penerima, ID lengkap bot sebagai pengirim, dan pusher yang sehat, enam langkah mulai dari mengaktifkan mode quiet hingga membuat atau menggunakan ulang token, mencantumkan pusher, memasang aturan override dengan empat kondisi dan aksi notify-nya, memverifikasinya dan menguji balasan yang di-stream, penghapusan, ID aturan yang unik per bot dan per penerima dengan eksekusi ulang yang memperbarui di tempat, override pengguna yang disisipkan di depan aturan suppress server, editan khusus teks yang dipengaruhi aturan ini sementara media, fallback pratinjau basi, dan teks final yang mengaktifkan mention tetap memberi notifikasi seperti biasa, Synapse yang memerlukan kondisi event-property-is dari 2023 dengan rilis lama yang diam-diam tidak pernah cocok, dan opsi penekanan push saat perangkat aktif di Tuwunel.
Konfigurasi Microsoft Teams OpenClaw
Pengaturan Teams di bawah blok saluran: delapan kunci autentikasi yang dapat digantikan oleh variabel lingkungan sementara semua kunci lain hanya dapat diatur di konfigurasi, batas riwayat dengan fallback-nya dan konteks utas Graph yang menambahkan pesan induk serta hingga lima puluh balasan sambil mencegah perintah yang dikutip dieksekusi, mode visibilitas all, allowlist, dan allowlist-quote, batas riwayat pesan langsung per pengguna, kunci cloud dan URL layanan untuk cloud publik, pemerintah AS, DoD, dan Tiongkok, port dan path webhook, empat kebijakan pesan langsung dengan ID objek AAD yang direkomendasikan, target default, sakelar darurat pencocokan nama, batas 4000 karakter per potongan, pemotongan per baris baru, daftar izin host media dan fallback media Graph, kewajiban mention dan gaya balasan dengan override per tim dan per saluran termasuk kebijakan alat, situs SharePoint untuk unggahan grup, kartu sambutan dan kartu sambutan grup dengan pembuka prompt, prefiks respons, umpan balik jempol dengan refleksi, dan SSO dengan scope Graph yang didelegasikan.
Penyiapan Telegram di OpenClaw
Menghubungkan bot Telegram ke OpenClaw dari nol: alur chat dan alur web di BotFather yang sama-sama berakhir dengan token, perintah channels add yang menuliskannya ke konfigurasi, alternatif edit manual dengan kebijakan DM pairing dan entri grup wildcard, fallback env yang hanya melayani akun default, mengapa tidak ada perintah login untuk Telegram, pemeriksaan status dengan hot reload, perintah pairing list dan approve dengan kode yang kedaluwarsa setelah satu jam, dua ID yang dibutuhkan grup dan ke mana masing-masing dimasukkan, prioritas token yang memperhitungkan akun dan cache identitas 24 jam, mode privasi dan status admin di sisi Telegram dengan aturan keluarkan lalu tambahkan kembali, toggle BotFather yang berguna, dan pilihan transport antara long polling dengan posisi restart yang persisten dan mode webhook dengan rahasianya, default listener-nya, path health yang dicadangkan, dan header penerimaan persistennya.
Grafik, tabel, dan persetujuan Slack di OpenClaw
Permukaan Block Kit yang dirender OpenClaw secara native di Slack: blok grafik portabel yang dipetakan ke blok visualisasi data Slack tanpa scope tambahan, batasan yang diberlakukan pada judul, segmen, seri, dan kategori, representasi teks yang dibawa setiap grafik, pemulihan saat Slack menolak blok, batas dua grafik per pesan yang tidak didokumentasikan dan cara grafik tambahan meluap ke pesan lanjutan, blok tabel portabel yang dipetakan ke tabel data terkini dengan sel teks mentah, sel angka mentah, dan header baris, batas 20 kolom, 100 baris, dan 10.000 karakter, fallback teks lengkap dan error ukuran yang eksplisit saat pengeditan, alasan tabel pipa Markdown tetap berupa teks sementara blok mentah tetap diteruskan, tabel tempelan yang masuk dan dirender sebagai TSV, dua pola perutean untuk pengiriman modal milik plugin dan peristiwa ringkas yang disamarkan yang dilihat agen, serta Slack sebagai klien persetujuan native untuk permintaan exec dan plugin beserta pemberi persetujuan, target, filter, dan retensi ruang kerja Enterprise Grid.
Utas dan sesi Slack di OpenClaw
Ke mana pesan Slack masuk di OpenClaw dan ke mana balasannya dikirim: pesan langsung sebagai direct, saluran sebagai channel, dan pesan langsung grup sebagai group, binding rute yang menerima bentuk target Slack, scope pesan langsung main yang menggabungkan pesan langsung biasa, sesi per saluran dan sufiks utas yang diambil dari timestamp induk, pesan akar yang di-seed sehingga sebuah mention dan utasnya tetap dalam satu sesi, scope riwayat, induk yang diwarisi dan pengambilan riwayat awal, dua flag mention implisit dan kunci mention eksplisit yang dimigrasikan, mode balasan per saluran, per jenis chat, dan dengan fallback pesan langsung lama, tag balasan manual, broadcast balasan untuk teks dan Block Kit, opt-out tingkat atas, mengapa off di Slack juga menonaktifkan tag eksplisit tidak seperti di Telegram, serta pesan langsung Agent View tempat setiap pesan akar dari composer menjadi percakapannya sendiri dan penandanya dipelajari dari tiga sinyal lalu disimpan per akun, ruang kerja, dan aplikasi.
Pesan kaya dan persetujuan Telegram di OpenClaw
Permukaan kaya yang dapat digunakan bot Telegram OpenClaw: HTML Telegram standar secara default dengan tebal, miring, tautan, kode, spoiler, dan kutipan, flag rich messages yang merender Markdown sebagai blok bertipe Bot API 10.3 seperti heading, tabel, detail, daftar periksa, dan rumus, dengan keterangan tetap dalam HTML dan tabel lebih dari 20 kolom beralih ke kode, alasan flag ini tetap nonaktif demi kompatibilitas klien, pratinjau tautan, lima scope tombol inline dengan allowlist sebagai default, blok tombol dengan aksi callback dan web-app serta batasan bahwa Mini App hanya berfungsi di chat pribadi, cara callback yang tidak diklaim sampai ke agen sebagai teks, pengakuan (acknowledgement) di bawah durable ingress, enam aksi pesan beserta alias dan gerbangnya yang nonaktif secara default, inspeksi daftar emoji, dan persetujuan exec beserta pemberi persetujuan, target, masa berlaku, dan persyaratan tombol inline-nya.
Enkripsi dan verifikasi Matrix di OpenClaw
Bagaimana akun Matrix OpenClaw mendapatkan enkripsi end-to-end dan tetap tepercaya: perintah penyiapan yang melakukan bootstrap penyimpanan rahasia, cross-signing, dan cadangan kunci ruangan, alasan kunci pemulihan melewati stdin, tiga sinyal kepercayaan yang independen dan aturan bahwa hanya verifikasi cross-signing yang dihitung sebagai verified by owner, verifikasi perangkat dan verifikasi mandiri, perintah bootstrap-atau-perbaikan beserta fallback UIA-nya, status, pemulihan, dan reset cadangan, perintah verifikasi SAS, catatan multi-akun, verifikasi mandiri saat startup dengan cooldown-nya, pemberitahuan verifikasi, dan apa yang harus dilakukan saat perangkat telah dihapus.
Menampilkan 24 dari 50 artikel
Artikel blog lainnya tersedia dalam bahasa Inggris. Baca dalam bahasa Inggris
Berhenti membaca, buat agen Anda sendiri
Siapkan agen, pilih saluran, dan biarkan ia bekerja di dalam aplikasi yang sudah selalu Anda buka.