Zerion Wallet 属于 Zerion AI 技能体系中的钱包管理技能，用于在本地创建和操作 Zerion 钱包。其核心特点是将加密钱包保存在本地 Open Wallet Standard（OWS）保险库中，路径为 ~/.ows/，采用 AES-256-GCM 加密，私钥不会离开设备。
用途
该技能用于处理与本地钱包相关的日常操作，包括创建新钱包、从已有私钥或助记词导入钱包、查看钱包列表与充值地址、备份恢复短语、删除钱包，以及将钱包同步到 Zerion 移动应用。链上交易操作不在本技能范围内，需使用 zerion-trading；钱包上的智能体代币（agent-token）设置则属于 zerion-agent-management。
安装与前置条件
若执行 zerion 命令时提示 command not found，可一次性安装：npm install -g zerion-cli。运行需要 Node.js ≥ 20。认证方式参见 zerion 总技能说明。
钱包与链
通过 wallet create 或 wallet import --mnemonic 创建的助记词钱包同时持有 EVM 和 Solana 账户，因此同一钱包可在两条链上签名，也可作为任一方向跨链桥的接收地址。
从单一私钥导入的钱包只持有对应链的账户：使用 --mnemonic 导入可获得 EVM + Solana 账户，两条链均可兑换，也可作为两条链的跨链接收地址；使用 --evm-key 导入仅获得 EVM 账户，只能在 EVM 链上兑换和作为跨链接收地址；使用 --sol-key 导入仅获得 Solana 账户，只能在 Solana 上兑换和作为跨链接收地址。wallet list 会显示每个钱包持有的账户类型，在跨链桥选择 --to-wallet 时可用于确认目标钱包是否具备目标链账户。
智能体与人工操作
wallet list 与 wallet fund 属于只读操作，智能体可安全自主调用。wallet create、wallet import、wallet backup、wallet delete、wallet sync 属于人工操作，需要口令或交互式输入，必须由人工直接运行，智能体不得调用。
只读命令示例： zerion wallet list zerion wallet list --search <query> zerion wallet list --limit <n> --offset <n> zerion wallet fund --wallet <name>
人工命令示例（会提示输入口令、密钥或确认，不应在智能体循环中调用）： zerion wallet create --name <name> zerion wallet import --name <name> --evm-key zerion wallet import --name <name> --sol-key zerion wallet import --name <name> --mnemonic zerion wallet backup --wallet <name> zerion wallet delete <name> zerion wallet sync --wallet <name> zerion wallet sync --all
设置默认钱包
钱包相关配置通过 zerion config 设置：zerion config set defaultWallet <name> 用于在省略 --wallet 时指定默认钱包；zerion config get defaultWallet 读取当前默认钱包；zerion config unset defaultWallet 重置为无默认；zerion config list 显示全部配置（敏感值会被遮蔽）。~/.zerion/config.json 创建时权限为 0o600。
典型初始化流程（由人工按顺序执行）
- 创建钱包：zerion wallet create --name agent-bot（会提示口令，结束时提供 agent-token 设置选项）。
- 充值：zerion wallet fund --wallet agent-bot，输出 EVM 与 Solana 充值地址。
- 设为默认，便于后续命令省略 --wallet：zerion config set defaultWallet agent-bot。
- 可选：同步到移动端：zerion wallet sync --wallet agent-bot。
第 1 步完成 agent-token 提示后，钱包即可通过 zerion-trading 进行自主交易；后续如需配置 agent token 或策略，参见 zerion-agent-management。
常见错误
wallet_exists：钱包名称已被占用，可更换名称或先执行 wallet delete。wallet_not_found：名称不在 OWS 保险库中，可用 zerion wallet list 查看现有钱包。bad_passphrase：口令错误，重试即可，口令在创建时设定。bad_mnemonic：恢复短语格式无效，需重新输入，且必须是有效的 BIP-39 助记词。bad_evm_key：无效的 0x 前缀十六进制，0x 之后应为 64 个十六进制字符。bad_sol_key：无效的 base58 密钥对，Solana 密钥为 base58 编码，长度至少 87 个字符。
限制
本技能仅覆盖本地钱包管理，不包含链上交易与智能体代币策略配置。安装、认证、口令与密钥输入等安全相关操作需由人工完成，智能体只能执行只读命令。