Install axo Skill on OpenClaw

Use this guide when you want an OpenClaw instance to use the axo wallet skill end to end.

Prerequisites

• A working OpenClaw instance
• npx available on your machine
• Axo API key for wallet initialization
• Agent workspace with a skills/ folder (or permission to create one)

1) Install the skill into your OpenClaw workspace

From the root of your OpenClaw workspace:

npx skills add https://github.com/zbdpay/axobot-cli --full-depth --skill axo

This installs axo into your local workspace skills so OpenClaw can discover it.

2) Confirm OpenClaw can see the skill

openclaw skills list
openclaw skills list --eligible
openclaw skills info axo

If axo is missing from --eligible, run:

openclaw skills check

3) Ensure axo binary is available

The skill is eligible when OpenClaw can find one of the required binaries (axo or npx).

axo --help

If axo is not installed globally yet:

npm install -g @axobot/cli
axo --help

4) Initialize wallet identity

axo init --key <your_api_key>
axo info
axo balance

5) Validate the skill in an agent session

Start a new OpenClaw session and ask for a wallet action, for example:

• "Use axo to show my wallet balance"
• "Use axo to create a 1000 sat receive invoice"
• "Use axo fetch on this paid endpoint with max 100 sats"

Shared install for multiple agents (optional)

If you want all local agents to reuse the same skill set, install/copy the skill under:

~/.openclaw/skills/axo/SKILL.md

Workspace skills still take precedence over shared skills when names conflict.

Troubleshooting

• axo not eligible: run openclaw skills check and install @axobot/cli globally.
• Skill installed but not used: start a new session so OpenClaw refreshes the skill snapshot.
• API key errors: re-run axo init --key <your_api_key> and verify with axo info.
• Command not found in sandboxed runs: ensure required binaries are also available in the sandbox image.

Related Docs

• Agent Skills
• Agent Wallet CLI
• OpenClaw Skills reference
• OpenClaw skills CLI reference