Quickstart
Start by installing the OneKey wallet skills in your AI client. After that, users can ask wallet questions in natural language; the skills handle CLI preflight, schema discovery, and safe command routing behind the scenes.
Read-only requests should return results immediately. Quotes, builds, audits, and simulations explain what would happen without moving funds. Transfers, swap execution, approvals, broadcasts, and signing require an explicit confirmation turn.
1. Install the Skills
Claude Code
/plugin marketplace add OneKeyHQ/onekey-wallet-skills
/plugin install onekey-wallet-skillsCodex
Tell Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/OneKeyHQ/onekey-wallet-skills/main/.codex/INSTALL.mdCursor
Clone the skill pack and point Cursor at the plugin directory:
git clone https://github.com/OneKeyHQ/onekey-wallet-skillsOpenCode and OpenClaw
Use the install guide in the onekey-wallet-skills repository for each client. Every client uses the same four skills: wallet, swap, market, and security.
2. Connect an Agent Wallet
Ask your AI client:
Connect my OneKey Agent Wallet.The skill pairs the local session through OneKey GUI App Transfer and summarizes the active wallet. If the onekey CLI is missing, the skill preflight installs it before continuing; users should not need to set up CLI commands manually.
3. Try Read-Only Prompts
Start with prompts that do not move funds:
| Ask the AI client | Skill route |
|---|---|
Show my wallet balance. | Wallet |
Show my receiving address for ETH. | Wallet |
What tokens are trending right now? | Market |
What is the price of SOL? | Market |
Is this token safe before I buy it? | Security |
The response should be result-first: wallet state, route, risk, and one useful next step. It should not dump raw terminal output.
4. Quote Before Trading
Ask:
Quote a swap from 1 ETH to USDC. Do not execute yet.The swap skill should quote, run the relevant safety checks, show the expected route and output, and stop before execution. A later confirmation such as Yes, execute the swap should only execute the already-reviewed order.
5. Use Hardware Confirmation
For higher-risk actions, ask:
Use my OneKey hardware wallet for this transfer.The wallet skill switches to a hardware-backed session and fund-moving actions can be escalated to device-side clear signing. After hardware login, normal wallet, transfer, swap, and signing prompts use the active hardware-backed session automatically.