lmail_ops_complete

Operate LMail end-to-end with strict registration, authentication, inbox loops, threaded replies, and admin registration audits.

3,891 stars

Best use case

lmail_ops_complete is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Operate LMail end-to-end with strict registration, authentication, inbox loops, threaded replies, and admin registration audits.

Teams using lmail_ops_complete should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/lmail-ops-complete/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/amiigzz1/lmail-ops-complete/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/lmail-ops-complete/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How lmail_ops_complete Compares

Feature / Agentlmail_ops_completeStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Operate LMail end-to-end with strict registration, authentication, inbox loops, threaded replies, and admin registration audits.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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

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

```bash
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
```

```bash
python3 scripts/send_message.py --base-url "$LMAIL_BASE_URL" --to "admin@lmail.ai" --subject "Thanks" --text "Thanks for your idea." --output brief
python3 scripts/inbox_once.py --base-url "$LMAIL_BASE_URL" --latest --include-body --output brief
```

```bash
python3 scripts/chat_fast.py --action send-check --base-url "$LMAIL_BASE_URL" --to "admin@lmail.ai" --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`

Related Skills

Presentation Mastery — Complete Slide Design & Delivery System

3891
from openclaw/skills

You are a Presentation Architect. You help build presentations that persuade, inform, and move people to action. You cover the full lifecycle: audience analysis → narrative structure → slide design → delivery coaching → post-presentation follow-up.

Content & Documentation

OpenClaw Mastery — The Complete Agent Engineering & Operations System

3891
from openclaw/skills

> Built by AfrexAI — the team that runs 9+ production agents 24/7 on OpenClaw.

DevOps & Infrastructure

n8n Workflow Mastery — Complete Automation Engineering System

3891
from openclaw/skills

You are an expert n8n workflow architect. You design, build, debug, optimize, and scale n8n automations following production-grade methodology. Every workflow you create is complete, functional, and follows the patterns in this guide.

Workflow & Productivity

MCP Engineering — Complete Model Context Protocol System

3891
from openclaw/skills

Build, integrate, secure, and scale MCP servers and clients. From first server to production multi-tool architecture.

AI Infrastructure & Integrations

Decision Engine — Complete Decision-Making System

3891
from openclaw/skills

You are an expert decision architect. Help users make better decisions using structured frameworks, reduce cognitive bias, and build organizational decision-making muscle. Every recommendation must be specific, actionable, and tied to the user's actual context.

Workflow & Productivity

Client Success & Revenue Expansion — The Complete Retention Operating System

3891
from openclaw/skills

Turn clients into long-term revenue engines. This isn't advice — it's a complete operating system with scoring models, templates, playbooks, and automation patterns that work for any B2B or B2C subscription business.

Customer Success & Retention

wechat-auto-publishing-complete

3891
from openclaw/skills

Use this skill to fully reproduce and operate a local end-to-end WeChat Official Account publishing workflow: prepare the environment, validate dependencies, configure non-sensitive placeholders for credentials, gather source material, draft articles, prepare cover and body images, assemble a WeChat-ready Markdown package, publish to draft, optionally submit for formal publication, poll status, archive outputs, and attach scheduling or alerting. Use whenever the user wants a complete reproducible公众号自动发文 skill with environment setup, templates, runbooks, and execution scaffolding, while keeping all secrets and personal account details outside the skill package. Key real-world findings: freepublish does not always behave like manual platform publishing for homepage visibility, production mode should often default to draft-only, image files must be validated by real format rather than extension alone, and multi-account deployments should use isolated directories.

shellmail

3891
from openclaw/skills

Email API for AI agents. Check inbox, read emails, extract OTP codes, search messages via ShellMail. Trigger on "check email", "inbox", "otp", "verification code", "shellmail", or any email-related requests.

RAG Engineering — Complete Retrieval-Augmented Generation System

3891
from openclaw/skills

> Build production RAG systems that actually work. From chunking strategy to evaluation — the complete methodology.

Project Manager — Complete Project Delivery System

3891
from openclaw/skills

You are a world-class project manager. You plan, track, and deliver projects on time and under budget. You use proven frameworks adapted to the project's size and complexity.

Voice AI Agent Engineering — Complete Design, Build & Deploy System

3880
from openclaw/skills

> Build production-grade AI voice agents for phone calls, customer service, sales, and automation. Platform-agnostic methodology covering conversation design, voice UX, telephony integration, and scaling.

QA & Testing Engine — Complete Software Quality System

3880
from openclaw/skills

> The definitive testing methodology for AI agents. From test strategy to execution, coverage to reporting — everything you need to ship quality software.