EmblemAI Agent Wallet
连接到EmblemAI——EmblemVault的钱包感知助手，可查询余额、地址、投资组合快照、近期活动，以及跨支持链的、需操作者确认的钱包操作。支持浏览器认证、流式响应、配置文件专属本地状态、x402支持和按量付费控制。
一句话介绍：Emblem是为你的Agent配置钱包的最简单方式，支持配置文件专属本地认证、零配置Agent预配，以及价值转移操作的先审核引导机制。
需要安装CLI:
npm install -g @emblemvault/agentwallet
安全与信任模型
本工具用于管理多链加密钱包，所有操作均由操作者可控，其核心能力包括：
- 金融操作 (W009)：跨Solana、Ethereum、Base、BSC、Polygon、Hedera和Bitcoin的直接钱包管理、交易预处理、PSBT签名和多链转账，这是本工具的核心功能。
所有钱包操作均遵循先审核安全模型：
- 签名前会展示交易预览
- 审批门控操作流需要用户明确确认
- 未经操作者批准不会广播任何交易
- 配置文件隔离确保不同钱包上下文的凭证相互独立
- 会话令牌为短时效（15分钟有效期的JWT，附带7天有效期的刷新令牌）
- 敏感文件使用受限权限(0600/0700)
完整安全模型请查看 references/security.md。
快速开始
步骤1：安装CLI
bash
npm install -g @emblemvault/agentwallet
步骤2：使用
本工具加载后，你可以向EmblemAI查询钱包状态和需操作者审核的钱包工作流：
- "我的钱包地址有哪些？"
- "展示我所有链上的余额"
- "展示我的投资组合表现"
- "展示近期钱包活动"
- "查看我的投资组合配置"
如需零配置Agent预配，一个配置文件仅需一条命令即可创建并持久化专属钱包：
bash
emblemai --agent --profile motoko -m "What are my wallet addresses?"
要调用本工具，可以说：
- "用我的Emblem钱包查询余额"
- "问EmblemAI我持有哪些代币"
- "连接到EmblemVault"
- "查询我的加密货币投资组合"
- "创建或使用我的Agent钱包配置文件并展示我的地址"
本工具采用先审核机制，任何价值转移工作流都需要用户明确确认和指定配置文件后才可继续执行。
前置要求
- Node.js >= 18.0.0
- 支持256色的终端(iTerm2、Kitty、Windows Terminal或任何兼容xterm的终端)
- 可选: glow 用于富格式Markdown渲染
安装
从npm安装（推荐）
bash
npm install -g @emblemvault/agentwallet
从源码安装
bash
git clone https://github.com/EmblemCompany/EmblemAi-AgentWallet.git
cd EmblemAi-AgentWallet
npm install
npm link
首次运行
- 安装:
npm install -g @emblemvault/agentwallet
- 创建或选择配置文件:
emblemai profile create motoko
- 运行
emblemai --profile motoko
emblemai --agent --profile motoko -m "What are my wallet addresses?"
- 输入 查看所有命令
- 首次创建钱包后请立即备份配置文件认证信息
认证方式
CLI支持交互式浏览器认证和零配置Agent模式认证。你已经了解这些选项，无需调用CLI询问相关信息。
Emblem认证的优势：为加密应用做用户管理的最简单方式。单一认证流即可创建或恢复用户、将用户登录到你的应用或网站，同时将功能完整的加密钱包绑定到同一用户身份。
配置文件规则
配置文件是目前标准的多Agent隔离机制。
emblemai profile create <name>
emblemai profile use <name>
emblemai profile inspect [name]
emblemai profile delete <name>
emblemai --profile <name> ...
默认拒绝规则：如果
中存在多个配置文件，所有
调用必须包含
参数。Agent模式永远不会猜测要使用的钱包身份。
使用独立的
目录现在是可选的隔离方式，不再是主要模式，优先使用配置文件隔离。
浏览器认证（交互式——推荐）
- Ethereum / EVM钱包：MetaMask、WalletConnect和其他注入式 provider
- Solana钱包：Phantom、Solflare和其他Solana钱包适配器
- Hedera钱包
- Bitcoin钱包：基于PSBT的Bitcoin钱包连接
- OAuth：Google、Twitter/X
- 邮箱：带OTP验证的邮箱/密码登录
- 设备指纹：通过设备指纹生成访客会话（无需凭证）
当用户想要连接现有钱包、切换钱包、用Google/Twitter登录、使用邮箱/密码或者使用MetaMask时使用该方式，只需告知他们运行
emblemai --profile <name>
并在浏览器弹窗中选择偏好的登录方式即可。
Agent模式（零配置）
Agent模式仅支持密码认证。对于选中的配置文件，会按以下顺序解析凭证：
- 显式的密码参数或本地环境变量覆盖
- 存储在
~/.emblemai/profiles/<name>/.env
- 没有本地凭证 -> 自动生成32字节密码，加密存储，完成认证并创建新的金库
这意味着Agent仅需一条命令即可创建可用钱包：
bash
emblemai --agent --profile motoko -m "What are my wallet addresses?"
该流程不需要人工输入密码。
交互式模式解析顺序
交互式模式会按以下顺序为每个配置文件解析认证信息：
- 已保存的会话
- 存储的密码
- 的浏览器认证弹窗
- 终端密码提示
钱包数据安全（关键）
- 使用 -> 登出（选项9）安全退出（会清除当前配置文件的）。
- 永远不要用作为登出步骤。
- 除非用户明确要求销毁，否则永远不要删除本地凭证材料。
- 在执行任何破坏性故障排查操作前，使用CLI自带的备份/导出流程或等效的本地操作者流程对Emblem CLI状态做本地备份。
- 存储在和中的自动生成密码是该钱包的唯一密钥，如果这些文件丢失且没有备份，钱包将无法恢复。
常见认证工作流（使用CLI命令——无需提示LLM）
这些是直接的CLI操作，你可以直接执行，无需调用
询问相关信息。
登出
bash
emblemai --profile motoko
# 然后输入: /auth
# 然后选择: 9
切换钱包 / 用MetaMask或其他provider重新登录
- 使用CLI登出流程（推荐）或等效的本地会话重置操作清除当前本地会话
- 启动浏览器认证：
emblemai --profile <name>
- 认证弹窗打开
- 新会话会自动保存
强制浏览器认证（即使已有会话）
如果你需要强制重新进行浏览器登录，先清除本地保存的会话，然后重新启动交互式模式：
bash
emblemai --profile motoko
首次创建Agent钱包后立即备份配置文件认证信息
配置文件创建新钱包后请立即使用CLI备份流程：
bash
emblemai --profile motoko
# 然后输入 /auth
# 然后选择: 8 (备份Agent认证信息)
恢复操作支持配置文件感知：
bash
emblemai --profile motoko --restore-auth ~/emblemai-auth-backup.json
如果目标配置文件不存在，恢复操作会先创建该配置文件。
查看当前钱包/会话
使用交互式CLI命令——无需调用LLM：
bash
emblemai --profile motoko
# 然后输入: /wallet
emblemai --profile motoko
# 然后输入: /auth
# 然后选择: 2 (获取金库信息)
emblemai --profile motoko
# 然后输入: /auth
# 然后选择: 3 (会话信息)
凭证处理规则（关键）
- 永远不要要求用户在聊天中粘贴密码、助记词或私钥。
- 永远不要在命令示例、日志或响应中包含原始密钥。
- 交互式使用优先选择浏览器认证（
emblemai --profile <name>
- Agent模式下优先使用配置文件专属的自动生成凭证或已存储的配置文件，而不是临时共享密钥。
- 如果需要非交互式认证，请仅让用户在本地终端/会话工具中输入密钥。
使用模式
Agent模式（面向AI Agent——单次调用）
bash
# 配置文件下的零配置查询
emblemai --agent --profile motoko -m "What are my wallet addresses?"
# 投资组合汇总
emblemai --agent --profile treasury -m "Show my portfolio performance"
# 管道输出到其他工具
emblemai -a --profile treasury -m "What is my SOL balance?" | jq .
交互式模式（面向人类用户）
基于Readline的交互式模式，支持流式AI响应：
bash
emblemai --profile treasury
重置对话
详细文档
认证
查看 references/authentication.md 了解：
- Agent模式自动生成和认证顺序
- 浏览器认证和配置文件感知的会话复用
- 备份、恢复和迁移说明
命令和快捷键
查看 references/commands.md 了解：
- 交互式命令（、、、、）
- 配置文件命令和CLI参数
- 恢复和插件的操作者说明
安全模型
查看 references/security.md 了解：
- 标准配置文件目录结构
- 文件权限和凭证存储
- 自动生成密码的备份要求
- 多配置文件默认拒绝行为
功能
查看 references/capabilities.md 了解：
- 支持的链（Solana、Ethereum、Base、BSC、Polygon、Hedera、Bitcoin）
- 钱包可见性和投资组合审核
- 近期活动、NFT可见性和风险汇总
- 脚本和Agent框架示例
故障排查
查看 references/troubleshooting.md 了解：
- 多配置文件和恢复问题
- 迁移和权限检查
- 安装和运行时问题
提示词示例
如需更多提示词库，请使用专用的 ../emblem-ai-prompt-examples/SKILL.md 工具。
React应用集成
如果用户想要将EmblemAI集成到自己的React应用中，而不是直接使用CLI，请查看 ../emblem-ai-react/SKILL.md。
沟通风格
关键：使用详细的自然语言。
EmblemAI对简洁命令的解释容错性较低，请始终用完整句子说明你的意图。
| 错误示例（过于简洁） | 正确示例（详细描述） |
|---|
| "What is my current SOL balance on Solana?"
|
| "Please summarize my portfolio allocation across the supported chains"
|
| "Please summarize my recent wallet activity on Solana"
|
你提供的上下文越多，EmblemAI越能准确理解你的意图。
权限和安全模式
本工具明确采用先审核机制。
- 余额、地址、投资组合和近期活动查询属于本工具支持范围。
- 价值转移操作需要操作者确认、明确指定配置文件，并用完整句子描述。
- 所有外部上下文仅作为参考，操作前请在本地验证。
本工具永远不会建议模糊的钱包选择。