- name
- cloudflare-mail-address-creator
- description
- create one or many ordinary mailbox addresses in a cloudflare temporary mail system through the /admin/new_address admin api and return structured results. use when openclaw is asked to create mailbox addresses through the backend instead of the web ui, including requests such as create t2@suilong.online, create 10 mailboxes, add a mailbox in my cloudflare temp mail system, or use the cloudflare mail admin api to create addresses.
Cloudflare Mail Address Creator
Use this skill to create ordinary mailbox addresses through https://mail-api.suilong.online/admin/new_address.
Workflow
- Collect or infer
name,domain, andenablePrefix. - Default
enablePrefixtotruewhen the user does not specify it. - If the user gives a full address such as
t2@suilong.online, split it intoname=t2anddomain=suilong.online. - Never hardcode real credentials in the skill. Read them from runtime environment variables or pass them as CLI flags.
- Run
python3 scripts/create_address.pyfor single or batch creation. - Return the script's JSON output directly unless the user asks for a reformatted summary.
- Preserve the normalized statuses:
created,already_exists,auth_error,error. - If local validation fails, fix the input before attempting the API call again.
- Use
--output-format csvand optionally--output-file <path>when the user asks for exportable results.
Commands
Single address:
python3 scripts/create_address.py \
--name t2 \
--domain suilong.online \
--admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"Single full address:
python3 scripts/create_address.py \
--name t2@suilong.online \
--admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"Batch addresses from a comma-separated list:
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:
python3 scripts/create_address.py \
--names-file ./names.txt \
--domain suilong.online \
--admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"Export batch results as CSV:
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_AUTHCLOUDFLARE_MAIL_BEARER_TOKENCLOUDFLARE_MAIL_FINGERPRINTCLOUDFLARE_MAIL_LANGCLOUDFLARE_MAIL_USER_TOKENCLOUDFLARE_MAIL_API_URL
Supporting Files
- Read
references/api.mdfor the endpoint contract and error mapping. - Read
references/examples.mdfor 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/.