快速开始
先在 AI client 中安装 UKey Wallet skills。安装完成后,用户就可以直接通过自然语言发起钱包请求;skills 会在背后处理 CLI preflight、schema discovery 和安全路由。
只读请求可以直接返回结果。Quote、build、audit、simulation 这类流程只负责解释接下来会发生什么,不会直接移动资金。Transfer、swap execute、approval、broadcast 和 signing 等操作则必须经过一次明确确认。
1. 安装 Skills
Claude Code
/plugin marketplace add UKeyHQ/ukey-wallet-skills
/plugin install ukey-wallet-skills
Codex
可以直接告诉 Codex:
Fetch and follow the UKey Wallet skills install instructions.
Cursor
克隆 skill pack,并把 Cursor 指向对应的 plugin 目录:
git clone https://github.com/UKeyHQ/ukey-wallet-skills
OpenCode 和 OpenClaw
按 ukey-wallet-skills 仓库中的对应安装说明接入。不同 client 使用的是同一组四个 skills:wallet、swap、market、security。
2. 连接 Agent Wallet
在 AI client 中输入:
Connect my UKey Wallet agent session.
Skill 会通过 UKey Wallet GUI App Transfer 配对当前机器,并总结当前活动钱包。如果本地缺少 ukey wallet CLI,skill preflight 会先完成安装再继续;用户不需要手动配置 CLI 命令。
3. 先试只读 Prompt
建议先从不会移动资金的请求开始:
| 对 AI client 说 | Skill 路由 |
|---|---|
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 |
回答应以结果优先,优先给出钱包状态、route、risk 以及一个有用的下一步,而不是直接抛出原始终端输出。
4. 交易前先报价
可以输入:
Quote a swap from 1 ETH to USDC. Do not execute yet.
Swap skill 应先给出报价、执行相关安全检查、展示 route 和预估输出,并在执行前停止。后续类似 Yes, execute the swap 的确认,只能针对已经审阅过的订单继续执行。
5. 使用硬件确认
高风险操作可以输入:
Use my UKey Wallet hardware wallet for this transfer.
Wallet skill 会切换到硬件会话,并把涉及资金移动的操作升级到设备端 clear signing。完成硬件登录后,常规 wallet、transfer、swap 和 signing 类 Prompt 都可以继续复用当前硬件会话。