# @axon-chain/axon-skills Install official Axon skill bundles for AI agents with `npx`. This package is not a node launcher, wallet app, or SDK. It is a distribution package that copies curated Axon skill folders into agent skill roots so tools such as OpenClaw can discover them and load them at the right time. ## What Axon Is Axon is the Axon Chain mainnet project. The official GitHub README describes it as a general-purpose blockchain for AI agents with: - an independent L1 network - full EVM compatibility - agent-native on-chain capabilities - validator and Agent participation flows - wallet, RPC, SDK, and contract integration surfaces For this package, the important operating facts are: - node-facing Cosmos chain ID: `axon_8210-1` - wallet-facing EVM chain ID: `8210` - native token: `AXON` - public JSON-RPC: `https://mainnet-rpc.axonchain.ai/` This package exists so an agent can answer three questions without first opening the Axon repository: - What is Axon? - Which Axon workflow is this request asking for? - Which official Axon resources should I use next? After installation, the agent gets: - `axon-validator-node`: an operator playbook for Axon mainnet validator, Agent-validator, and sync-node work - `axon-mainnet-user`: a user-and-Agent playbook for Axon mainnet users, non-validator Agents, balances, transfers, and public RPC reads Install this package when you want the agent to understand: - what Axon task it is handling - which skill it should trigger - which chain IDs, RPC endpoints, and guardrails apply - which reference files it should read next for exact steps ## What The Agent Can Do With these installed skills, an agent can: - explain what Axon is at a high level and separate wallet flows from validator flows - configure Axon in MetaMask or other EVM wallets with the correct chain ID and RPC - inspect chain state through the public JSON-RPC endpoint - guide validator and sync-node bootstrap using the official public scripts - help check funding, sync state, `create-validator`, Agent registration, and heartbeat flows - point builders to the official SDKs, contract interfaces, release artifacts, and mainnet files ## Role Guide This package is now structured around three user intents: - ordinary users who only need wallet access, transfers, balances, and public RPC usage - users who want to become an active Agent and understand how Agent rewards work - users who want to become a validator and understand validator duties and validator-side rewards The package still installs two skills, but each skill owns a clear scope: - `axon-mainnet-user` covers ordinary-user flows and non-validator active-Agent flows - `axon-validator-node` covers validator and agent-validator flows ## Ordinary Users: How To Use Axon Ordinary users do not need to run a node or become a validator. They typically need to: - add Axon mainnet to an EVM wallet with chain ID `8210` - hold `AXON` for transfers and gas - check balances and send transfers - inspect public chain state through `https://mainnet-rpc.axonchain.ai/` - connect EVM applications that support Axon mainnet This path should trigger `axon-mainnet-user`. ## Active Agent: Lifecycle And Reward Logic Users who want to participate as active Agents without validator duties should stay in `axon-mainnet-user`, because the user skill now includes dedicated Agent guidance for: - how to register an Agent - how to keep the Agent online and active - what causes reputation to rise or fall - how Agent-side rewards are split between reputation rewards and contribution rewards - when stake matters for non-validator Agent earnings At a high level: - a registered Agent is not the same thing as a validator - a non-validator Agent can still earn Agent-side rewards - becoming an active Agent does not require validator duties ## Validators: Duties And Reward Logic Users who want to become validators should also use `axon-validator-node`. That skill now separates: - the operational path to become a validator - validator rights and obligations - the extra steps to become an Agent validator - validator mining and reward mechanics At a high level: - validators must be funded, synced, and created on chain before operating - validators must protect signing keys and avoid downtime and double-signing - validator-side rewards depend on proposer selection and validator-pool distribution - Agent validators additionally depend on heartbeat freshness, reputation, and stake-weighted mining power ## Included skills - `validator`: installs `axon-validator-node` for validator, Agent-validator, and sync-node operations - `user`: installs `axon-mainnet-user` for wallet setup, active-Agent flows, balances, transfers, and public RPC usage - `all`: installs both skills ## Install ```bash npx @axon-chain/axon-skills install validator npx @axon-chain/axon-skills install user npx @axon-chain/axon-skills install all ``` Default installs copy skills into both agent roots: - `${OPENCLAW_STATE_DIR:-~/.openclaw}/skills` - `${AGENTS_SKILLS_DIR:-${AGENTS_HOME:-~/.agents}/skills}` Repeat installs replace the packaged skill folders in place so updates are easy to roll out. ## Commands ```bash npx @axon-chain/axon-skills list npx @axon-chain/axon-skills install validator npx @axon-chain/axon-skills install user npx @axon-chain/axon-skills install all npx @axon-chain/axon-skills install all --dry-run npx @axon-chain/axon-skills install validator --dest /path/to/skills ``` ## How Agents Use It The installed folders are normal skill folders with `SKILL.md` entrypoints and bundled references. An agent reads the skill metadata to decide when to trigger it, then reads the body and reference files to answer Axon-specific requests safely. In practice: - wallet, public RPC, Agent registration, active-Agent, and Agent-reward requests should trigger `axon-mainnet-user` - validator, sync, recovery, validator-economics, and agent-validator requests should trigger `axon-validator-node` - the package gives the agent domain rules and routing, not a running service ## Official GitHub References Use these as the source of truth when more detail is needed: - Project overview and mainnet facts: [github.com/axon-chain/axon/blob/main/README.md](https://github.com/axon-chain/axon/blob/main/README.md) - Latest releases: [github.com/axon-chain/axon/releases/latest](https://github.com/axon-chain/axon/releases/latest) - Mainnet genesis: [github.com/axon-chain/axon/blob/main/docs/mainnet/genesis.json](https://github.com/axon-chain/axon/blob/main/docs/mainnet/genesis.json) - Mainnet bootstrap peers: [github.com/axon-chain/axon/blob/main/docs/mainnet/bootstrap_peers.txt](https://github.com/axon-chain/axon/blob/main/docs/mainnet/bootstrap_peers.txt) - Validator startup script: [github.com/axon-chain/axon/blob/main/scripts/start_validator_node.sh](https://github.com/axon-chain/axon/blob/main/scripts/start_validator_node.sh) - Sync-node startup script: [github.com/axon-chain/axon/blob/main/scripts/start_sync_node.sh](https://github.com/axon-chain/axon/blob/main/scripts/start_sync_node.sh) - TypeScript SDK: [github.com/axon-chain/axon/tree/main/sdk/typescript](https://github.com/axon-chain/axon/tree/main/sdk/typescript) - Python SDK: [github.com/axon-chain/axon/tree/main/sdk/python](https://github.com/axon-chain/axon/tree/main/sdk/python) - Solidity interfaces and precompile bindings: [github.com/axon-chain/axon/tree/main/contracts/interfaces](https://github.com/axon-chain/axon/tree/main/contracts/interfaces) - Agent heartbeat daemon: [github.com/axon-chain/axon/blob/main/tools/agent-daemon/README_EN.md](https://github.com/axon-chain/axon/blob/main/tools/agent-daemon/README_EN.md) ## Verify ```bash openclaw skills list ``` If OpenClaw is not installed on the current machine, inspect the installed skill folders directly under the target roots and confirm `SKILL.md` exists in each installed directory.