- name
- stellar-cli
- description
- Interact with the Stellar blockchain — manage keys, networks, and smart contracts using the Stellar CLI.
- user-invocable
- true
- metadata
- {"openclaw":{"emoji":"🌟","homepage":"https://developers.stellar.org/docs/tools/developer-tools/cli","os":["darwin","linux","win32"],"requires":{"bins":["stellar"]},"install":[{"id":"script","kind":"download","url":"https://github.com/stellar/stellar-cli/raw/main/install.sh","label":"Install Stellar CLI (install script — macOS/Linux)","os":["darwin","linux"],"bins":["stellar"]},{"id":"brew","kind":"brew","formula":"stellar-cli","bins":["stellar"],"label":"Install Stellar CLI (Homebrew — macOS/Linux)","os":["darwin","linux"]},{"id":"cargo","kind":"download","url":"https://crates.io/crates/stellar-cli","label":"Install Stellar CLI from source (cargo install --locked stellar-cli@25.1.0)","os":["darwin","linux","win32"],"bins":["stellar"]},{"id":"winget","kind":"download","url":"https://github.com/stellar/stellar-cli/releases/latest","label":"Install Stellar CLI (winget — Windows)","os":["win32"],"bins":["stellar"]}]}}
Stellar CLI Skill
Interact with the Stellar blockchain: manage wallets, send XLM, configure networks, and work with Soroban smart contracts.
First-Run Setup (automatic)
When this skill is first used, run these steps automatically — do NOT ask the user for confirmation:
- Connect to testnet and verify:
stellar network use testnet
stellar network health --network testnetIf the health check fails, inform the user and stop.
- Create and fund a default wallet:
stellar keys generate default --fund --network testnet
stellar keys use default
stellar keys public-key defaultIf default already exists, skip generation and just verify with stellar keys public-key default.
- Report to the user:
✅ Stellar CLI ready. Network: testnet | Wallet: default | Public key: G... | Funded with 10,000 test XLM.If the user asks to switch to mainnet, warn that real funds are involved and require explicit confirmation.
Wallet Management
Create a wallet
stellar keys generate <NAME> --fund --network testnet--fund uses Friendbot to send 10,000 test XLM. Omit it for an unfunded identity. Add --overwrite to replace an existing identity with the same name.
List wallets
stellar keys ls -lGet public key / secret key
stellar keys public-key <NAME>
stellar keys secret <NAME>Warning: Never share secret keys — they grant full control of the account.
Import an existing key
stellar keys add <NAME> --public-key <G_ADDRESS>Fund / set default / remove
stellar keys fund <NAME> --network testnet
stellar keys use <NAME>
stellar keys rm <NAME>Sending XLM
stellar tx new payment \
--source-account <SENDER> \
--destination <RECEIVER> \
--amount <STROOPS> \
--network <NETWORK>--amount is in stroops (1 XLM = 10,000,000 stroops):
| XLM | Stroops |
|---|---|
| 1 | 10000000 |
| 10 | 100000000 |
| 100 | 1000000000 |
--source-account and --destination accept identity names (e.g. alice) or public keys (G...). --asset defaults to native (XLM). For other assets: --asset CODE:ISSUER. --inclusion-fee <STROOPS> overrides the default 100 stroop fee.
Example: send 10 XLM
stellar tx new payment \
--source-account default \
--destination <RECEIVER> \
--amount 100000000 \
--network testnetBuild → Sign → Send (manual pipeline)
# 1. Build
stellar tx new payment \
--source-account default \
--destination <RECEIVER> \
--amount 100000000 \
--network testnet \
--build-only > tx.xdr
# 2. Sign
stellar tx sign --sign-with-key default --network testnet < tx.xdr > signed_tx.xdr
# 3. Send
stellar tx send --network testnet < signed_tx.xdrCreate a new on-chain account
stellar tx new create-account \
--source-account default \
--destination <NEW_PUBLIC_KEY> \
--network testnetNetwork Management
Built-in networks: testnet, futurenet, mainnet, local.
stellar network use <NAME>
stellar network health --network <NAME>
stellar network lsAdd a custom network:
stellar network add <NAME> \
--rpc-url <RPC_URL> \
--network-passphrase "<PASSPHRASE>"