本页目录

OneKey Agent Wallet

当前为私有测试版。访问资格、支持的命令与钱包流程取决于 OneKey 和 CLI 版本。使用示例前，先检查已安装 CLI 的 schema。

OneKey Agent Wallet 是面向 AI Agent 的钱包能力层：Agent 可以执行真实链上动作、读取行情上下文，并把关键签名控制权交还给用户。Agent 能读取钱包状态、生成收款地址、查询历史、研究 token、报价和准备 swap、执行安全检查，并将高风险操作交给 OneKey GUI 或硬件钱包确认。

构建 AI Agent、Skills、MCP 工具、自动化脚本或命令行钱包工作流时读这一组文档；直接接入 OneKey 设备传输和底层签名 API 时再读 Hardware SDK。

Agent 能做什么

范围	Agent 能力	用户会怎么说
Wallet	查余额、展示收款地址、查询历史、准备转账、派生 BTC 地址类型	`显示我的 ETH 余额和收款地址。`
Swap & bridge	报价、构建、执行、跟踪 swap，处理 BTC sign-only PSBT，发现跨链网络	`先给我报价，确认后将 1 ETH 兑换为 USDC。`
Market & research	搜索 token、价格、trending、K 线、流动性、持仓、快速或深度研究	`Solana 现在有哪些热门代币？`
Security	代币风险检查、交易模拟、授权风险、链和地址不匹配，以及代币风险信号	`买入前，先检查这个代币的风险。`
Hardware control	连接 OneKey 设备、验证真伪、选择密码短语模式，在设备上审阅支持的签名请求	`使用我的硬件钱包处理这笔转账。`
Session control	通过 App Transfer 配对 GUI 管理的 Agent Wallet，或切换到硬件会话	`连接我的 OneKey Agent Wallet。`

工作方式

Agent 通过 onekey-wallet-skills 和 onekey CLI 调用 OneKey 能力。App Transfer 与硬件登录选择不同的会话类型；使用钱包命令前先检查活动会话。硬件确认只适用于使用硬件会话的签名请求。

从这里开始

读者	先读	目标
开发者	能力地图和 Wallet Skills	把产品能力映射到 schema-backed CLI 命令和回答契约。
Vibe coding 新手	快速开始和场景示例	先复制自然语言 prompt，再理解背后的命令。
安全审查或钱包 owner	安全规则和硬件控制	明确 agent 能读什么、能执行什么、什么时候必须交给硬件确认。
产品或支持同学	Agent Wallet 会话和 Keyless Binding	理解 GUI 管理的 Agent Wallet、keyless 绑定和活动会话模型。

当前实现

公开入口是外部 onekey-wallet-skills 仓库。Skills 支持 Claude Code、Codex、Cursor、OpenCode 和 OpenClaw，并把自然语言请求路由到 wallet、swap、market 和 security 工作流。

@onekeyfe/cli 仍然是 skills 背后的实现层。Skills 会通过实时 schema 发现支持的命令和参数，配对 App Transfer 或硬件会话，并保持结构化回答，而不是把原始终端输出暴露给用户。