Tema

Support

Change Log

Install Your Agentic Wallet#

Provide your AI Agent with onchain wallet capabilities — private keys protected by TEE, automatic risk detection before transactions, from wallet setup to onchain trading all through conversation.

Preparation: Install an AI Agent#

This guide uses Claude Code as an example. Onchain OS supports all mainstream agents (Cursor, OpenClaw, etc.).

Step 1: Add Onchain OS to Your Agent#

Tell your Agent:

Plain

Run npx skills add okx/onchainos-skills to install Onchain OS skills.
Note: Please install to the skill directory corresponding to your current Agent.

The Agent will complete the installation automatically. For more details, see Github.

Step 2: Create a Wallet#

Tell your Agent:

Plain

Log in to Agentic Wallet with email

Enter your email and wait for the verification code:

Plain

<email>

Enter the verification code:

Plain

<otp-code>

Once verified, the Agent will automatically create a wallet on first login:

Plain

Wallet created successfully!
EVM Address:    <evm-address>
Solana Address: <solana-address>

Note

Private keys are generated and stored entirely within the TEE — never exposed to anyone, including your Agent. Logging in with the same email restores the existing wallet automatically.

Step 3: Try It Out!#

Fund Your Wallet#

Transfer assets to your Agentic Wallet address via onchain address or exchange withdrawal.

Check Balance#

Plain

Check my wallet balance.

Once the funds arrive, you can start onchain trading! Try using natural language to have your Agent execute trades!

Trading Example#

User tells the Agent to filter tokens and buy:

Plain

Find tokens on Solana that KOLs are buying, market cap under $5M, at least 2 KOL wallets buying, and buy 1 USDT worth

Agent filters tokens and recommends the best pick:

Plain

Token       Market Cap   Smart Money Wallets        Sell Ratio
<token_a>   $9.99M      9 wallets (×9 signals)     9.99%
<token_b>   $9.99M      9 wallets (×9 signals)     99.99%

<token_a> is the best choice — lowest sell ratio and most signal occurrences.
Buying 1 USDT worth.

Agent gets trade quote and asks for confirmation:

Plain

Trade quote:

Details         Value
Sell            1 USDT
Buy             ~99.99 <token_a>
Price           1 <token_a> ≈ $0.0099
Route           USDT → ... → <token_a>
Price Impact    -0.99%
Honeypot        No
Tax             0%
Gas Fee         ~$0.009

Confirm trade?

User confirms the trade:

Plain

Confirm

Agent broadcasts transaction:

Plain

Trade successful!

Details         Value
Sell            1 USDT
Buy             ~99.99 <token_a>
Route           USDT → ... → <token_a>
Price Impact    -0.99%
Slippage        1%
Order ID        <order-id>
Wallet          <wallet-address> (Wallet 1)

Transaction broadcast on Solana!

Note

The above example is for demonstration purposes only and does not constitute investment advice. Please make trading decisions based on your own judgment.

Skills/MCP Services

Run Your First AI Agent

Table of contents

Preparation: Install an AI Agent

Step 1: Add Onchain OS to Your Agent

Step 2: Create a Wallet

Step 3: Try It Out!