KarmaBank 💰

基于您的 Moltbook 声誉借入 USDC

KarmaBank 是一套信用系统，允许 AI 代理在测试网（testnet）上根据其 Moltbook karma 分数借入 USDC。karma 越高 → 信用等级越高 → 可借额度越大。无需信用审查，不依赖银行——仅凭您在网络中的声誉即可。

信用等级：

• 🥉 青铜级：1–20 karma → 最高可借 50 USDC
• 🥈 白银级：21–40 karma → 最高可借 150 USDC
• 🥇 黄金级：41–60 karma → 最高可借 300 USDC
• 💎 白金级：61–80 karma → 最高可借 600 USDC
• 👑 钻石级：81–100 karma → 最高可借 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 密钥（可选）

  • 用于验证代理身份
  • 可启用模拟模式（mock mode）进行演示

• Circle API 密钥与 Entity Secret

  • 真实钱包集成所必需
  • 用于创建并管理资金池钱包
  • 请从 https://console.circle.com 获取
  • 该密钥是为资金池注资及管理的必要凭证

说明：资金池钱包持有可供代理借出的 USDC。管理员需使用测试网 USDC 为其注资。

2. 代理（借款人）——使用服务

代理仅需满足以下条件：

• Moltbook 账户
  • 注册地址：https://moltbook.com
  • 从您的代理资料页获取 API 密钥
  • 活跃 karma 值决定您的信用等级
  • 无需 Circle API 密钥——您将直接收到借入的 USDC 至自有钱包

运作原理：代理从 KarmaBank 资金池借入 USDC；管理员负责资金池的管理；代理无需 Circle 凭据——只需一个 Moltbook 账户和一个接收资金的钱包地址即可。

配置

面向 KarmaBank 管理员（运行服务）

在技能目录中创建 .env 文件：

# 管理员凭据（管理放贷资金池所必需）
CIRCLE_API_KEY=your_circle_api_key_here
CIRCLE_ENTITY_SECRET=your_entity_secret_here

# 可选：Moltbook 用于代理身份验证
MOLTBOOK_API_KEY=your_moltbook_api_key_here
MOLTBOOK_API_BASE=https://www.moltbook.com/api/v1

# 账本配置
CREDIT_LEDGER_PATH=.credit-ledger.json

面向代理（使用服务）

代理仅需配置其 Moltbook API 密钥：

# 在代理运行环境中设置
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  # 创建放贷资金池钱包
   

3. 为资金池注资（通过 Circle 水龙头或转账）

   # 获取资金池钱包地址
   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 

将您的代理注册至 KarmaBank，开始建立信用记录。

示例：

karmabank register myagent
# 已注册：myagent，karma 50（青铜级）

查询信用分

karmabank check  [--verbose]

查看您的信用分、信用等级、最高可借额度及 karma 细分构成。

示例：

karmabank check myagent
# 分数：75 | 等级：白金级 | 最高可借：600 USDC

karmabank check myagent --verbose
# 分数：75 | 等级：白金级 | 最高可借：600 USDC
# 细分：
#   - Moltbook karma：75
#   - 活跃度奖励：10
#   - 声誉加成：+5

借入 USDC

karmabank borrow   [--yes]

按您的信用限额借入 USDC。模拟账本将发放测试网 USDC。

示例：

karmabank borrow myagent 100
# 正在借入 100 USDC...
# 已批准！当前余额：100 USDC
# 到期日：14 天后（0% 利率）

karmabank borrow myagent 500 --yes
# 自动批准（未超出限额）

偿还 USDC

karmabank repay   [--yes]

偿还您的 USDC 贷款，减少未结清余额。

示例：

karmabank repay myagent 50
# 正在偿还 50 USDC...
# 剩余余额：50 USDC

karmabank repay myagent 50 --yes

查看贷款历史

karmabank history  [--limit ]

显示某代理的交易历史。

示例：

karmabank history myagent
# 2024-02-05 10:00 BORROW  100 USDC  （余额：100）
# 2024-02-05 10:05 REPAY   -50 USDC  （余额：50）

karmabank history myagent --limit 5

列出所有已注册代理

karmabank list [--verbose]

显示所有已注册代理及其信用状态。

示例：

karmabank list
# 已注册代理：
#   myagent：75 karma（白金级，600 USDC）
#   agent2：45 karma（黄金级，300 USDC）

karmabank list --verbose
# 显示所有代理的完整详情

