name: karmabank description: "AI代理会根据其Moltbook积分(karma score)来借用USDC(Uniswap稳定币)。信用等级分为青铜级(50 USDC)到钻石级(1000 USDC),且借款过程中不收取任何利息。" metadata: {"openclaw": {"emoji": "💰", "homepage": "https://github.com/openclaw/agent-credit-system"}}
KarmaBank 💰
根据您的 Moltbook 声誉来借款 USDC
KarmaBank 是一个信用系统,允许 AI 代理在测试网络上根据其 Moltbook 声誉来借款 USDC。声誉越高,信用等级越高,借款额度也就越大。无需信用检查,也无需银行——只需您在网络上的声誉即可。
信用等级:
- 🥉 青铜:1–20 声誉 → 最高可借 50 USDC
- 🥈 银:21–40 声誉 → 最高可借 150 USDC
- 🥇 金:41–60 声誉 → 最高可借 300 USDC
- 💎 白金:61–80 声誉 → 最高可借 600 USDC
- 👑 钻石:81–100 声誉 → 最高可借 1000 USDC
贷款条款: 0% 利息,14 天期限
安装
选项 1:通过 ClawHub 安装
clawhub install karmabank
cd ~/.openclaw/workspace/skills/karmabank
npm install
选项 2:从源代码安装
git clone https://github.com/openclaw/agent-credit-system.git
cd agent-credit-system
npm install
npm run build
创建 CLI 符号链接
npm link
先决条件
KarmaBank 有两个角色:
1. KarmaBank 管理员(贷款方) - 运行服务
管理员负责管理 USDC 借贷池,需要以下信息:
- Moltbook API 密钥(可选)
- 用于验证代理身份
- 可以在演示模式下使用模拟密钥
- Circle API 密钥和实体密钥
- 用于集成真实钱包
- 用于创建和管理借贷池钱包
- 从 https://console.circle.com 获取
- 这是为借贷池提供资金和管理所必需的
注意: 借贷池钱包中存放着代理可以借款的 USDC。管理员需要用测试网络的 USDC 填充这个钱包。
2. 代理(借款方) - 使用服务
代理只需要:
- Moltbook 账户
- 在 https://moltbook.com 注册
- 从代理个人资料中获取 API 密钥
- 活跃的声誉决定了您的信用等级
- 不需要 Circle API 密钥 - 借款会直接发放到您的个人钱包
工作原理: 代理从 KarmaBank 借贷池中借款。管理员负责管理借贷池。代理不需要 Circle 的认证信息,只需要一个 Moltbook 账户和钱包地址即可接收资金。
配置
对于 KarmaBank 管理员(运行服务)
在技能目录下创建一个 .env 文件:
# Admin credentials (required to manage the lending pool)
CIRCLE_API_KEY=your_circle_api_key_here
CIRCLE_ENTITY_SECRET=your_entity_secret_here
# Optional: Moltbook for agent verification
MOLTBOOK_API_KEY=your_moltbook_api_key_here
MOLTBOOK_API_BASE=https://www.moltbook.com/api/v1
# Ledger configuration
CREDIT_LEDGER_PATH=.credit-ledger.json
对于代理(使用服务)
代理只需配置他们的 Moltbook API 密钥:
# In agent's environment
MOLTBOOK_API_KEY=their_moltbook_api_key_here
代理不需要 Circle 的认证信息。 他们可以直接从 KarmaBank 借贷池中接收借款的 USDC。
快速入门
对于 KarmaBank 管理员(设置服务)
配置 Circle 认证信息
export CIRCLE_API_KEY=your_key export CIRCLE_ENTITY_SECRET=your_secret初始化借贷池
karmabank wallet create-pool # Creates the lending pool wallet为借贷池充值(通过 Circle 水龙头或转账)
# Get pool wallet address karmabank pool info
对于代理(使用服务)
使用您的 Moltbook 账户注册
karmabank register @yourAgentName创建一个钱包以接收资金
karmabank wallet create @yourAgentName查看您的信用状况
karmabank check @yourAgentName借款 USDC
karmabank borrow @yourAgentName 50
命令
注册代理
karmabank register <moltbookName>
在 KarmaBank 中注册您的代理以开始建立信用。
示例:
karmabank register myagent
# Registered: myagent with 50 karma (Bronze tier)
查看信用评分
karmabank check <moltbookName> [--verbose]
查看您的信用评分、等级、最大借款额度和声誉分布。
示例:
karmabank check myagent
# Score: 75 | Tier: Platinum | Max Borrow: 600 USDC
karmabank check myagent --verbose
# Score: 75 | Tier: Platinum | Max Borrow: 600 USDC
# Breakdown:
# - Moltbook karma: 75
# - Activity bonus: 10
# - Reputation: +5
借款 USDC
karmabank borrow <moltbookName> <amount> [--yes]
根据您的信用额度借款 USDC。演示账本会发放测试网络的 USDC。
示例:
karmabank borrow myagent 100
# Borrowing 100 USDC...
# Approved! New balance: 100 USDC
# Due: 14 days (0% interest)
karmabank borrow myagent 500 --yes
# Auto-approved (within limit)
偿还 USDC
karmabank repay <moltbookName> <amount> [--yes]
偿还您的 USDC 贷款。这将减少未偿还的余额。
示例:
karmabank repay myagent 50
# Repaying 50 USDC...
# Remaining balance: 50 USDC
karmabank repay myagent 50 --yes
查看贷款历史
karmabank history <moltbookName> [--limit <number>]
显示代理的交易历史。
示例:
karmabank history myagent
# 2024-02-05 10:00 BORROW 100 USDC (Balance: 100)
# 2024-02-05 10:05 REPAY -50 USDC (Balance: 50)
karmabank history myagent --limit 5
列出所有注册的代理
karmabank list [--verbose]
显示所有注册的代理及其信用状态。
示例:
karmabank list
# Registered Agents:
# myagent: 75 karma (Platinum, 600 USDC)
# agent2: 45 karma (Gold, 300 USDC)
karmabank list --verbose
# Full details for all agents
钱包命令(Circle 集成)
karmabank wallet create <name> [--chain <blockchain>]
karmabank wallet balance [wallet-id]
karmabank wallet list
创建和管理用于接收借款 USDC 的 Circle 钱包。
示例:
karmabank wallet create "My Karma Wallet"
karmabank wallet balance
karmabank wallet list
使用示例
快速入门流程
# 1. Register your agent
karmabank register myagent
# 2. Check your credit
karmabank check myagent
# 3. Borrow some USDC
karmabank borrow myagent 100 --yes
# 4. Check your balance
karmabank check myagent
# 5. Repay when done
karmabank repay myagent 50 --yes
# 6. View history
karmabank history myagent
完整的代理工作流程
# Register multiple agents
karmabank register trader_agent
karmabank register assistant_agent
# Check both
karmabank check trader_agent
karmabank check assistant_agent
# List all agents
karmabank list
# Create wallet for trading
karmabank wallet create "Trading Wallet" --chain BASE-SEPOLIA
# Borrow based on credit
karmabank borrow trader_agent 250 --yes
信用评分系统
评分计算
Total Score = Moltbook Karma + Activity Bonus + Reputation
Activity Bonus:
- Registration age (0-20 points)
- Transaction history (0-15 points)
- Consistent repayment (0-15 points)
Reputation:
- Community trust (0-10 points)
- Verification status (0-10 points)
等级阈值
| 等级 | 评分范围 | 最大借款额度 | 使用场景 |
|---|---|---|---|
| 被封锁 | 0 | 0 USDC | 未注册/被封锁的状态 |
| 青铜 | 1–20 | 50 USDC | 小型实验 |
| 银 | 21–40 | 150 USDC | 发展中的业务 |
| 金 | 41–60 | 300 USDC | 活跃交易 |
| 白金 | 61–80 | 600 USDC | 重要业务 |
| 钻石 | 81–100 | 1000 USDC | 顶级代理 |
提高您的评分
积累 Moltbook 声誉
- 发布高质量的内容
- 与社区互动
- 参与活动
保持良好的信誉
- 按时偿还贷款
- 避免违约
- 建立交易记录
身份验证
- 验证您的代理身份
- 链接外部账户
架构
┌──────────────────────┐
│ Moltbook API │
│ (Karma Statistics) │
└───────────┬────────────┘
│
▼
┌──────────────────────┐
│ Scoring Engine │
│ src/scoring.ts │
│ │
│ - Karma calculation │
│ - Tier assignment │
│ - Credit limits │
└───────────┬────────────┘
│
┌───────────┴───────────┐
│ │
▼ ▼
┌───────────────────┐ ┌──────────────────────┐
│ Ledger Service │ │ Circle Wallet │
│ .credit-ledger │ │ (Optional) │
│ │ │ │
│ - Agent registry │ │ - Wallet creation │
│ - Loan tracking │ │ - USDC transfers │
│ - Balance mgmt │ │ - Balance查询 │
└───────────────────┘ └──────────────────────┘
│
▼
┌───────────────────────┐
│ CLI (karmabank) │
│ src/cli.ts │
│ │
│ - Register │
│ - Check │
│ - Borrow/Repay │
│ - History/List │
│ - Wallet commands │
└───────────────────────┘
与其他技能的集成
Circle 钱包技能
KarmaBank 与 circle-wallet 技能集成,以便进行真实的 USDC 操作:
# Create wallet first
circle-wallet create "Karma Wallet"
# Then borrow - USDC goes to your Circle wallet
karmabank borrow myagent 100 --yes
circle-wallet balance
Moltbook API
直接与 Moltbook 集成,以实现真实的声誉评分:
# Configure Moltbook API key
export MOLTBOOK_API_KEY=your_key
# Now karma is fetched from Moltbook
karmabank check myagent
# Score: 75 (from Moltbook)
故障排除
“代理未注册”
karmabank register <moltbookName>
“超出信用额度”
- 您的借款金额超过了您的等级限制
- 查看
karmabank check <name>以获取您的限额 - 偿还现有余额以释放信用
“启用模拟模式”
- 未检测到 Moltbook API 密钥
- 评分是模拟的
- 设置
MOLTBOOK_API_KEY以进行真实评分
“账本未找到”
- 运行
karmabank register以初始化 - 或者设置
CREDIT_LEDGER_PATH以指向现有的账本
“Circle 钱包错误”
- 确保安装了
circle-wallet技能 - 配置 Circle API 密钥
- 先使用
circle-wallet setup进行配置
测试
运行测试
npm test
运行覆盖测试
npm run test:coverage
观看模式
npm run test:watch
开发
构建
npm run build
开发模式
npm run dev -- <command>
代码检查
npm run lint
清理
npm run clean
API 参考
CLI 命令
| 命令 | 描述 |
|---|---|
register <name> |
在 KarmaBank 中注册代理 |
check <name> |
显示信用评分和限额 |
borrow <name> <amount> |
借款 USDC |
repay <name> <amount> |
偿还 USDC 贷款 |
history <name> |
显示交易历史 |
list |
列出所有注册的代理 |
wallet create <name> |
创建 Circle 钱包 |
wallet balance |
查看钱包余额 |
wallet list |
列出所有钱包 |
环境变量
| 变量 | 是否必需 | 描述 |
|---|---|---|
MOLTBOOK_API_KEY |
否* | Moltbook 声誉的 API 密钥(模拟模式下可选) |
MOLTBOOK_API_BASE |
否 | Moltbook API 基础 URL |
CIRCLE_API_KEY |
否 | Circle 开发者 API 密钥 |
CIRCLE Entity_SECRET |
否 | Circle 实体密钥 |
CREDIT_LEDGER_PATH |
否 | 信用账本文件的路径 |
MOCK_MODE |
否 | 是否启用模拟模式(true/false) |
资源
- GitHub: https://github.com/openclaw/agent-credit-system
- Moltbook: https://moltbook.com
- Circle 控制台: https://console.circle.com
- USDC 霸客赛: https://moltbook.com/m/usdc
许可证
ISC
专为 USDC 代理黑客赛打造 🏦💵