关于 zerion-wallet
zerion-wallet 是通过 zerion CLI 管理 Zerion 钱包的技能，说明加密本地存储、EVM 与 Solana 账户类型，以及只读 Agent 操作和需人工执行的敏感操作。
主要功能
- 01加密本地钱包存储
- 02创建和导入钱包
- 03查看钱包与存款地址
- 04配置默认钱包
- 05区分 Agent 与人工操作
适用场景
- 01查看钱包地址和账户
- 02获取钱包存款地址
- 03手动创建或导入钱包
- 04为跨链转账选择钱包
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/zerion-wallet确认已加载。
详细介绍
Zerion — 钱包管理
加密的钱包存储在 Open Wallet Standard (OWS) 保险库 ~/.ows/ 中，使用 AES-256-GCM 加密。密钥不会离开设备。
设置
如果 zerion 命令因 command not found 而失败，请安装一次：
npm install -g zerion-cli
需要 Node.js ≥ 20。有关身份验证，请参阅 zerion 总入口技能。
适用场景
- “创建新钱包”
- “从私钥 / 助记词导入我的钱包”
- “显示我的钱包” / “列出存款地址”
- “备份我的恢复短语”
- “删除此钱包”
- “将我的钱包同步到 Zerion 移动应用”
使用钱包进行链上操作 → zerion-trading。在钱包上设置 Agent 代币 → zerion-agent-management。
钱包与链
通过助记词派生的钱包（使用 wallet create 或 wallet import --mnemonic 创建）同时包含 EVM 和 Solana 账户，因此同一个钱包可以在任一链上签名，也可以作为任一方向跨链桥接的目标地址。
从单个私钥导入的钱包只包含一条链的账户：
| 导入标志 | 账户类型 | 可在哪些链上交换 | 可作为哪些链的跨链目标 |
|---|---|---|---|
--mnemonic | EVM + Solana | 两者皆可 | 两者皆可 |
--evm-key | 仅 EVM | EVM 链 | EVM 链 |
--sol-key | 仅 Solana | Solana | Solana |
wallet list 会显示每个钱包包含哪些账户。选择跨链桥接的 --to-wallet 时请使用此信息——目标钱包必须在目标链上拥有账户。
Agent 与手动操作
| 操作 | 类型 | 说明 |
|---|---|---|
wallet list、wallet fund | Agent | 只读。可安全地自主调用。 |
wallet create、wallet import、wallet backup、wallet delete、wallet sync | 手动 | 需要密码短语或交互式输入。必须由人工直接运行——Agent 不得调用。 |
只读 — Agent 可自由调用
zerion wallet list # All wallets, addresses, active policies
zerion wallet list --search <query> # Filter by name or address
zerion wallet list --limit <n> --offset <n> # Paginate
zerion wallet fund --wallet <name> # Show EVM + Solana deposit addresses
手动 — 仅限人工
这些操作会提示输入密码短语、密钥或确认信息。不得在 Agent 循环中调用。
# Create a fresh encrypted wallet (EVM + Solana, generated locally)
zerion wallet create --name <name>
# Import from existing keys (interactive secret prompts — never expose keys in shell history)
zerion wallet import --name <name> --evm-key
zerion wallet import --name <name> --sol-key
zerion wallet import --name <name> --mnemonic
# Export the recovery phrase (passphrase required)
zerion wallet backup --wallet <name>
# Permanently delete (passphrase + confirmation)
zerion wallet delete <name>
# Sync to the Zerion mobile app via a one-time QR code
zerion wallet sync --wallet <name>
zerion wallet sync --all
设置默认值
使用 zerion config 设置钱包相关配置：
zerion config set defaultWallet <name> # Used when --wallet is omitted
zerion config get defaultWallet
zerion config unset defaultWallet # Resets to "no default"
zerion config list # Show all config (sensitive values redacted)
创建 ~/.zerion/config.json 时会使用模式 0o600。
典型设置流程（由人工按顺序运行）
# 1. Create wallet (passphrase prompt; offers agent-token setup at the end)
zerion wallet create --name agent-bot
# 2. Fund it
zerion wallet fund --wallet agent-bot
# → prints EVM and Solana deposit addresses
# 3. Set as default so future commands omit --wallet
zerion config set defaultWallet agent-bot
# 4. (Optional) sync to mobile
zerion wallet sync --wallet agent-bot
完成第 1 步中的 Agent 代币提示后，即可通过 zerion-trading 自主交易。之后如需配置 Agent 代币或策略 → 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 个字符 |