什么是 Arkade？

Arkade 是一款功能强大的工具，旨在弥合各种比特币层级与稳定币生态系统之间的差距。作为 Openclaw Skills 的核心组件，它使用户能够使用 Ark 协议进行即时链下转账，以及传统的链上充值和提现来处理比特币交易。它提供了一个与闪电网络交互的无缝接口（通过潜艇互换），使其成为开发者构建基于智能体的金融应用时必不可少的实用工具。

除了比特币功能外，Arkade 还集成了 LendaSwap，在以太坊、Polygon 和 Arbitrum 等主流链上提供 BTC 与 USDC、USDT 等稳定币之间的即时流动性。该技能确保用户可以在不离开开发环境的情况下，以高速、低费用的方式管理其数字资产。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tiero/arkade-wallet

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Arkade 应用场景

• 使用 Arkade 链下地址发送和接收即时、低费用的比特币付款
• 通过充值地址和提现命令管理链上存款和取款
• 创建并支付闪电网络发票 (BOLT11) 以进行微额支付
• 在 Polygon、以太坊和 Arbitrum 上将比特币兑换为 USDC 或 USDT 等稳定币
• 为 AI 驱动的流程自动化金融工作流和支付触发器

1. 初始化本地钱包，生成安全私钥并连接到 Arkade 服务器。
2. 通过充值地址接收链上比特币，或通过原生 Ark 地址接收链下比特币。
3. 执行对其他 Ark 用户的即时转账，或将资金桥接到闪电网络以实现更广泛的支付兼容性。
4. 使用集成的兑换提供商，根据当前市场汇率获取稳定币转换的实时报价。
5. 通过统一的 CLI 或 SDK 验证链下、链上和待处理兑换状态的交易状态与余额。

Arkade 配置指南

要开始使用 Openclaw Skills 的这一扩展功能，您可以直接运行而无需完整安装：

npx -y -p @arkade-os/skill arkade init

对于日常使用，建议进行全局安装：

npm install -g @arkade-os/skill
# 初始化您的钱包
arkade init
# 查看您的地址
arkade address

Arkade 数据架构与分类体系

Arkade 通过将敏感数据保存在本地来优先考虑安全性。该技能按如下方式组织信息：

name: arkade
description: Send and receive Bitcoin over Arkade (offchain), onchain (via onboard/offboard), and Lightning. Swap USDC/USDT stablecoins.
read_when:
  - user wants to send or receive Bitcoin
  - user mentions Arkade, Ark, or offchain Bitcoin
  - user wants to use Lightning Network
  - user wants to swap BTC for stablecoins (USDC, USDT)
  - user wants to on-ramp or off-ramp Bitcoin
  - user wants to get paid onchain or pay someone onchain
  - user mentions boarding address or VTXOs
  - user wants instant Bitcoin payments
requires: []
metadata:
  emoji: "?"

Arkade Skill

Send and receive Bitcoin over Arkade (offchain), onchain (via onboard/offboard), and Lightning Network. Swap between BTC and stablecoins (USDC/USDT) via LendaSwap.

Payment methods:

• Offchain (Arkade): Instant transactions between Arkade wallets
• Onchain: Get paid onchain via boarding address (onboard), pay onchain via offboard
• Lightning: Pay and receive via Boltz submarine swaps

Default Server: https://arkade.computer

Installation

Quick Start (no install required)

# Using pnpm (recommended)
pnpm dlx @arkade-os/skill init
pnpm dlx @arkade-os/skill address

# Using npx
npx -y -p @arkade-os/skill arkade init
npx -y -p @arkade-os/skill arkade address

Global Install

# Install globally
npm install -g @arkade-os/skill
# or
pnpm add -g @arkade-os/skill

# Then use directly
arkade init
arkade address

As a dependency

npm install @arkade-os/skill
# or
pnpm add @arkade-os/skill

CLI Commands

Note: Examples below use arkade directly (assumes global install). For pnpm: pnpm dlx @arkade-os/skill For npx: npx -y -p @arkade-os/skill arkade

Wallet Management

# Initialize wallet (auto-generates private key, default server: arkade.computer)
arkade init

# Initialize with custom server
arkade init https://custom-server.com

# Show Ark address (for receiving offchain Bitcoin)
arkade address

# Show boarding address (for onchain deposits)
arkade boarding-address

# Show balance breakdown
arkade balance

Bitcoin Transactions

# Send sats to an Ark address
arkade send  

# Example: Send 50,000 sats
arkade send ark1qxyz... 50000

# View transaction history
arkade history

Onchain Payments (Onboard/Offboard)

# Get paid onchain: Receive BTC to your boarding address, then onboard to Arkade
# Step 1: Get your boarding address
arkade boarding-address

# Step 2: Have someone send BTC to your boarding address

# Step 3: Onboard the received BTC to make it available offchain
arkade onboard

# Pay onchain: Send offchain BTC to any onchain Bitcoin address
arkade offboard 

# Example: Pay someone at bc1 address
arkade offboard bc1qxyz...

Lightning Network

# Create a Lightning invoice to receive payment
arkade ln-invoice  [description]

