OpenClaw 钱包插件

面向AI代理的多链钱包和交易工具包，包含27个工具。

安装

使用任何工具前，必须先安装npm包：

bash
npm install @loomlay/openclaw-wallet-plugin

这将安装插件及其所有依赖项，无需额外安装其他包。

认证是自动的。 首次使用时，插件会自动注册获取API密钥，并保存到~/.loomlay/credentials.json。无需手动配置。

如需使用特定API密钥而非自动注册：
bash
export LOOMLAYAPIKEY=agentyourkey_here

首次设置

重要提示：安装插件后，在使用交易/钱包工具前，必须先设置钱包。

首次与用户交互时（或技能首次加载时），执行以下设置序列：

javascript
const { walletget, walletcreate } = require(@loomlay/openclaw-wallet-plugin);

// 1. 检查钱包是否已存在
const existing = await wallet_get();

if (!existing.success) {
// 2. 尚无钱包 — 创建一个
const created = await wallet_create();
if (created.success) {
// 3. 向用户展示新钱包
// 重要提示：助记词仅显示一次。告知用户妥善保存。
// 您的钱包已创建：
// Solana:
// EVM:
// 助记词：（请安全保存 — 将不再显示）
}
} else {
// 钱包已存在 — 显示地址
// 您的钱包：
// Solana:
// SOL余额：
}

在任何钱包或交易操作前，务必执行此检查。 如果wallet_get()返回UNAUTHORIZED错误，可能需要重新注册API密钥 — 删除~/.loomlay/credentials.json后重试。

如何使用工具

所有27个工具均作为扁平异步函数从插件包中导出。在Node.js中如下使用：

javascript
const { walletget, swapquote, swap, dextrending, tokensearch } = require(@loomlay/openclaw-wallet-plugin);

// 检查钱包余额
const wallet = await wallet_get();
// wallet.data.balances.solana.sol

// 获取热门代币
const trending = await dex_trending({ chain: solana, limit: 10 });
// trending.data.pairs[...]

每个工具返回标准化响应：
javascript
{
success: true, // 或 false
data: { ... }, // 结果数据（success为true时）
error: { // 错误信息（success为false时）
message: ...,
code: RATE_LIMITED,
retryAfter: 30 // 秒（限流时）
}
}

使用result.data前，务必检查result.success。

重要提示：执行前验证

对于涉及资金的操作：

1. 1. 先获取报价 — 向用户展示即将发生的操作
2. 获取用户确认 — 未经批准绝不执行
3. 执行 — 运行交易
4. 验证 — 检查结果和新余额

javascript
const { swap_quote, swap } = require(@loomlay/openclaw-wallet-plugin);

// 步骤1：报价
const quote = await swap_quote({ inputToken: SOL, outputToken: USDC, amount: $100 });
// 告知用户：您将用约1.2 SOL兑换约$99.50 USDC

// 步骤2：用户确认 → 步骤3：执行
const result = await swap({ inputToken: SOL, outputToken: USDC, amount: $100 });
if (result.success) {
// 显示txHash和新余额
}

安全规则

• - 切勿记录助记词 — walletcreate()仅返回一次，告知用户离线保存
• 未经用户确认绝不执行 — 始终先获取报价
• 切勿猜测代币地址 — 使用tokensearch()查找
• 切勿硬编码API密钥 — 使用环境变量

金额格式

交易工具支持灵活的金额格式：

全部27个工具参考

钱包（3个）

javascript
const { walletcreate, walletget, walletexportkeys } = require(@loomlay/openclaw-wallet-plugin);

// 创建新钱包（仅返回一次助记词）
await wallet_create()
// → { wallet: { solanaAddress, evmAddress }, seedPhrase, message }

// 获取钱包地址和余额
await wallet_get()
// → { wallet: { solanaAddress, evmAddress }, balances: { solana, evm } }

// 导出私钥（需要助记词）
await walletexportkeys({ seedPhrase: 12 word phrase here })
// → { solanaPrivateKey, evmPrivateKey }

交易（5个）

javascript
const { swap, swapquote, transfer, bridge, bridgequote } = require(@loomlay/openclaw-wallet-plugin);

// 兑换代币
await swap({ inputToken: SOL, outputToken: USDC, amount: $100, chain: solana, slippage: 1 })
// → { success, txHash, inputAmount, outputAmount }

// 获取兑换报价（不执行）
await swap_quote({ inputToken: SOL, outputToken: USDC, amount: $100 })
// → { inputAmount, outputAmount, minOutputAmount, priceImpact, route }

// 转账代币
await transfer({ token: SOL, amount: 1.5, to: recipient_address })
// → { success, txHash, amount, token, to }

// 跨链桥接
await bridge({ inputToken: SOL, amount: 1, sourceChain: solana, destinationChain: base })
// → { success, sourceTxHash, destinationTxHash, status }

// 桥接报价
await bridge_quote({ inputToken: SOL, amount: 1, sourceChain: solana, destinationChain: base })
// → { inputAmount, outputAmount, fee, estimatedTime }

代币（4个）

javascript
const { tokensearch, tokenprice, tokendetails, tokenchart } = require(@loomlay/openclaw-wallet-plugin);

// 按名称/符号搜索代币
await token_search({ query: BONK })
// → { tokens: [{ address, symbol, name, price, safetyScore }] }

// 获取代币价格
await token_price({ token: SOL, chain: solana })
// → { token, price, chain }

// 获取代币详细信息
await tokendetails({ address: tokenmint_address })
// → { token, market, safety }

// 获取OHLCV图表数据
await tokenchart({ address: tokenmint_address })
// → { data: [...] }

投资组合（2个）

javascript
const { portfolioget, portfoliohistory } = require(@loomlay/openclaw-wallet-plugin);

// 获取跨链综合投资组合
await portfolio_get()
// → { positions: [...], totalUsdValue: number }

// 获取交易历史
await portfolio_history({ chain: solana, limit: 50 })
// → { transactions: [...] }

DEX市场数据（7个）

javascript
const { dextrending, dexvolume, dexgainers, dexlosers, dexnew, dexpumpfun, dex_query } = require(@loomlay/openclaw-wallet-plugin);

// 热门交易对
await dex_trending({ chain: solana, minLiquidity: 10000, limit: 10 })
// → { pairs: [...], pagination }

// 高交易量交易对
await dex_volume({ chain: solana, minLiquidity: 10000, limit: 10 })

// 涨幅榜（24小时）
await dex_gainers({ chain: solana, minLiquidity: 10000, limit: 10 })

// 跌幅榜（24小时）
await dex_losers({ chain: solana, minLiquidity: 10000, limit: 10 })

// 新创建交易对（< 24小时）
await dex_new({ chain: solana, minLiquidity: 5000, limit: 10 })

// Pumpfun热门（仅Solana）
await dex_pumpfun({