Bug P1 OpenClaw: Plugin AgentMail Resmi Crash Loop dan Email Masuk Tidak Pernah Diproses

OpenClaw punya jalur resmi untuk memakai AgentMail sebagai channel email. Masalahnya, jalur itu sedang gagal pada rilis yang masih relevan: plugin @agentmail/agentmail dapat terpasang dari ClawHub, tetapi channel-nya tidak pernah berhasil membuka antrean pesan masuk. Gateway lalu mengulang proses start channel dalam crash loop.

Issue GitHub #138774 dibuka pada 5 September 2026 dan diberi label P1. Laporan tersebut menyebut reproduksi pada image Docker 2026.8.2-slim dan 2026.9.1-slim. Ini bukan sekadar tombol konfigurasi yang salah. Ada ketidaksesuaian antara status plugin di katalog ClawHub yang di-host dan daftar katalog resmi yang sudah dikompilasi ke dalam build OpenClaw.

Apa yang gagal?

Dokumentasi AgentMail menyebut integrasi OpenClaw sebagai cara yang direkomendasikan untuk memberi agent inbox email. Instalasinya juga jelas:

openclaw plugins install clawhub:@agentmail/agentmail
openclaw plugins enable agentmail

Setelah channels.agentmail dikonfigurasi dan Gateway direstart, channel seharusnya menerima email masuk, menjalankan agent turn, lalu membalas pada thread yang sama. Dokumentasi AgentMail mensyaratkan OpenClaw 2026.7.2 beta atau yang lebih baru.

Pada kasus yang dilaporkan, proses berhenti sebelum tahap itu. Log-nya berbentuk seperti ini:

[agentmail] [default] channel exited: openChannelIngressQueue is only available for trusted plugins in this release.
[agentmail] [default] auto-restart attempt 1/10 in 5s

Pesan tersebut muncul lagi pada percobaan berikutnya, dengan jeda yang makin panjang. Karena antrean ingress tidak pernah terbuka, email yang masuk tidak memicu agent turn. Dari sisi pengirim email, kegagalannya juga tidak terlihat jelas: email terkirim, tetapi agent tidak pernah memprosesnya.

Akar masalahnya ada di trust plugin

OpenClaw memang sengaja membatasi openChannelIngressQueue. API ini tidak tersedia untuk plugin eksternal biasa. Runtime hanya mengizinkan plugin yang bundled atau instalasinya memiliki trustedOfficialInstall: true.

Masalahnya, status trusted itu tidak cukup ditentukan oleh label Official pada feed ClawHub yang sedang tersedia. Resolver runtime mencocokkan instalasi plugin dengan bundledOfficialEntries, yaitu katalog resmi yang dikompilasi ke dalam build OpenClaw. Menurut laporan #138774, entry @agentmail/agentmail ada pada feed ClawHub dan memiliki publisher trust official, tetapi tidak ada pada katalog bundled di image 2026.8.2-slim maupun 2026.9.1-slim.

Akibatnya, tiga hal bisa benar sekaligus:

• instalasi berasal dari perintah resmi clawhub:@agentmail/agentmail;
• hash paket cocok dengan catatan integritas di snapshot feed ClawHub;
• runtime tetap menganggap plugin tidak trusted untuk membuka ingress queue.

plugins.allow juga tidak menyelesaikan masalah ini. Allowlist hanya mengizinkan plugin dimuat; allowlist bukan mekanisme untuk memberikan hak istimewa runtime. Laporan tersebut juga menyebut tidak ada field konfigurasi, environment variable, atau flag CLI yang dapat dipakai administrator untuk menandai plugin sebagai trusted secara manual.

Ini bug AgentMail atau bug OpenClaw?

Dari bukti yang tersedia, kegagalannya berada pada jalur trust dan eligibility milik OpenClaw, bukan pada pengiriman email AgentMail. Plugin berhasil dimuat dan CLI-backed skill openclaw agentmail dilaporkan tetap dapat dipakai. Yang rusak adalah channel inbound yang membutuhkan openChannelIngressQueue.

