JarvisClaw

中文

English

中文

English

Appearance

命令行工具 ​

一个自带钱包的终端 agent。你说要什么，它自己找 API、付款、给答案。

bash
npx jarvisclaw "查一下现在比特币的网络手续费是多少"
… thinking
  paying $0.001150 — Btc Fees (federation/3675) GET
  calling Btc Fees…

当前比特币网络手续费率（聪/虚拟字节）：
  最快确认（约下一区块）：5 sat/vB
  半小时：4 sat/vB
  一小时：3 sat/vB
  经济模式：2 sat/vB

内存池中等待处理 86,076 笔交易。

used: search_apis → get_api_detail → call_api
spent: $0.001150

这次运行没有用到 API Key，事先也没有任何配置，只有一个有余额的钱包。

安装 ​

bash
npm install -g jarvisclaw

也可以不安装直接跑：

bash
npx jarvisclaw "<任务>"

免费用，无需配置 ​

以下命令在你还没有任何凭据时就能用：

bash
jarvisclaw search "bitcoin fees"   # 搜索 API 目录
jarvisclaw models                  # 可用模型，便宜的在前
jarvisclaw agents                  # 平台上的其他 agent
jarvisclaw --help

search 按语义匹配，不只是子串匹配 —— 搜 "bitcoin fees" 能找到比特币手续费接口，即使没有任何条目包含这个连续短语。

对话也可以零凭据使用，走免费模型：

bash
jarvisclaw "解释一下 x402 是什么"

付费调用 ​

两种付款方式，选一个：

bash
jarvisclaw setup

钱包（默认）会在本地生成密钥并打印一个地址。往这个地址在 Base 上打 USDC 即可开始花费。Gas 由网关承担，你只需要准备 USDC。

API Key 走账户余额扣费。如果你已经有 Key，用这个。

两种方式都支持：

bash
jarvisclaw balance   # 可花费余额
jarvisclaw wallet    # 你的地址，以及如何充值

balance 读的是链上余额，不是内部账本。它才是 agent 能花多少的真实约束。

花费闸门 ​

两道上限，默认都开启：

默认值行为
单笔$0.05超过就询问你
单会话累计$1达到即停止运行

会话上限是直接拒绝，不是询问。如果一次任务需要超出你允许的额度，正确做法是主动调高上限，而不是在任务中途被追问时匆忙同意。

低于阈值的调用不会询问，但一定会打印出来 —— 所以即使没被问，你也看得见每一笔付款。单次调用只有千分之一美元级别，每笔都确认意味着一个任务弹六次；而连点六次确认的用户，其实已经不看内容了。

修改默认值：

bash
jarvisclaw config set max-call 0.01
jarvisclaw config set max-spend 0.5

或只对本次运行生效：

bash
jarvisclaw --max-call 0.01 "<任务>"
jarvisclaw --max-spend 0.5 "<任务>"
jarvisclaw --confirm-all "<任务>"   # 每笔都问，不管多小

这两道闸门由 CLI 自己执行，代表你声明的意图，不是网关规则。真正的硬上限始终是钱包余额：它只装你打进去的钱，所以最坏情况在 agent 开始跑之前就已经被限定了。

选择模型 ​

默认 auto，读完提示词后按请求逐次选择。

bash
jarvisclaw -m anthropic/claude-sonnet-4.6 "<任务>"
jarvisclaw -m auto/eco "<任务>"       # 最便宜的付费模型
jarvisclaw -m auto/premium "<任务>"   # 最强，成本最高
jarvisclaw -m auto/free "<任务>"      # 仅免费模型

配置前的默认值是 auto/free。路由如何决策见智能路由。

设置长期默认：

bash
jarvisclaw config set model auto/eco

交互式会话 ​

不带参数运行，多轮之间保留上下文：

bash
jarvisclaw

花费闸门作用于整个会话，所以会话上限覆盖整段对话，不会每轮重置。

配置 ​

bash
jarvisclaw config                    # 当前生效的配置及其来源
jarvisclaw config set <key> <value>  # model / max-call / max-spend
jarvisclaw logout                    # 删除已保存的凭据

配置存在 ~/.jarvisclaw/config.json；自动生成的钱包私钥存在同目录的 ~/.jarvisclaw/wallet.json，权限仅本人可读。两者都不会被传输到任何地方 —— 除了作为你正在发起的那笔付款的签名。

用 --base-url 指向其他网关，或用 --api-key / --wallet-key 只为本次调用传入凭据。

它在背后做了什么 ​

对于需要实时数据的任务，agent 会跑三步，并告诉你用了哪些：

  1. search_apis —— 在目录里找候选接口
  2. get_api_detail —— 读参数和价格
  3. call_api —— 付款并调用

第 1、2 步免费。只有第 3 步花钱，也正是花费闸门管的那一步。

相关文档 ​