安装 skill
安装 Realbond agent skill,登录 baw CLI,并设置 agent 所需的环境变量。
Realbond skill 是一个小型 TypeScript CLI:它为 Realbond 合约编码 calldata,并通过 baw contract-call 用你的币安 Agentic Wallet(Binance Agentic Wallet)发送。每一笔写交易执行前都需要人工输入 y 确认。
前提条件
| 要求 | 检查方式 |
|---|---|
| Node.js 22 或更新版本 | node --version |
| 已在币安 App 中开启开发者模式(Developer Mode)的币安 Agentic Wallet | — |
已登录的 baw CLI | baw wallet status 显示 Logged in 和你的 agent 地址 |
| 该钱包上持有 Agent ID | 在 realbond.fun/verify 上可见 |
用 baw auth signin 登录(在币安 App 中扫描二维码)。如果之后某条命令因 SESSION_EXPIRED 或 NOT_LOGGED_IN 失败,请重新登录。
安装
方式 A(推荐):把 skill 添加到你的 agent
npx skills add realbond-ai/realbond-skill这会让你的 agent 获得该 skill 的 SKILL.md 指令,但不会安装 npm 依赖。若要自己运行 CLI,先 cd 进入 skills CLI 输出的目录并安装依赖:
cd <directory printed by skills add>
npm install
npx tsx src/cli.ts <command> [args] [--dry-run]方式 B:从源码克隆
git clone https://github.com/realbond-ai/realbond-skill
cd realbond-skill
npm install
npx tsx src/cli.ts <command> [args] [--dry-run]无论哪种方式,本文档中的所有示例都使用 npx tsx src/cli.ts <command>,在完成 npm install 后于 skill 目录中运行。
环境变量
CLI 读取普通的环境变量;请在运行它的 shell 中 export。
export RPC_URL=https://bsc-dataseed.binance.org
export LAUNCHPAD_REGISTRY=0x7f1093e042881ED6f2cd2935ab4BcE24D1Ea6857
export LAUNCHPAD_ADDRESS=0xDb6709D84573c507113CD605F934E6F19678643E
export AGENT_WALLET=0xYourAgentWallet| 变量 | 使用方 | 含义 |
|---|---|---|
RPC_URL | status、position | BNB Smart Chain JSON-RPC 端点 |
LAUNCHPAD_REGISTRY | status、register | IdentityRegistry 地址 |
LAUNCHPAD_ADDRESS | 所有内盘命令 | AgentLaunchpad 地址 |
AGENT_WALLET | 所有写交易、position、status 的默认地址 | 你的 agent 钱包,传给 baw --from |
检查配置:
npx tsx src/cli.ts status它会输出你的 Agent ID 余额和 handle,以及注册合约是否已将你列为具备资格。
写交易如何执行
- CLI 运行
baw contract-call preview,输出模拟结果和风险提示。 - 询问
Execute this transaction? [y/N]。 - 只有输入
y才会运行baw contract-call execute,并输出{txHash, status}。
如果状态为 PENDING_CONFIRMATION 且没有 txHash,请在币安 App 中批准该交易。在任意命令后加 --dry-run,即可只输出 {to, data, value} 而不调用 baw。
Agent 不得自行确认
y 提示是人工检查点。Agent 绝不应代替用户回答它。
网络排障
baw 直接连接 https://www.binance.com,并忽略 HTTPS_PROXY。如果 baw wallet status 报错 Connection refused (0.0.0.0:443),说明你的 DNS 解析器返回了错误结果:
dig +short www.binance.com # must be a public IP, not 0.0.0.0把系统 DNS 指向可信的解析器(例如 8.8.8.8)后重新登录。TUN 模式代理无济于事,除非它同时接管 DNS。