Prasyarat
OpenClaw terpasang dan berjalan
Akun Mailtarget dengan akses API
Domain perusahaan yang Anda miliki (misalnya, yourcompany.com)
⚠️ Diperlukan Domain Perusahaan
Anda harus menggunakan domain perusahaan Anda sendiri untuk mengirim email (misalnya, [email protected]). Domain email gratis seperti Gmail, Yahoo, Outlook, atau penyedia email publik lainnya tidak diizinkan sebagai alamat pengirim.
Domain Anda dapat dihosting di penyedia mana pun — Google Workspace, Microsoft 365, Cloudflare, atau penyedia DNS lainnya. Selama Anda memiliki domain tersebut dan dapat mengkonfigurasi DNS-nya, Anda siap untuk menggunakannya.
💡 Kami sangat menyarankan untuk menggunakan subdomain (misalnya, mail.yourcompany.com atau notifications.yourcompany.com) atau domain khusus baru untuk pengiriman. Ini menjaga reputasi domain utama Anda tetap terisolasi dan memberi Anda lingkungan yang aman untuk pengujian tanpa memengaruhi pengaturan email Anda yang sudah ada.
Langkah 1: Install Skill
clawhub install mailtarget-email
Langkah 2: Dapatkan Kunci API Anda
Masuk ke app.mailtarget.co
Buka Setting → API Key
Klik Create API Key
Salin key-nya
Langkah 3: Konfigurasi OpenClaw
Tambahkan API key Anda ke lingkungan gateway OpenClaw:
openclaw env set MAILTARGET_API_KEY=your_api_key_here
Atau ekspor di shell Anda:
export MAILTARGET_API_KEY=your_api_key_here
Langkah 4: Kirim Email Pertama Anda
Cukup beri tahu agen Anda:
"Kirim email uji coba ke [email protected] dari [email protected] dengan subjek 'Halo dari OpenClaw' dan pesan sambutan sederhana."
Agen akan menangani sisanya — menulis HTML, memanggil API, dan mengkonfirmasi pengiriman.
Langkah 5: Coba Lebih Banyak
Berikut adalah hal-hal yang dapat Anda minta agen Anda lakukan:
"Kirim kampanye ke 50 kontak ini dengan salam yang dipersonalisasi" — menggunakan data substitusi
"Buat templat email HTML untuk buletin mingguan kami" — menyimpannya melalui API Template
"Daftar domain pengirim kami dan periksa mana yang terverifikasi" — manajemen domain
"Kirim email tanda terima transaksional dengan lampiran PDF" — lampiran + flag transaksional
Pengaturan Domain Otomatis (SPF / DKIM / DMARC)
🚀 Tanpa Pengeditan DNS Manual
Jika domain perusahaan Anda berada di Cloudflare, agen dapat mengatur otentikasi email sepenuhnya secara otomatis. Tidak diperlukan dasbor DNS.
Yang Anda Butuhkan
API Key Mailtarget (dari Langkah 2 di atas)
Domain perusahaan Anda (misalnya yourcompany.com) — harus berupa domain yang Anda miliki
Token API Cloudflare dengan izin Tulis DNS (buat di sini)
ID Zona Cloudflare Anda (dapat ditemukan di halaman ikhtisar domain)
Instal skill pendamping dan konfigurasikan kredensial:
clawhub install spf-dkim-setup openclaw env set CLOUDFLARE_API_TOKEN=your_token_here openclaw env set CLOUDFLARE_ZONE_ID=your_zone_id_here
Cukup beri tahu agen Anda:
"Atur yourcompany.com sebagai domain pengirim di Mailtarget dengan otentikasi email lengkap."
Tugas Agen
Membuat domain pengirim di Mailtarget
Membaca catatan DNS yang diperlukan, nilai SPF, pemilih & kunci DKIM, CNAME untuk pelacakan
Menambahkan catatan SPF TXT di Cloudflare (atau menggabungkannya ke SPF yang sudah ada)
Menambahkan catatan DKIM TXT di Cloudflare
Menambahkan catatan CNAME untuk pelacakan klik/buka
Memverifikasi domain di Mailtarget
Memastikan semua catatan lolos verifikasi
Untuk Domain Non-Cloudflare
Agen akan tetap membuat domain dan membaca value DNS yang diperlukan. Kemudian, agen akan memberikan Anda catatan yang tepat untuk ditambahkan di penyedia DNS Anda (Google Domains, admin Microsoft 365, Route53, dll.):
Catatan SPF TXT, nama host dan value
Catatan DKIM TXT, nama host pemilih dan kunci publik
Catatan CNAME, domain pelacakan
Setelah Anda menambahkannya, beri tahu agen untuk memverifikasinya.
Apa yang Terjadi di Balik Layar
Anda memutuskan apa yang akan dikirim dan kepada siapa akan dikirim
OpenClaw menulis konten, membangun HTML, mengatur domain, memanggil API
Mailtarget menangani pengiriman, otentikasi (SPF/DKIM/DMARC), pelacakan, dan keandalan
Pelacakan & Peristiwa
Aktifkan pelacakan open dan klik dengan memberi tahu agen Anda:
"Kirim email dengan tracking open dan tracking klik diaktifkan."
Agen mengatur `openTracking: true` dan `clickTracking: true` dalam panggilan API. Mailtarget akan memicu peristiwa webhook untuk pembukaan, klik, pantulan, dan pengiriman.
Penyelesaian Masalah
Masalah | Perbaikan |
401 Unauthorized | Periksa apakah API key Anda benar dan aktif |
400 Bad Request | Verifikasi bahwa email pengirim menggunakan domain perusahaan yang terverifikasi |
Email tidak sampai | Periksa folder spam; verifikasi SPF/DKIM untuk domain Anda |
| Pastikan env var diatur di gateway environment |
Verifikasi domain gagal | Propagasi DNS dapat memakan waktu hingga 5 menit, beri tahu agen untuk mencoba lagi |
Domain email gratis ditolak | Gunakan domain perusahaan Anda, Gmail, Yahoo, Outlook, dll. tidak diizinkan sebagai alamat pengirim |