mailgo-campaign-suite
Complete cold email campaign suite for Mailgo — verify recipients, claim free mailbox, generate & optimize content, create campaigns, manage lifecycle, and view reports. All-in-one skill that handles the full outreach pipeline end-to-end. Use when a user wants to send cold emails, launch outreach campaigns, or manage existing campaigns.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/cailumin/mailgo-campaign-suiteMailgo Campaign Suite
One skill, complete cold email pipeline. From recipient verification to campaign reporting — everything runs through bundled scripts with zero third-party dependencies.
Step 0 — Authentication Setup
Required: MAILGO_API_KEY environment variable must be set before any other step.
Quick check
# Confirm the variable is set (shows first 5 characters only)
echo "${MAILGO_API_KEY:0:5}"
If output is non-empty → proceed to Step 1. If empty → follow the setup flow below.
Setup Flow
Sub-step 0.1 — Register or Log In
New users:
- Go to https://app.mailgo.ai
- Click "Sign Up" and complete registration
Existing users:
- Go to https://app.mailgo.ai
- Log in with your credentials
Sub-step 0.2 — Create Personal Token
Once logged in:
- Click your avatar in the bottom-left corner
- Select Personal Tokens from the menu
- Click Create Token
- Give your token a descriptive name (e.g., "Claude Code")
- Copy the generated token
SECURITY: Never paste the token into chat. It must only be set as a local environment variable.
Sub-step 0.3 — Set Environment Variable
# macOS / Linux (permanent)
echo 'export MAILGO_API_KEY="YOUR_TOKEN"' >> ~/.zshrc && source ~/.zshrc
# Windows PowerShell (permanent)
[System.Environment]::SetEnvironmentVariable('MAILGO_API_KEY', 'YOUR_TOKEN', 'User')
Replace YOUR_TOKEN with the copied value.
Sub-step 0.4 — Verify
# macOS / Linux — shows first 5 characters to confirm without exposing the token
echo "${MAILGO_API_KEY:0:5}"
# Windows PowerShell
$k = $env:MAILGO_API_KEY; if ($k) { $k.Substring(0, [Math]::Min(5, $k.Length)) } else { "" }
If output is non-empty, you're ready. If empty, run source ~/.zshrc or open a new terminal.
Key Facts
| Item | Value |
|---|---|
| Token source | app.mailgo.ai → Avatar → Personal Tokens |
| Env variable name | MAILGO_API_KEY |
| API header | X-API-Key: {MAILGO_API_KEY} |
| Token scope | Your Mailgo account (mailboxes, campaigns, reports) |
| Revoke token | app.mailgo.ai → Avatar → Personal Tokens → Delete |
Auth Error Handling
| Issue | Fix |
|---|---|
Empty after source ~/.zshrc | Open a new terminal window |
| 401 Unauthorized | Token may be invalid or deleted — create a new one in Personal Tokens |
| 403 Forbidden | Ensure User-Agent header is set (scripts handle this automatically) |
Step 0.5 — Upfront Information Gathering
Collect all required information in a single interaction before starting the pipeline.
Ask all questions at once. Do not ask in separate rounds. The user fills in what they know; mark anything skipped as "not provided".
When to run: Only when the user intends to create a new campaign. Skip for report/manage/replies tasks.
Group A — Your Information (for email signature & credibility)
Ask all of these together in one message:
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-cailumin-mailgo-campaign-suite": {
"enabled": true,
"auto_update": true
}
}
}