On this page
Quickstart
Private beta. Access, supported commands, and wallet flows depend on your OneKey and CLI versions. Inspect the installed CLI schema before using these examples.
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, where supported signing requests require the user to review and confirm on the device. Available Clear Signing details depend on the chain, firmware, and CLI version. After hardware login, wallet, transfer, swap, and signing prompts use the active hardware-backed session; verify its address before preparing a fund-moving action.