OpenClaw · Skill
Xmtp CLI
Use the xmtp command to test, debug, and interact with XMTP conversations, groups, and messages from the command line. This skill is the entry point; use the sub-skills below for specific CLI tasks.
Install
Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.
Primary command
clawhub install humanagent/xmtp-cliClawHub installer
npx clawhub@latest install humanagent/xmtp-cliOpenClaw CLI
openclaw skills install humanagent/xmtp-cliDirect OpenClaw install
openclaw install humanagent/xmtp-cliWhat this skill does
Use the xmtp command to test, debug, and interact with XMTP conversations, groups, and messages from the command line. This skill is the entry point; use the sub-skills below for specific CLI tasks.
Why it matters
Lets developers test and script XMTP interactions directly from the terminal without writing application code.
Typical use cases
- Send a test message to an XMTP address from terminal
- Debug why a group conversation isn't syncing
- List all members and permissions in a group
- Inspect inbox state for a wallet address
- Script XMTP message flows in CI or local dev
Source instructions
XMTP CLI
Use the xmtp command to test, debug, and interact with XMTP conversations, groups, and messages from the command line. This skill is the entry point; use the sub-skills below for specific CLI tasks.
When to apply
- Testing or debugging XMTP from the command line
- Sending messages or creating and managing groups
- Listing or finding conversations, members, and messages
- Syncing conversations and messages
- Managing group permissions
- Demonstrating content types (text, markdown, attachment, transaction, deeplink, miniapp)
Sub-skills
| Sub-skill | Use when |
|---|---|
| setup | Initialize CLI and configure env (init, env variables) |
| groups | Create DM or group, update group metadata |
| send | Send messages to address or group |
| list | List conversations, members, messages; find by address or inbox |
| debug | Get info, resolve address, inspect inbox |
| sync | Sync conversations or sync all |
| permissions | List/info group permissions, update permissions |
| content | Demo text, markdown, attachment, transaction, deeplink, miniapp |
| debugging | Enable CLI debug logging (XMTP_FORCE_DEBUG env) |
How to use
- Pick the sub-skill that matches the task (e.g. send message → send).
- Read that sub-skill’s
SKILL.mdand itsrules/for step-by-step guidance.
Install
npm install -g @xmtp/cli
# or
pnpm add -g @xmtp/cli
# or
yarn global add @xmtp/cli
Run without install
npx @xmtp/cli <command> <arguments>
# or pnpx / yarn dlx
Help
xmtp --help
xmtp <command> --help
Full documentation: docs.xmtp.org