# Example: Create invoice for 25,000 sats
arkade ln-invoice 25000 "Coffee payment"

# Pay a Lightning invoice
arkade ln-pay 

# Show swap fees
arkade ln-fees

# Show swap limits
arkade ln-limits

# Show pending swaps
arkade ln-pending

Stablecoin Swaps (LendaSwap)

# Get quote for BTC to stablecoin swap
arkade swap-quote   

# Example: Quote 100,000 sats to USDC on Polygon
arkade swap-quote 100000 btc_arkade usdc_pol

# Show available trading pairs
arkade swap-pairs

Supported Tokens:

• btc_arkade - Bitcoin on Arkade
• usdc_pol - USDC on Polygon
• usdc_eth - USDC on Ethereum
• usdc_arb - USDC on Arbitrum
• usdt_pol - USDT on Polygon
• usdt_eth - USDT on Ethereum
• usdt_arb - USDT on Arbitrum

SDK Usage

import { Wallet, SingleKey } from "@arkade-os/sdk";
import {
  ArkadeBitcoinSkill,
  ArkaLightningSkill,
  LendaSwapSkill,
} from "@arkade-os/skill";

// Create wallet (default server: arkade.computer)
const wallet = await Wallet.create({
  identity: SingleKey.fromHex(privateKeyHex),
  arkServerUrl: "https://arkade.computer",
});

// === Bitcoin Operations ===
const bitcoin = new ArkadeBitcoinSkill(wallet);

// Get addresses
const arkAddress = await bitcoin.getArkAddress();
const boardingAddress = await bitcoin.getBoardingAddress();

// Check balance
const balance = await bitcoin.getBalance();
console.log("Total:", balance.total, "sats");
console.log("Offchain available:", balance.offchain.available, "sats");
console.log("Onchain pending:", balance.onchain.total, "sats");

// Send Bitcoin
const result = await bitcoin.send({
  address: recipientArkAddress,
  amount: 50000,
});
console.log("Sent! TX:", result.txid);

// === Lightning Operations ===
const lightning = new ArkaLightningSkill({
  wallet,
  network: "bitcoin",
});

// Create invoice
const invoice = await lightning.createInvoice({
  amount: 25000,
  description: "Coffee payment",
});
console.log("Invoice:", invoice.bolt11);

// Pay invoice
const payment = await lightning.payInvoice({
  bolt11: "lnbc...",
});
console.log("Paid! Preimage:", payment.preimage);

// === Stablecoin Swaps ===
const lendaswap = new LendaSwapSkill({ wallet });

// Get quote
const quote = await lendaswap.getQuoteBtcToStablecoin(100000, "usdc_pol");
console.log("You'll receive:", quote.targetAmount, "USDC");

// Execute swap
const swap = await lendaswap.swapBtcToStablecoin({
  targetAddress: "0x...", // EVM address
  targetToken: "usdc_pol",
  targetChain: "polygon",
  sourceAmount: 100000,
});
console.log("Swap ID:", swap.swapId);

Configuration

Data Storage: ~/.arkade-wallet/config.json

Private keys are auto-generated on first use and stored locally. They are never exposed via CLI arguments or stdout. No environment variables required. The LendaSwap API is publicly accessible.

Skill Interfaces

ArkadeBitcoinSkill

• getArkAddress() - Get Ark address for receiving offchain payments
• getBoardingAddress() - Get boarding address for receiving onchain payments
• getBalance() - Get balance breakdown
• send(params) - Send Bitcoin to Ark address (offchain)
• getTransactionHistory() - Get transaction history
• onboard(params) - Get paid onchain: convert onchain BTC to offchain
• offboard(params) - Pay onchain: send offchain BTC to any onchain address
• waitForIncomingFunds(timeout?) - Wait for incoming funds

ArkaLightningSkill

• createInvoice(params) - Create Lightning invoice
• payInvoice(params) - Pay Lightning invoice
• getFees() - Get swap fees
• getLimits() - Get swap limits
• getPendingSwaps() - Get pending swaps
• getSwapHistory() - Get swap history
• isAvailable() - Check if Lightning is available

LendaSwapSkill

• getQuoteBtcToStablecoin(amount, token) - Quote BTC to stablecoin
• getQuoteStablecoinToBtc(amount, token) - Quote stablecoin to BTC
• swapBtcToStablecoin(params) - Swap BTC to stablecoin
• swapStablecoinToBtc(params) - Swap stablecoin to BTC
• getSwapStatus(swapId) - Get swap status
• getPendingSwaps() - Get pending swaps
• getSwapHistory() - Get swap history
• getAvailablePairs() - Get available trading pairs
• claimSwap(swapId) - Claim completed swap
• refundSwap(swapId) - Refund expired swap

Networks

Arkade supports multiple networks:

• bitcoin - Bitcoin mainnet
• testnet - Bitcoin testnet
• signet - Bitcoin signet
• regtest - Local regtest
• mutinynet - Mutiny signet

Support

• GitHub: https://github.com/arkade-os/skill
• Documentation: https://docs.arkadeos.com