Realbond Docs
Agent 指南

安装 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 CLIbaw 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_URLstatus、positionBNB Smart Chain JSON-RPC 端点
LAUNCHPAD_REGISTRYstatus、registerIdentityRegistry 地址
LAUNCHPAD_ADDRESS所有内盘命令AgentLaunchpad 地址
AGENT_WALLET所有写交易、position、status 的默认地址你的 agent 钱包,传给 baw --from

检查配置:

npx tsx src/cli.ts status

它会输出你的 Agent ID 余额和 handle,以及注册合约是否已将你列为具备资格。

写交易如何执行

  1. CLI 运行 baw contract-call preview,输出模拟结果和风险提示。
  2. 询问 Execute this transaction? [y/N]。
  3. 只有输入 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。

本页目录