Cloudflare Mail Address Creator#

Use this skill to create ordinary mailbox addresses through https://mail-api.suilong.online/admin/new_address.

Workflow#

1. Collect or infer name, domain, and enablePrefix.
2. Default enablePrefix to true when the user does not specify it.
3. If the user gives a full address such as t2@suilong.online, split it into name=t2 and domain=suilong.online.
4. Never hardcode real credentials in the skill. Read them from runtime environment variables or pass them as CLI flags.
5. Run python3 scripts/create_address.py for single or batch creation.
6. Return the script's JSON output directly unless the user asks for a reformatted summary.
7. Preserve the normalized statuses: created, already_exists, auth_error, error.
8. If local validation fails, fix the input before attempting the API call again.
9. Use --output-format csv and optionally --output-file <path> when the user asks for exportable results.

Commands#

Single address:

bash

python3 scripts/create_address.py \
  --name t2 \
  --domain suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Single full address:

bash

python3 scripts/create_address.py \
  --name t2@suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Batch addresses from a comma-separated list:

bash

python3 scripts/create_address.py \
  --names alice,bob,charlie \
  --domain suilong.online \
  --enable-prefix true \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Batch addresses from a file:

bash

python3 scripts/create_address.py \
  --names-file ./names.txt \
  --domain suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Export batch results as CSV:

bash

python3 scripts/create_address.py \
  --names alice,bob,charlie \
  --domain suilong.online \
  --output-format csv \
  --output-file ./created-addresses.csv \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Runtime Environment#

Prefer environment variables for secrets:

• CLOUDFLARE_MAIL_ADMIN_AUTH
• CLOUDFLARE_MAIL_BEARER_TOKEN
• CLOUDFLARE_MAIL_FINGERPRINT
• CLOUDFLARE_MAIL_LANG
• CLOUDFLARE_MAIL_USER_TOKEN
• CLOUDFLARE_MAIL_API_URL

Supporting Files#

• Read references/api.md for the endpoint contract and error mapping.
• Read references/examples.md for example prompts and outputs.

OpenClaw Install Notes#

Install this skill into an OpenClaw workspace under skills/cloudflare-mail-address-creator/, or globally under ~/.moltbot/skills/cloudflare-mail-address-creator/.

This package intentionally keeps only the OpenClaw-compatible skill files: SKILL.md, scripts/, and references/.