Điều kiện tiên quyết
OpenClaw đã được cài đặt và đang chạy
Mailtarget tài khoản có quyền truy cập API
Tên miền công ty mà bạn sở hữu (ví dụ: yourcompany.com)
⚠️ Yêu cầu tên miền công ty
Bạn phải sử dụng tên miền riêng của công ty mình để gửi email (ví dụ: [email protected]). Các tên miền email miễn phí như Gmail, Yahoo, Outlook hoặc bất kỳ nhà cung cấp email công cộng nào đều không được phép sử dụng làm địa chỉ gửi email.
Tên miền của bạn có thể được lưu trữ trên bất kỳ nhà cung cấp nào — Google Workspace, Microsoft 365, Cloudflare hoặc bất kỳ nhà cung cấp dịch vụ DNS nào. Miễn là bạn sở hữu tên miền và có thể cấu hình các bản ghi DNS của nó, bạn có thể sử dụng được.
💡 Chúng tôi đặc biệt khuyên bạn nên sử dụng tên miền phụ (ví dụ: mail.yourcompany.com hoặc notifications.yourcompany.com) hoặc một tên miền chuyên dụng mới để gửi email. Điều này giúp bảo vệ danh tiếng của tên miền chính và cung cấp cho bạn một môi trường an toàn để thử nghiệm mà không ảnh hưởng đến thiết lập email hiện có của bạn.
Bước 1: Cài đặt kỹ năng
clawhub install mailtarget-email
Bước 2: Lấy khóa API
Đăng nhập vào app.mailtarget.co
Vào Cài đặt → Khóa API
Nhấp vào Tạo khóa API
Sao chép khóa
Bước 3: Cấu hình OpenClaw
Thêm khóa API của bạn vào môi trường cổng OpenClaw:
openclaw env set MAILTARGET_API_KEY=your_api_key_here
Hoặc xuất nó trong shell của bạn:
export MAILTARGET_API_KEY=your_api_key_here
Bước 4: Gửi email đầu tiên
Chỉ cần nói với người đại diện của bạn:
"Hãy gửi một email thử nghiệm đến [email protected] từ [email protected] với tiêu đề 'Xin chào từ OpenClaw' và một lời chào đơn giản."
Người đại diện sẽ lo phần còn lại — viết mã HTML, gọi API, xác nhận việc gửi thành công.
Bước 5: Thử thêm
Dưới đây là những việc bạn có thể yêu cầu đại lý của mình thực hiện:
"Gửi chiến dịch tới 50 liên hệ này với lời chào cá nhân hóa" — sử dụng dữ liệu thay thế
"Tạo mẫu email HTML cho bản tin hàng tuần của chúng tôi" — lưu trữ thông qua API Mẫu
"Liệt kê các tên miền gửi của chúng tôi và kiểm tra xem tên miền nào đã được xác minh" — quản lý tên miền
"Gửi email biên nhận giao dịch kèm tệp đính kèm PDF" — tệp đính kèm + cờ giao dịch
Thiết lập Tên miền Tự trị (SPF / DKIM / DMARC)
🚀 Không cần chỉnh sửa DNS thủ công
Nếu tên miền công ty của bạn được lưu trữ trên Cloudflare, tác nhân có thể tự động thiết lập xác thực email hoàn toàn. Không cần bảng điều khiển DNS.
Những thứ bạn cần
Khóa API Mailtarget (từ Bước 2 ở trên)
Tên miền công ty của bạn (ví dụ: yourcompany.com) — phải là tên miền bạn sở hữu
Mã thông báo API Cloudflare với quyền ghi DNS (tạo tại đây)
ID vùng Cloudflare của bạn (tìm thấy trên trang tổng quan tên miền)
Cài đặt kỹ năng bổ trợ và cấu hình thông tin xác thực:
clawhub install spf-dkim-setup openclaw env set CLOUDFLARE_API_TOKEN=your_token_here openclaw env set CLOUDFLARE_ZONE_ID=your_zone_id_here
Hãy nói với đại lý của bạn:
"Thiết lập yourcompany.com làm tên miền gửi email trong Mailtarget với xác thực email đầy đủ."
Các thao tác của Agent:
Tạo tên miền gửi trong Mailtarget
Đọc các bản ghi DNS cần thiết, giá trị SPF, bộ chọn và khóa DKIM, CNAME để theo dõi
Thêm bản ghi SPF TXT trong Cloudflare (hoặc hợp nhất vào SPF hiện có)
Thêm bản ghi DKIM TXT trong Cloudflare
Thêm bản ghi CNAME để theo dõi lượt nhấp/mở
Xác minh tên miền trong Mailtarget
Xác nhận tất cả các bản ghi đều vượt qua quá trình xác minh
Đối với các tên miền không thuộc Cloudflare
Trình quản lý sẽ vẫn tạo tên miền và đọc các giá trị DNS cần thiết. Sau đó, nó sẽ cung cấp cho bạn các bản ghi chính xác cần thêm vào nhà cung cấp DNS của bạn (Google Domains, quản trị viên Microsoft 365, Route53, v.v.):
Bản ghi SPF TXT, tên máy chủ và giá trị
Bản ghi DKIM TXT, tên máy chủ chọn và khóa công khai
Bản ghi CNAME, tên miền theo dõi
Sau khi bạn thêm chúng, hãy yêu cầu trình quản lý xác minh.
Điều gì đang xảy ra bên trong?
Bạn quyết định nội dung cần gửi và người nhận.
OpenClaw viết nội dung, xây dựng HTML, thiết lập tên miền và gọi API.
Mailtarget xử lý việc gửi, xác thực (SPF/DKIM/DMARC), theo dõi và đảm bảo độ tin cậy.
Theo dõi & Sự kiện
Bật tính năng theo dõi lượt mở và lượt nhấp bằng cách thông báo cho tác nhân của bạn:
"Gửi email với tính năng theo dõi lượt mở và lượt nhấp được bật."
Tác nhân thiết lập openTracking: true và clickTracking: true trong lệnh gọi API. Mailtarget sẽ kích hoạt các sự kiện webhook cho các lượt mở, lượt nhấp, email bị trả lại và email được gửi thành công.
Khắc phục sự cố
Sự cố | Khắc phục sự cố |
401 Unauthorized | Kiểm tra xem khóa API của bạn có chính xác và đang hoạt động không |
400 Bad Request | Xác minh địa chỉ email người gửi sử dụng tên miền công ty đã được xác thực |
Email không đến được | Kiểm tra thư mục thư rác; xác minh bản ghi SPF/DKIM cho tên miền của bạn |
| Đảm bảo biến môi trường được thiết lập trong môi trường cổng |
Xác minh tên miền thất bại | Quá trình lan truyền DNS có thể mất đến 5 phút, hãy yêu cầu tác nhân thử lại |
Tên miền email miễn phí bị từ chối | Sử dụng tên miền công ty của bạn, Gmail, Yahoo, Outlook, v.v. không được phép sử dụng làm địa chỉ người gửi |

