Agent Wallet 概览
UKey Wallet Agent Wallet 是面向 AI Agent 的钱包能力层。Agent 可以执行真实链上操作、读取行情上下文，并在关键签名环节把控制权交还给用户。它能够读取钱包状态、生成收款地址、查询历史、研究 Token、获取报价并准备 Swap、执行安全检查，并在高风险操作时交由 UKey Wallet GUI 或硬件钱包确认。
如果你正在构建 AI Agent、Skills、MCP 工具、自动化脚本或命令行钱包工作流，建议先阅读这一组文档；如果你需要直接接入设备传输或底层签名 API，再继续查看 Hardware SDK。
Agent 能做什么
| 范围 | Agent 能力 | 用户可能会这样说 |
|---|---|---|
| Wallet | 查询余额、展示收款地址、查看历史、准备转账，以及派生 BTC 地址类型 | Show my ETH balance and receiving address. |
| Swap & bridge | 获取报价、构建、执行和跟踪 Swap，处理 BTC sign-only PSBT，并发现可用的跨链网络 | Swap 1 ETH to USDC after showing me the quote. |
| Market & research | 搜索 Token、查询价格、查看 trending、K 线、流动性、持仓，以及进行快速或深度研究 | What Solana tokens are trending right now? |
| Security | 执行 Token audit、交易模拟、授权风险检查，以及识别链与地址不匹配和假合约 | Is this token safe before I buy it? |
| Hardware control | 连接 UKey Wallet 设备、验证设备、使用 passphrase mode，并在敏感操作中执行 clear signing | Use my hardware wallet for this transfer. |
| Session control | 通过 App Transfer 配对 GUI 管理的 Agent Wallet，或切换到硬件会话 | Connect my UKey Wallet agent session. |
工作方式
Agent 通过 ukey-wallet-skills 和 ukey wallet CLI 调用 UKey Wallet 能力。用户则通过 UKey Wallet GUI、keyless 账号绑定，以及可选的硬件确认来保留最终控制权。
从这里开始
| 读者 | 建议先读 | 目标 |
|---|---|---|
| 开发者 | 能力概览 和 Wallet Skills | 把产品能力映射到基于 schema 的 CLI 命令和回答约定 |
| Vibe coding 新手 | 快速开始 和 常用示例 | 先复用自然语言 Prompt，再理解背后的命令 |
| 安全审查或钱包 owner | 安全建议 和 硬件确认 | 明确 agent 能读取什么、执行什么，以及哪些操作必须交给硬件确认 |
| 产品或支持同学 | Agent Wallet 会话 和 Keyless 绑定 | 理解 GUI 管理的 Agent Wallet、keyless 绑定和活动会话模型 |
当前实现
当前公开入口是外部 ukey-wallet-skills 仓库。Skills 支持 Claude Code、Codex、Cursor、OpenCode 和 OpenClaw，并会把自然语言请求路由到 wallet、swap、market 和 security 工作流。
底层 CLI 实现仍然是 skills 背后的执行层。Skills 会基于实时 schema 发现支持的命令和参数，配对 App Transfer 或硬件会话，并保持结构化回答，而不是直接把原始终端输出暴露给用户。