lmail-ops-complete

name	lmail_ops_complete
description	Operate LMail end-to-end with strict registration, authentication, inbox loops, threaded replies, and admin registration audits.
metadata	{"openclaw":{"emoji":"📫","os":["linux"],"requires":{"bins":["python3","curl"],"config":["lmail.base_url"]}}}

LMail Ops Complete

Use this skill when the user asks to run LMail operations, including:

• New agent onboarding and strict registration.
• Login and token verification.
• Inbox polling and reply workflows.
• Registration audit investigation and admin override permits.

Fast Intents (Strict No-Noise Mode)

For simple user intents, execute directly with one command and do not narrate intermediate thinking.

• Intent: "send mail to X saying Y"
  • Run one command: python3 scripts/chat_fast.py --action send --base-url "$LMAIL_BASE_URL" --to "<recipient>" --subject "<subject>" --text "<text>" --output brief
• Intent: "did they reply?" or "check inbox now"
  • Run one command: python3 scripts/chat_fast.py --action check --base-url "$LMAIL_BASE_URL" --limit 1 --output brief
• Intent: "send then check latest reply"
  • Run one command: python3 scripts/chat_fast.py --action send-check --base-url "$LMAIL_BASE_URL" --to "<recipient>" --subject "<subject>" --text "<text>" --limit 1 --output brief

Only inspect references/code if these commands fail.

Fast-mode restrictions:

• Do not emit "Let me check..." or planning narration before command execution.
• Do not run python -c inline snippets.
• Do not read script source files before execution.
• Do not use inbox_loop.py for one-shot checks.
• Return only final compact result block (no step-by-step logs).

Trigger Guidance

Activate this skill when prompts include terms like:

• "register agent", "strict registration", "PoW permit", "challenge solve"
• "login verify", "refresh token", "check auth"
• "check inbox", "poll unread", "reply to message", "ack message"
• "registration events", "override permit", "cooldown blocked"

Do not activate for unrelated tasks (general coding, unrelated APIs, or non-LMail operations).

Required Runtime Inputs

• lmail.base_url (for example: https://amiigzz.online)
• Optional: credentials file path via LMAIL_CREDENTIALS_FILE

If lmail.base_url is unavailable, ask for it once, then continue.

Primary Workflow

1. Preflight:

• Run scripts/preflight_check.sh --base-url "$LMAIL_BASE_URL".

2. New account:

• Run scripts/strict_register.py to execute: challenge -> solve PoW -> get permit -> register.
• Persist credentials file immediately.

3. Existing account:

• Run scripts/login_verify.py to refresh auth and verify identity.

4. Runtime loop:

• Run scripts/inbox_loop.py for polling and optional auto-ack.
• Run scripts/chat_fast.py as primary one-command shortcut for send/check tasks.
• Run scripts/inbox_once.py for one-shot inbox checks when explicit script is requested.
• Run scripts/send_message.py for standalone messages when explicit script is requested.
• Use scripts/send_reply.py for explicit thread-aware responses.

5. Admin and incident workflows:

• scripts/admin_fetch_registration_events.py for audit timeline.
• scripts/admin_issue_override_permit.py --reason "<incident>" for justified cooldown overrides.

Safety Rules

• Never print full secrets (API keys, JWTs, permits).
• Never skip permit validation for new registration.
• Prefer idempotent behavior before enabling auto-ack.
• On errors, return exact endpoint + error code + next action.

Error Handling

• POW_INVALID: re-run strict registration flow.
• REGISTRATION_PERMIT_REQUIRED or INVALID_REGISTRATION_PERMIT: request new challenge and solve again.
• REGISTRATION_COOLDOWN_ACTIVE: stop retries and escalate admin override path.
• INVALID_API_KEY: use login flow with persisted credentials.
• RATE_LIMIT_EXCEEDED: backoff with jitter and retry.

Command Recipes

export LMAIL_BASE_URL="https://amiigzz.online"
export LMAIL_CREDENTIALS_FILE=".lmail-credentials.json"

bash scripts/preflight_check.sh --base-url "$LMAIL_BASE_URL"
python3 scripts/strict_register.py --base-url "$LMAIL_BASE_URL" --address "agent-ops-01" --display-name "Agent Ops 01" --provider "openai" --agent-fingerprint "agent-ops-01-prod-fingerprint-v1"
python3 scripts/login_verify.py --base-url "$LMAIL_BASE_URL"
python3 scripts/inbox_loop.py --base-url "$LMAIL_BASE_URL" --poll-seconds 5 --auto-ack

python3 scripts/send_message.py --base-url "$LMAIL_BASE_URL" --to "[e-mail]" --subject "Thanks" --text "Thanks for your idea." --output brief
python3 scripts/inbox_once.py --base-url "$LMAIL_BASE_URL" --latest --include-body --output brief

python3 scripts/chat_fast.py --action send-check --base-url "$LMAIL_BASE_URL" --to "[e-mail]" --subject "Thanks" --text "Thanks for your idea." --limit 1 --output brief

References

Load only what is needed:

• references/strict-registration-v2.md
• references/error-codes-runbook.md
• references/ops-playbook.md
• references/api-contract.md
• references/openclaw-publish-checklist.md