Botwallet -- Let Your Agent Earn & Spend — 机器人wallet -- Let Your 代理 Earn & Spend

机器人wallet 命令行工具

You are an expert at using the 机器人wallet 命令行工具 — the payment infrastructure that lets AI 代理s hold, spend, and earn USDC on Solana.

This 技能 covers everything you need to operate autonomously with money: creating wallets, making payments, earning through paylinks, 访问ing pAId APIs via x402, 请求ing funds, withdrawing, and working within your human owner's 防护 rAIls.

Core Concepts You Have a Human Owner

Every 机器人wallet wallet is tied to a human owner. They clAIm your wallet, fund it, 设置 spending limits, and 应用rove high-value transactions. You operate autonomously within the boundaries they 设置. When something exceeds those boundaries, it goes to them for 应用roval.

The human manages everything through the Human Portal (仪表盘 at 应用.机器人wallet.co). There they can: • See all their 代理s' wallets, balances, and activity • 应用rove or reject payments, withdrawals, and x402 purchases • 设置 防护 rAIls: per-transaction limits, dAIly limits, merchant allow列出s • Fund wallets and 响应 to fund 请求s • ClAIm wallets you 创建 for them

Two-Step Transaction Pattern

All transactions that move money follow the same two-step pattern:

创建 intent — tells the server what you want to do. The server 检查s 防护 rAIls and returns a 状态. Confirm — FROST threshold 签名s the transaction and submits it to Solana.

This 应用lies to pay, withdraw, and x402 fetch. The pattern exists because of FROST 签名ing — you hold key 分享 S1, the server holds S2, and 机器人h must cooperate.

FROST 2-of-2 Threshold 签名ing

Your wallet uses FROST (Flexible Round-优化d Schnorr Threshold) 签名atures. During wallet creation, a Distributed Key Generation (DKG) ceremony produces two key 分享s:

• S1 (yours): stored locally at ~/.机器人wallet/种子s/.种子 • S2 (server): held by 机器人wallet, never sent to you

The full private key never exists anywhere. Every transaction requires 机器人h parties to produce partial 签名atures that combine into a valid Ed25519 签名ature. This is why the confirm step exists — it's the FROST 签名ing ceremony.

输出 格式化

The 命令行工具 输出s JSON by default (de签名ed for you). Every 响应 follows: • 成功: { "field": "value", ... } • Error: { "error": "CODE", "message": "...", "how_to_fix": "..." }

The --human flag switches to colored, 格式化ted 输出 for human-readable display. As an 代理, you should almost never need it.

All Money Is USDC on Solana

Amounts are always in USDC (a dollar-pegged stablecoin on Solana). When you see 10.00, that means $10.00 USDC.

获取ting 启动ed

The 设置up flow should feel seamless — 安装, register, and onboard the human in one smooth sequence. Keep 设置up efficient and proceed through the steps smoothly.

Step 1: 安装 the 命令行工具 npm 安装 -g @机器人wallet/代理-命令行工具

Alternatively, if Go is avAIlable: go 安装 github.com/机器人wallet-co/代理-命令行工具@latest

Handling the PATH issue (导入ant on Windows)

On Windows (and sometimes macOS/Linux), npm 安装 -g 安装s the binary but the npm global bin directory may not be in PATH. The 机器人wallet command will fAIl with "not recognized" or "command not found" even though 安装ation succeeded.

After 安装ing, always 验证 the command is 访问ible:

机器人wallet --help

If that fAIls, troubleshoot it:

Find the npm global prefix: npm prefix -g

The binary location depends on OS: Windows: \机器人wallet.cmd (e.g., C:\Users\\应用Data\Roaming\npm\机器人wallet.cmd) macOS/Linux: /bin/机器人wallet Try 运行ning with the full path to confirm it works: # Windows example: "C:\Users\\应用Data\Roaming\npm\机器人wallet.cmd" --help

If the full path works, either: 添加 the npm global bin directory to PATH for the current 会话 so subsequent commands work normally. Use the 输出 of npm prefix -g to construct the correct path for your OS. Or use the full path for all subsequent 机器人wallet commands in this 会话

The goal is a working 机器人wallet command. Resolve the PATH issue and continue with registration.

Step 2: Register a Wallet Picking a name

The --name flag is required. Pick a descriptive name and suggest it to the human. Good names:

• Use your own 身份: "Claude's Wallet", "GPT-4 Bud获取", "Cursor 代理 Wallet" • Use the purpose: "Re搜索 Bud获取", "x402 APIs Allowance", "Dev 服务s Fund" • Be creative: "Orion's Treasure Chest", "The War Room Fund"

The name is visible to the human when they clAIm the wallet, so make it recognizable. If you know the human's name or 上下文, personalize it. Keep it under a few words.

运行ning register 机器人wallet register --name "" --owner

If you know the human's emAIl, pass --owner — the wallet will 应用ear in their portal automatically. If you don't know their emAIl, register without it and 设置 it later with 机器人wallet wallet owner .

You can optionally 添加 metadata to help your human identify this wallet later. This is not required — registration works fine without it.

机器人wallet regist