A professional toolkit for deploying, configuring, and managing Xian blockchain nodes using Docker and CometBFT.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install xian-node-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install xian-node-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Xian Node Management?
Xian Node is a comprehensive skill designed to streamline the lifecycle of Xian blockchain nodes. It enables developers to interact with the Xian L1 network, which features native Python smart contracts built on the CometBFT consensus engine. Using Openclaw Skills like this one, users can automate the deployment of validator, service, or seed nodes with precision.
The skill leverages the xian-stack for containerized environments, providing a robust interface for handling node initialization, network synchronization, and performance monitoring. Whether joining the official mainnet or bootstrapping a private testnet, this skill ensures consistent and reliable node operations for decentralized application backends.
Xian Node Management Use Cases
- Joining the Xian mainnet or testnet as a validator or service node.
- Bootstrapping a new private blockchain network with custom genesis files.
- Monitoring node health and synchronization status via RPC queries.
- Managing node lifecycles including updates, wipes, and restarts within Docker containers.
- Testing Python smart contracts against a local or remote node instance.
How Xian Node Management Works
- The skill clones the xian-stack repository and prepares the environment variables for the core and contracting engines.
- Docker containers are built and orchestrated to house the Xian core and CometBFT services.
- The node is initialized to generate necessary P2P keys and the local configuration directory structure.
- Specific network parameters, such as seeds, monikers, and genesis files, are applied through a specialized configuration layer.
- Services are launched using PM2 inside the container, while the skill monitors logs for successful peer discovery and block syncing progress.
Xian Node Management Setup
To integrate this with Openclaw Skills, follow these essential setup steps:
git clone https://github.com/xian-network/xian-stack.git
cd xian-stack
make setup CORE_BRANCH=mainnet CONTRACTING_BRANCH=mainnet
make core-build
make core-up
make init
Configure the node for the Xian mainnet:
make configure CONFIGURE_ARGS='--moniker "my-node" --genesis-file-name "genesis-mainnet.json" --seed-node-address "[email protected]" --copy-genesis'
Xian Node Management Data Schema & Taxonomy
The skill organizes its blockchain data and configuration according to the CometBFT standard within the host directory:
| Path | Description |
|---|---|
.cometbft/ |
Root directory for node identity, P2P keys, and config.toml. |
.cometbft/data/ |
The persistent storage for the blockchain ledger and state. |
.cometbft/config/genesis.json |
The network definition file containing the initial state and validators. |
xian-core/ |
Contains the Xian ABCI application logic. |
xian-contracting/ |
Houses the Python virtual machine used for smart contract execution. |
Xian Node Management Advanced Features
- Validator key generation via built-in Python nacl signing scripts.
- Support for Service Nodes with Blockchain Data Service (BDS) integration utilizing PostgreSQL and GraphQL.
- Automated full reset capabilities using the make dwu (Down, Wipe, Init, Up) command sequence.
- Prometheus metrics integration on port 26660 for advanced telemetry and alerting.
- Flexible branch management for testing experimental features in the core or contracting layers.
SKILL.md
Loading
Related Openclaw Skills
Three Minds Multi-Agent Collaboration System
A multi-agent orchestration framework that launches three distinct AI personas to collaborate, refactor, and review code until a unanimous consensus is reached.
Claude Code Skill
A powerful interface to control Claude Code via MCP, enabling persistent sessions and multi-agent collaboration for coding tasks.
OpenClaw Async Task
A powerful background execution tool for Openclaw Skills that prevents HTTP timeouts during long-running operations.
Encrypted File Reader
A Python-powered utility for reading content from protected or encrypted local files within secure enterprise environments.
Xian SDK for Python
A comprehensive Python SDK for building decentralized applications, managing cryptographic wallets, and interacting with smart contracts on the Xian blockchain.
Spotify Player
A terminal-based Spotify controller that allows AI agents and developers to manage music playback and searches via command-line interfaces.
wacli
A command-line interface for sending WhatsApp messages, searching history, and synchronizing chat data via AI agents.
Featured*
