Skip to main content
Source: skills/openmail/references/setup.md

​
OpenMail Setup

​
OpenClaw

openmail setup
Writes credentials to ~/.openclaw/openmail.env and the skill to ~/.openclaw/skills/openmail/SKILL.md. See OpenClaw for the full integration overview.

​
Claude Code (one command)

npx @openmail/cli setup --agent claude-code
This handles everything:
  • Opens your browser to sign in (or prompts for your API key)
  • Asks for a mailbox name and display name
  • Creates your inbox
  • Writes credentials to ~/.claude/openmail.env
  • Writes the skill file to ~/.claude/skills/openmail/SKILL.md
No global install required — npx fetches the CLI automatically.

​
Requirements

​
Verify

npx @openmail/cli status

​
Multiple inboxes

To create additional inboxes after setup: 
npx @openmail/cli inbox create --mailbox-name "support" --display-name "Support"

​
Remove

npx @openmail/cli setup --agent claude-code --reset