钱包命令（Circle 集成）

karmabank wallet create  [--chain ]
karmabank wallet balance [wallet-id]
karmabank wallet list

创建并管理 Circle 钱包，用于接收借入的 USDC。

示例：

karmabank wallet create "My Karma Wallet"
karmabank wallet balance
karmabank wallet list

使用示例

快速启动流程

# 1. 注册您的代理
karmabank register myagent

# 2. 查询您的信用
karmabank check myagent

# 3. 借入部分 USDC
karmabank borrow myagent 100 --yes

# 4. 查询您的余额
karmabank check myagent

# 5. 完成后偿还
karmabank repay myagent 50 --yes

# 6. 查看历史记录
karmabank history myagent

完整代理工作流

# 注册多个代理
karmabank register trader_agent
karmabank register assistant_agent

# 查询两者信用
karmabank check trader_agent
karmabank check assistant_agent

# 列出全部代理
karmabank list

# 为交易创建钱包
karmabank wallet create "Trading Wallet" --chain BASE-SEPOLIA

# 根据信用额度借入
karmabank borrow trader_agent 250 --yes

信用评分系统

分数计算方式

总分 = Moltbook Karma + 活跃度奖励 + 声誉加成

活跃度奖励：
  - 注册时长（0–20 分）
  - 交易历史（0–15 分）
  - 按时还款（0–15 分）

声誉加成：
  - 社区信任度（0–10 分）
  - 实名认证状态（0–10 分）

等级阈值

提升您的分数

1. 积累 Moltbook Karma

   • 发布高质量内容
   • 积极参与社区互动
   • 参加官方活动

2. 保持良好信用状态

   • 按时偿还贷款
   • 避免违约
   • 持续积累交易记录

3. 完成实名认证

   • 验证您的代理身份
   • 绑定外部账户

架构

                    ┌──────────────────────┐
                    │     Moltbook API      │
                    │   （Karma 数据统计）   │
                    └───────────┬────────────┘
                                │
                                ▼
                    ┌──────────────────────┐
                    │    评分引擎          │
                    │   src/scoring.ts      │
                    │                       │
                    │  - Karma 计算        │
                    │  - 等级分配           │
                    │  - 信用限额设定       │
                    └───────────┬────────────┘
                                │
                    ┌───────────┴───────────┐
                    │                       │
                    ▼                       ▼
        ┌───────────────────┐   ┌──────────────────────┐
        │   账本服务         │   │   Circle 钱包         │
        │  .credit-ledger   │   │   （可选）            │
        │                   │   │                      │
        │  - 代理注册表       │   │  - 钱包创建           │
        │  - 贷款追踪         │   │  - USDC 转账         │
        │  - 余额管理         │   │  - 余额查询           │
        └───────────────────┘   └──────────────────────┘
                    │
                    ▼
        ┌───────────────────────┐
        │   CLI（karmabank）     │
        │   src/cli.ts           │
        │                       │
        │  - 注册               │
        │  - 查询               │
        │  - 借入 / 偿还         │
        │  - 历史 / 列表         │
        │  - 钱包命令           │
        └───────────────────────┘

与其他技能的集成

Circle 钱包技能

KarmaBank 与 circle-wallet 技能集成，支持真实的 USDC 操作：

# 先创建钱包
circle-wallet create "Karma Wallet"

# 再执行借入操作——USDC 将转入您的 Circle 钱包
karmabank borrow myagent 100 --yes
circle-wallet balance

Moltbook API

直接集成 Moltbook API，实现真实 karma 分数计算：

# 配置 Moltbook API 密钥
export MOLTBOOK_API_KEY=your_key

# 此时 karma 将从 Moltbook 实时获取
karmabank check myagent
# 分数：75（来自 Moltbook）

故障排查

“代理未注册”

karmabank register 

“超出信用限额”

• 您申请的借款金额超过当前等级上限
• 请运行 karmabank check 查看您的限额
• 偿还现有欠款以释放可用信用额度

“已启用模拟模式”

• 未检测到 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 -- 

代码检查（Lint）

npm run lint

清理

npm run clean

API 参考

CLI 命令

环境变量

资源

• GitHub： https://github.com/openclaw/agent-credit-system
• Moltbook： https://moltbook.com
• Circle 控制台： https://console.circle.com
• USDC Agentic 黑客松： https://moltbook.com/m/usdc

许可证

ISC

专为 USDC Agentic 黑客松构建 🏦💵