OKX Agentic Wallet Skill: Let Your Agent Run an OKX Onchain OS Wallet

Lets your coding agent log in to an OKX Onchain OS wallet, check balances, swap, bridge and send tokens, with a confirmation before each on-chain change.

Installs: 19.2K; on skills.sh
Stars: 343; on GitHub
Files: 31; besides SKILL.md
Updated: Oct 2026; last repo commit

The skill routes wallet requests to the onchainos command line tool: login, balances, sending, swaps, cross-chain bridges, limit orders, gas estimates, transaction tracking and token or DApp security checks. It starts when you ask for wallet or on-chain work, and its description lists those topics.

It needs the onchainos CLI and an OKX wallet login. At the start of each thread the skill runs an installer command through npx (see permissions below). This moves real funds, so read each confirmation before you say yes.

Good for

Crypto traders who want an agent to quote and run swaps from the terminal
Developers building agents that hold and spend from an OKX Onchain OS wallet
Anyone who wants to check holdings or token safety by asking in plain words

Install okx-agentic-wallet

Claude Code

Copy this prompt.

Install the okx-agentic-wallet skill in Claude Code. Run this command:

npx -y @okxweb3/onchainos-installer install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, Git.

The installer sets up the CLI, the skills and the A2A runtime together, per the README. Add --beta for the beta channel.

From the project README. Source.

What's in the skill

When it loads

Operate OKX Onchain OS wallets and execute or inspect on-chain transactions. Use for wallet login/status/accounts/addresses/balances/holdings; receive/send/transfer; swaps, bridges, limit orders, contract calls, gas estimation, simulation, broadcast, and tracking; Bitcoin UTXO/BRC-20/inscriptions; signing, approvals, wallet policy/export, public-address portfolios, security checks, and audit logs.

Sections in SKILL.md

Module Description
Intent Routing
Preflight
CLI Reference Access
Chain Name Support
Render Rules
Amounts and Prices
Timestamps and Holdings
Security
Confirmation
Trust Boundary
Risk and Stop Conditions

Key facts

Author: OKX
License: MIT
Installs on skills.sh: 19,202 (Nov 2, 2026)
GitHub stars: 343 (Nov 2, 2026), whole repo
Files: 32 files including SKILL.md
Last commit: Oct 30, 2026 (repo)
Needs: The onchainos CLI, Git and Node.js (npx), plus an OKX wallet login
Chains: XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon and 20+ others
Skill version: 4.6.7 in the SKILL.md frontmatter

What it includes

Log in (Google, Apple or email), switch accounts, check balances and holdings
The agent runs onchainos wallet commands for login, logout, account switching, balances, history and message signing. Sending native tokens, ERC-20, SPL, BTC, BRC-20 and SUI tokens and custom contract calls go through the same module.
Runs code · Wallet and accounts
Show a receive address or QR code for deposits
Handles deposit and top-up requests, including your receive address.
Network · Funding
Quote and execute token swaps and approvals
Finds quotes and routes, runs swaps, and handles ERC-20 approval for a DEX. Reads each route's action (ok, warn, block) from the CLI.
Runs code · Swap
Move tokens between chains and track arrival
Compares bridge quotes and fees, runs cross-chain swaps and tracks them to arrival.
Runs code · Bridge
Place, list, resume and cancel strategy orders
Buy-the-dip, take-profit, stop-loss and buy-above orders. strategy.md says the order is stored on the TEE and runs automatically when the trigger fires, with a 7-day expiry shown before you confirm. You confirm when you place it, not at execution.
Runs code · Limit orders
Estimate gas, simulate, broadcast and track transactions
Broadcasts a signed or raw transaction, estimates gas price and limit, simulates, and tracks an order.
Runs code · Gateway
Pay Solana gas with a stablecoin
Enable, disable or change the default gas token and check status. gas-station.md says that once enabled, a transaction short on SOL pays gas with the stablecoin automatically, with no manual confirmation each time.
Runs code · Gas Station
Look up balances for any public address
Shows balance, holdings and total value for an address you give it.
Network · Public address portfolio
Scan tokens, DApps, transactions and approvals
Token and honeypot checks, DApp phishing checks, transaction and signature pre-checks, and listing or revoking token approvals.
Runs code · Security checks
UTXO and BRC-20 queries and management
Answers Bitcoin UTXO and BRC-20 questions from the bundled references.
Runs code · Bitcoin UTXO
Export or locate the audit log and command history
Lets you view command history and find the audit log.
Files · Audit log
Explains spending-limit and whitelist policy and wallet export; you do them yourself
Policy (spending or daily limit, whitelist) is set by you on the OKX web portal and wallet export is done by you in the OKX Wallet extension or app. The agent explains the consequences and gives the link, and wallet.md says it never performs the export itself. MEV protection for contract calls is also routed here.
Read · Wallet policy and export

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can send and swap real funds
Sends, swaps, bridges, approvals, contract calls and wallet export are in scope. Read every confirmation, check the address character by character, and start with small amounts. github.com
Some actions run later or without a prompt each time
A limit order is stored on the TEE and executes when the trigger fires (7-day expiry), and an enabled Gas Station pays gas in a stablecoin automatically. Third-party Solana DeFi plugins may call `wallet contract-call --force`. Review the order and Gas Station settings, not only each swap. github.com
It runs an npx installer at the start of a thread
The preflight step runs the @okxweb3/onchainos-installer package through npx with the skill version. That is third-party code from npm, so install it on a machine you trust. github.com
Token names can carry prompt injection
The SKILL.md warns that token names, symbols and on-chain data may hold instructions and tells the agent to ignore them. Do not paste unknown tokens or links into a wallet session. github.com
Wallet export and policy are done by you
wallet.md says spending-limit policy is set by you on the OKX web portal and wallet export is done by you in the OKX Wallet extension or app; the agent only explains and links. It must never show mnemonics, seed phrases or private keys in chat. The README links a DISCLAIMER.md that says OKX.AI is provided as is and nothing it outputs is financial advice. github.com