Issue sebelumnya, #134042, sudah melaporkan kelas masalah yang sama pada OpenClaw 2026.8.1: channel AgentMail diblokir karena trust gate. Namun #138774 lebih spesifik terhadap dua stable image terbaru dan menyertakan reproduksi pada instalasi ClawHub yang hash paketnya cocok dengan feed. Jadi artikel ini bukan mengulang bug lama; ini adalah konfirmasi bahwa gap eligibility tersebut belum selesai ketika 2026.8.2 dan 2026.9.1 dipakai.

Kita juga tidak boleh menarik kesimpulan terlalu luas. Temuan ini tidak berarti semua plugin eksternal selalu gagal. OpenClaw memang memiliki katalog resmi bundled dan pengujian untuk membedakan instalasi yang memenuhi provenance dari plugin yang tidak trusted. Yang belum beres adalah status AgentMail di antara feed hosted dan katalog yang dipakai runtime.

Dampaknya untuk operator

Jika OpenClaw dipakai untuk memantau inbox AgentMail, jangan menganggap proses Gateway yang terlihat hidup berarti channel email sehat. Gateway utama dapat tetap listening sementara channel AgentMail mengulang start di belakang layar.

Sebelum memakai workflow ini untuk production, cek beberapa hal:

1. lihat versi OpenClaw dan image yang digunakan;
2. periksa openclaw plugins inspect agentmail --json untuk memastikan sumber instalasi dan hash paket;
3. cari error openChannelIngressQueue is only available for trusted plugins pada log Gateway;
4. pastikan ada pesan inbound uji yang benar-benar menghasilkan agent turn, bukan hanya status plugin loaded;
5. jangan memasukkan email penting ke workflow otomatis sebelum channel lolos smoke test.

Untuk sementara, plugin skill dan channel email perlu diperlakukan sebagai dua permukaan yang berbeda. Skill CLI bisa saja berfungsi, sementara email inbound tetap mati. Jika kebutuhan Anda hanya menjalankan operasi AgentMail secara manual dari agent, hasilnya belum tentu sama dengan kebutuhan menerima email secara otomatis.

Apakah perlu upgrade sekarang?

Issue #138774 belum memiliki pull request perbaikan yang terhubung ketika diperiksa pada 5 September 2026. Issue tersebut juga masih open. Karena perbaikannya menyentuh batas trust untuk akses queue persisten, solusi yang aman bukan memberi fallback umum berdasarkan label publisher atau menonaktifkan pemeriksaan trust.

Arah perbaikan yang masuk akal adalah memperbarui katalog resmi bundled agar entry AgentMail masuk setelah validasi provenance, atau merancang mekanisme trust feed hosted yang benar-benar terverifikasi, memiliki expiry, dan mendukung revocation. Pilihan kedua tidak boleh dipasang sebagai shortcut karena status trusted juga dapat memengaruhi kemampuan runtime lain, bukan hanya channel email.

Jadi keputusan operasionalnya sederhana: jangan meng-upgrade dengan harapan 2026.9.1 otomatis menyelesaikan AgentMail. Rilis OpenClaw 2026.9.1 memang membawa perbaikan rollback upgrade, recovery Gateway, approval, dan banyak area lain, tetapi issue AgentMail menunjukkan bahwa channel resmi ini masih perlu diverifikasi terpisah. Tahan penggunaan inbound AgentMail untuk beban penting sampai ada release note atau bukti reproduksi yang menyatakan trust eligibility-nya sudah diperbaiki.

Sumber resmi

• OpenClaw issue #138774, laporan P1 tentang trustedOfficialInstall dan crash loop AgentMail.
• OpenClaw issue #134042, laporan sebelumnya tentang AgentMail dan trust gate pada channel ingress.
• OpenClaw release 2026.9.1.
• Dokumentasi integrasi AgentMail untuk OpenClaw.