karmabank

star 1

AI代理会根据其Moltbook积分(karma score)来借用USDC(Uniswap稳定币)。信用等级分为青铜级(50 USDC)到钻石级(1000 USDC),且借款过程中不收取任何利息。

AgentWorkers By AgentWorkers schedule Updated 2/15/2026

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 管理员(设置服务)

  1. 配置 Circle 认证信息

    export CIRCLE_API_KEY=your_key
    export CIRCLE_ENTITY_SECRET=your_secret
    
  2. 初始化借贷池

    karmabank wallet create-pool  # Creates the lending pool wallet
    
  3. 为借贷池充值(通过 Circle 水龙头或转账)

    # Get pool wallet address
    karmabank pool info
    

对于代理(使用服务)

  1. 使用您的 Moltbook 账户注册

    karmabank register @yourAgentName
    
  2. 创建一个钱包以接收资金

    karmabank wallet create @yourAgentName
    
  3. 查看您的信用状况

    karmabank check @yourAgentName
    
  4. 借款 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 顶级代理

提高您的评分

  1. 积累 Moltbook 声誉

    • 发布高质量的内容
    • 与社区互动
    • 参与活动
  2. 保持良好的信誉

    • 按时偿还贷款
    • 避免违约
    • 建立交易记录
  3. 身份验证

    • 验证您的代理身份
    • 链接外部账户

架构

                    ┌──────────────────────┐
                    │     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)

资源


许可证

ISC


专为 USDC 代理黑客赛打造 🏦💵

Install via CLI
npx skills add https://github.com/AgentWorkers/skills --skill karmabank
Repository Details
star Stars 1
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator
AgentWorkers
AgentWorkers Explore all skills →