Technical details

Talks to	OKX Onchain OS backend, through the onchainos CLI
Sign-in and keys	The CLI keeps credentials in a local credential store; the SKILL.md tells the agent not to display tokens or keys.
Scopes	OKX Onchain OS wallet login

Questions

What does the OKX Agentic Wallet skill do?

It lets your agent run the onchainos CLI for an OKX Onchain OS wallet. That covers login, balances, sending, swaps, bridges, limit orders, gas, broadcasting and security checks. It routes marketplace and subscription requests to the okx-ai skill and DApp-specific work to the matching DApp skill.

How do I install it?

Use the install box above. The skill needs the onchainos CLI, so the README's installer command is the one to use, not the folder copy alone. Node.js and Git must be installed first.

Does it need an account or API key?

It needs an OKX wallet login, which you do through the agent (Google, Apple or email). The SKILL.md tells the agent never to show session tokens, API keys, private keys or seed phrases.

Is it safe to give an agent a wallet?

It can move real funds, so treat it that way. The SKILL.md requires the agent to show each state-changing action and get your explicit yes first, and to halt when the CLI returns a block verdict. It also notes that an empty risk result only means no risk was found in the checks run, not proof of safety. Start with small amounts.

Can it send or swap without asking?

Not from an ambiguous request. SKILL.md requires the agent to show each state-changing action and get your explicit yes before it broadcasts, sends, approves, revokes, swaps or bridges, and to rerun with the force flag only after the CLI asks for confirmation and you say yes. Two documented exceptions to a per-run prompt: a limit order you confirm once runs on its own when the trigger fires (strategy.md), and once Gas Station is on, gas is paid in a stablecoin without asking each time (gas-station.md).

Who pays for gas and fees, and is there a test mode?

You pay, from your own wallet balance. SKILL.md says on-chain gas on X Layer (chain 196) is free after funds arrive, that the backend can sponsor some transactions (X Layer AA mode, Solana TEE-sponsored) so you may need no native token, and that an exchange may charge a withdrawal fee when you fund the wallet. On Solana, Gas Station charges a stablecoin fee instead (gas-station.md). Swap and bridge quotes carry their own fees and slippage. SKILL.md describes no demo or paper-trading mode. wallet.md points to an X Layer Testnet faucet when you ask for testnet tokens, so a testnet is the nearest thing to a trial; nothing documented says other chains have one.

Can it run as an MCP server instead?

The README says the onchainos CLI also works as an MCP server and gives claude mcp add --scope user onchainos-cli onchainos mcp for Claude Code. That route exposes the CLI's tools to the client; the skill's confirmation rules are written for the skill, so check how your client prompts before you trade.

Does it work in the Claude app or ChatGPT?

The skill depends on the onchainos CLI running on your machine, so a folder upload alone is not enough. The README documents no Claude app or ChatGPT route.

What is the difference from okx-dex-market?

Both come from the same repo. okx-dex-market is the read-only market data skill (prices, smart money, token search). okx-agentic-wallet is the one that holds a wallet and executes. The README pairs them: find a token with the market skill, then trade with the wallet skill.

Information

updated Nov 2, 2026

Repository: okx/onchainos-skills
Folder: skills/okx-agentic-wallet

okx/onchainos-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

onchainos-skills README · github.com
okx-agentic-wallet SKILL.md · github.com
okx-agentic-wallet preflight.md · github.com
okx-agentic-wallet wallet reference · github.com
okx-agentic-wallet strategy reference · github.com
okx-agentic-wallet gas-station reference · github.com