整合指南
Linkex Skills
官方 Skill——讓你的 Agent 自己查餘額、自己充值，從「餘額不足」到「入帳」只需 3 個回合。
linkex-skills 是 Linkex 的官方 Skill 倉庫，適用於支援 skills 生態的 Agent 執行環境（Claude Code、OpenClaw 等）。首個 Skill linkex-agents-pay 讓你的 Agent 學會：
- 查詢 API Key 的剩餘額度（
status.sh） - 建立 x402 充值訂單並預覽付款選項
- 將簽名交給 x402 錢包（Binance Agentic Wallet）並完成結算
- 可選：餘額不足時自動提醒（需明確同意的 hook）
相比自己接 x402 端點，Skill 內建的腳本把整個流程壓縮到 3 個 Agent 回合——準備、確認、執行。
前置條件
- 支援 skills 的 Agent 執行環境（如 Claude Code）與 Node.js ≥ 18
- 一把 Linkex API Key（
sk-...）——建議用 Agent Key - 簽名側：
binance-agentic-walletskill（流程驅動其bawCLI）；任何 x402 v2exact用戶端也可手動完成
安裝
npx skills add stablepay-llc/linkex-skills/skills/linkex-agents-pay配置
Skill 只讀一個必填變數：
| 變數 | 必填 | 說明 |
|---|---|---|
LINKEX_API_KEY | 是 | 你的 Linkex Key；用於模型呼叫與充值訂單 |
LINKEX_BASE_URL | 否 | 預設 https://linkex.ai |
LINKEX_LOW_BALANCE_USD | 否 | 低餘額提醒閾值，預設 5 |
Claude Code 建議寫入 ~/.claude/settings.json（或 .claude/settings.local.json）的 env 區塊，每個工作階段自動繼承：
{
"env": { "LINKEX_API_KEY": "sk-YOUR_KEY" }
}首次使用
直接和你的 Agent 對話：
「查一下我的 Linkex 餘額」→ Skill 執行
status.sh，回報額度與可用的充值網路/代幣。「在 BNB Chain 充 $5」→ 回合 1 建單並預覽可簽選項；回合 2 以表格展示（代幣、鏈、金額、錢包餘額）並徵求確認；回合 3 經
baw簽名，回報結算結果與新餘額。
Skill 在你明確確認前絕不簽名或消費，且自身不持有任何私鑰——簽名完全在錢包 Skill 中進行。
可選：自動低餘額守衛
Skill 附帶 balance-guard.sh hook：每個對話回合結束後檢查 Key（每 10 分鐘最多一次），餘額低於閾值時列印提醒。Agent 會主動詢問是否安裝——需明確同意、唯讀、絕不自行建單。
首次使用錢包的注意事項
如果用全新的 Binance Agentic Wallet 簽名，有兩個常見坑：
- 登入連結必須在桌面瀏覽器開啟，再用幣安 App 掃碼（在手機上直接開啟只會看到下載頁）。
- Agentic 錢包初始是空的——它是隔離的 MPC 錢包，與你的幣安主帳戶資金分開。建單前先在目標鏈充入代幣（訂單 10 分鐘過期）。
排錯
| 症狀 | 處理 |
|---|---|
| 每次工作階段都要求輸入 Key | 把 LINKEX_API_KEY 存入 Agent 設定的 env 區塊，而非 shell |
prepare 成功但選項不可簽 | 該鏈錢包餘額不足——先充值錢包再重跑 prepare（舊訂單可能已過期） |
execute 回傳 ORDER_EXPIRED | 訂單有效期 10 分鐘；重跑 prepare |
SPEND_CAP_EXCEEDED | Agent Key 的消費上限正常生效——如屬預期請調高 |