Agent 身份与支付
AI Agent 按需运行，使用模式不可预测。传统 SaaS 订阅、预充值额度和 API 密钥都不适合。BitRouter 提供 Agent 原生基础设施——你的钱包就是你的身份，Agent 在你定义的边界内运行，每个令牌可加密验证。
钱包即身份
BitRouter 使用 OWS（Open Wallet Standard） 钱包作为操作者身份。无需注册、无需供应商审批——拥有钱包即拥有账户。访问完全无需许可。
一个 BIP-39 助记词可以同时派生 EVM、Solana 和 Bitcoin 链上的地址，为你提供跨网络的统一身份。私钥在本地以 AES-256-GCM 加密存储，绝不离开你的设备。
# 创建新钱包
bitrouter wallet create --name "my-wallet"
# 显示助记词以备份
bitrouter wallet create --name "my-wallet" --words 24 --show-mnemonic这会在本地 OWS 保险库中创建一个钱包，并显示你派生的链地址。密钥由你掌控——BitRouter 绝不持有。
多链身份： 你的钱包从一个助记词派生 EVM、Solana 和 Bitcoin 地址。你可以使用 Solana 或 EVM 签名方案进行认证。链上支付目前在 Solana 上启用，EVM 支付支持即将推出。
钱包管理
# 列出所有钱包
bitrouter wallet list
# 显示详细信息（地址、派生路径）
bitrouter wallet info --wallet "my-wallet"
# 从已有助记词导入
bitrouter wallet import --name "imported" --mnemonic
# 从私钥导入（例如旧密钥迁移）
bitrouter wallet import --name "from-evm" --private-key --chain evm
# 导出助记词（需要密码）
bitrouter wallet export --wallet "my-wallet"
# 重命名或删除
bitrouter wallet rename --wallet "my-wallet" --new-name "treasury"
bitrouter wallet delete --wallet "my-wallet"Agent 访问密钥
要让 Agent 访问你的 BitRouter 实例，创建一个绑定到特定钱包的 OWS API 密钥。密钥可选绑定策略以实现细粒度访问控制。
# 为 Agent 创建 API 密钥
bitrouter key create \
--name "claude-agent" \
--wallet "my-wallet"
# 绑定多个钱包并设置过期时间
bitrouter key create \
--name "tmp-key" \
--wallet "my-wallet" \
--wallet "other-wallet" \
--expires-at "2026-12-31T00:00:00Z"
# 附加策略以实现细粒度控制
bitrouter key create \
--name "restricted-agent" \
--wallet "my-wallet" \
--policy "policy-id"令牌仅在创建时显示一次——OWS 只存储 SHA-256 哈希，原始令牌无法恢复。请立即复制并配置给你的 Agent。
# 列出所有 API 密钥（令牌永不显示）
bitrouter key list
# 撤销 API 密钥
bitrouter key revoke --id "key-id"JWT 签名
为了更细粒度的 Agent 授权，操作者可以铸造 JWT 令牌，Agent 将其作为 Bearer 认证发送到运行中的 BitRouter 服务器。JWT 由你的 OWS 钱包签名，可以编码模型限制、预算和过期时间。
# 签发 JWT，授权访问所有模型，有效期 30 天
bitrouter key sign --wallet "my-wallet" --exp 30d
# 限制到特定模型并设置预算
bitrouter key sign \
--wallet "my-wallet" \
--models "gpt-4o,claude-sonnet-4" \
--budget 5000000 \
--budget-scope session \
--exp 7d
# 绑定 OWS Agent 密钥以执行支付策略
bitrouter key sign \
--wallet "my-wallet" \
--ows-key "agent-key-id" \
--exp 12h--exp 标志接受人类可读的持续时间格式（30s、12h、7d）或原始秒数，会被转换为 JWT 中的绝对 UNIX 时间戳。
JWT 声明
| 声明 | 必填 | 描述 |
|---|---|---|
iss | 是 | CAIP-10 操作者身份（例如 solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:<pubkey>） |
iat | 自动 | 签发时间 UNIX 时间戳（由 CLI 自动设置） |
exp | 否 | 过期 UNIX 时间戳。建议短期令牌设置此字段 |
mdl | 否 | 模型白名单——未设置时可访问所有已配置模型 |
bgt | 否 | 预算限制，单位为微美元（1 USD = 1,000,000 μUSD） |
bsc | 否 | 预算范围：session（每会话）或 account（每账户） |
key | 否 | OWS Agent 密钥 ID，用于支付策略执行 |
服务器验证 JWT 的 iss 与配置的操作者钱包匹配。Agent 无法伪造或修改令牌——加密签名确保防篡改授权。
支持的签名算法
| 算法 | 链 | 身份格式 |
|---|---|---|
SOL_EDDSA | Solana | solana:<chain-ref>:<base58-pubkey> |
EIP191K | EVM（Base、Ethereum 等） | eip155:<chain-id>:<hex-address> |
算法根据 --chain 标志自动选择（默认：solana）。
预算控制
| 字段 | 描述 |
|---|---|
--budget | 微美元限额（1,000,000 = $1.00） |
--budget-scope | session（每个聊天会话）或 account（所有会话） |
--budget-range | rounds:<N>（接下来 N 轮对话）或 duration:<seconds>s（时间窗口） |
模型允许列表
--models 标志接受逗号分隔的通配符模式：
--models "openai:gpt-4o,anthropic:*"省略时，令牌可以访问服务器上配置的所有模型。
如需高级配置，如策略和细粒度支出规则，请参阅 OWS 文档。
支付
BitRouter 原生支持稳定币支付用于 Agent 操作：
- USDC（Solana）
- USDC（Tempo）
Agent 和开发者使用熟悉的美元金额。稳定币实现即时、低成本、无需许可的结算——没有传统支付处理器的摩擦。
机器支付协议（MPP）
BitRouter 使用 MPP 实现基于 HTTP 402 的支付，支持将 LLM 推理、MCP 工具和 ACP 代理的访问货币化。MPP 的 charge intent 兼容 x402-exact 规范。
支持两个支付网络：Tempo（EVM）和 Solana。
工作原理
- 调用者发起不带支付凭证的请求
- BitRouter 返回
402 Payment Required，附带描述可接受支付方式和成本的质询 - 调用者提交支付证明（签名交易、凭证或通道状态）
- BitRouter 验证支付并将请求代理到上游
- 成本通过可观测性层计量和记录
对于 LLM 推理，token 级别的成本在请求完成后计算。对于 MCP 工具和 ACP 代理，固定的每次调用成本预先收取。
MPP 配置
mpp:
enabled: true
realm: "bitrouter.example.com" # 如省略则自动检测
secret_key: "${MPP_SECRET_KEY}" # 用于无状态质询验证的 HMAC
networks:
tempo:
recipient: "0xYourAddress"
escrow_contract: "0xEscrowAddr"
rpc_url: "https://rpc.tempo.xyz"
currency: "0xTokenAddress" # TIP-20 代币
fee_payer: true # 赞助 gas 费用
solana: # 需要 mpp-solana 功能
recipient: "SolanaBase58Pubkey"
channel_program: "ProgramAddr"
network: "mainnet-beta" # 或 "devnet"
solana_rpc_url: "https://api.mainnet-beta.solana.com"计价配置
可以为 MCP 工具和 ACP 代理设置计价。LLM 成本使用提供商的 token 价格目录自动计算。
mcp_server_pricing:
github:
default_cost_per_call: 0.001
tools:
search_repositories: 0.005
acp_agent_pricing:
research-agent:
default_cost_per_call: 0.01
methods:
"message/send": 0.05
"tasks/get": 0.01法币支持即将推出。 Stripe 法币出入金集成正在开发中，届时团队可以直接使用传统货币为 Agent 钱包充值。
How is this guide?
Last updated on