跳到主要内容

快速开始

先在 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 都可以继续复用当前硬件会话。