Franklin Agent
用 USDC 钱包为研究、代码和交易任务按次付费执行。
- Star 数
- ★ 557
- 最近更新
- 3 天前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 43/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用
- 开始前需要
- 典型场景
- 加密资产交易者在终端询问 BTC 或 SOL 行情，希望依据本地计算的 RSI、MACD、Bollinger 和波动率获得信号，再审阅交易计划。
- 主要局限
- 核心模型与付费服务通过 BlockRun Gateway 和其钱包流程提供，采用时需接受该网关与支付路径。
这个 Agent 能做什么，适合哪些场景？
Franklin Agent 是 BlockRun 提供的 TypeScript 命令行智能体，核心是由用户钱包支付的任务执行循环。它通过 Smart Router 在多种模型之间选择，并经 BlockRun Gateway 调用模型、搜索、图像和其他付费服务；每次付费操作使用 x402 USDC 微支付结算。CLI 具备持久化会话、会话搜索、成本洞察、MCP 自动发现和插件 SDK，并可通过 Telegram 或 VS Code 扩展使用同一份钱包配置与会话历史。交易是其重点场景：它可从 CoinGecko 获取行情、在本地计算技术指标，并为 Jupiter、0x 和 Polymarket 交易生成需用户批准的交易计划。它适合愿意使用 BlockRun 钱包和网关、希望把模型与工具成本限制在 USDC 余额内的终端用户。
用户在 franklin CLI 中描述目标后，运行时依次执行 Intent → Smart Router → Tool Use → Spend Control → Result。它可使用 Read、Write、Edit、Bash、Glob、Grep、WebFetch、WebSearch、Task、ImageGen、MemoryRecall、AskUser、SubAgent 和 Trading* 工具读取与修改文件、运行命令、检索网页、生成图像、调用子任务及处理交易工作流。TradingSignal 从 CoinGecko 获取市场数据，并在本地计算 RSI、MACD、Bollinger 和波动率；真实交易会先提出包含场所、资产、规模、滑点、止损和总支出的 trade plan，只有批准后才会执行。会话流式写入磁盘，可用 /history、/resume 和 /session-search 恢复或检索；/cost 与 franklin insights 展示支出。付费调用由钱包签名的 x402 微支付结算，余额耗尽时停止。
- 加密资产交易者在终端询问 BTC 或 SOL 行情，希望依据本地计算的 RSI、MACD、Bollinger 和波动率获得信号，再审阅交易计划。
- 开发者希望在一个命令行会话中让工具读取 src/auth.ts、编辑代码并运行 npm test，同时查看每个步骤的费用。
- 研究人员需要让 /goal 在限定轮次和 --max-spend 下调查多个 x402 兼容数据 API，并由对抗性审阅者核验完成声明。
- 独立创作者想在没有 OpenAI API key 的情况下，通过已充值的钱包从 CLI 生成 logo 或其他图像。
- 需要远程处理任务的用户，可在常驻机器配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_OWNER_ID，通过所有者锁定的 Telegram bot 恢复会话并执行请求。
如何安装或部署这个 Agent？
需要 Node.js 20.19+，项目建议 Node 22 LTS。安装并启动：
npm install -g @blockrun/franklinfranklin
也可以直接运行：
npx @blockrun/franklin默认免费 NVIDIA 模型可直接使用。要使用付费模型和付费工具，执行 franklin setup base 或 franklin setup solana，然后向生成的钱包地址转入 USDC；franklin balance 可查看地址和余额。
如何使用这个 Agent？
首次可运行 franklin，或明确使用免费档：
franklin --model free在交互界面输入任务，例如“what's BTC looking like today?”或要求重构文件并运行测试。用 /model 选择模型、/plan 进入只读规划、/execute 切换执行、/cost 查看会话支出；长任务可用 /goal，定时任务可用 /loop。真实交易必须先审阅并批准 trade plan；批准预算会在 15 分钟后过期。远程控制需设置 TELEGRAM_BOT_TOKEN 与 TELEGRAM_OWNER_ID 后运行 franklin telegram。
这个 Agent 有哪些优点和局限？
- 以钱包余额作为硬预算上限；付费操作按 x402 USDC 微支付结算，文档声明无月费和无透支。
- Smart Router 提供 auto、eco、premium、free 四种策略，并在输出中显示所选模型、成本和节省情况。
- 交易执行有不可绕过的交易计划审批门槛，且可通过 lifecycle hooks 添加日限额、代币黑名单或支出账本等否决规则。
- CLI、VS Code 扩展和 Telegram 入口可共用 ~/.blockrun/ 配置与会话历史；会话可持久化、恢复和全文搜索。
- 核心模型与付费服务通过 BlockRun Gateway 和其钱包流程提供，采用时需接受该网关与支付路径。
- 付费能力依赖 Base 或 Solana 上的 USDC；余额为空时，付费模型和工具无法继续执行。
- 运行环境要求 Node.js 20.19+；文档明确指出较旧 Node 版本会在 Solana 依赖处因 ERR_REQUIRE_ESM 崩溃。
- 交易虽需审批，但文档列出的执行场所包括 Jupiter、0x 和 Polymarket；使用者仍需自行判断交易风险与审批内容。
这个 Agent 与同类方案有什么区别？
项目将自身与订阅制编码智能体、编辑器 IDE 和聊天机器人对比，主张其差异在于钱包原生 USDC/x402 支付、按结果计费、自动模型路由，以及可购买数据、搜索和图像服务。README 同时将按调用计费的 OpenAI API 列为“每次尝试均收费”的对照。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|
| Franklin Agent 当前 | 43 · 缺口较多 | ★ 557 | 3 天前 | TypeScript | — |
| Puppetmaster | 68 · 存在缺口 | ★ 444 | 4 天前 | Python | Codex · Claude Code |
| Agently AI 应用运行时 | 63 · 存在缺口 | ★ 1.7k | 11 天前 | Python | OpenAI API · Claude API |
| deepx-code | 63 · 存在缺口 | ★ 391 | 4 天前 | Go | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 声称交易需用户批准，且提供生命周期钩子（如每日支出上限、代币黑名单）作为护栏；钱包密钥不离开机器（非托管）。但未提供代码级证据，且未说明权限最小化原则。扣分：缺少代码验证，权限模型未详细说明。
证据显示：README 描述持久会话、崩溃恢复、模型回退；package.json 有测试脚本。但未提供测试结果或代码证据。扣分：无法验证自洽性，依赖可用性未证实。
证据显示：README 描述多种使用场景（交易、研究、代码、图像生成），支持 CLI、VS Code、Telegram；提供免费层。但能力边界未明确，触发精度未详细说明。扣分：能力边界模糊，触发条件不精确。
证据显示：README 结构清晰，提供快速开始、故障排除、项目布局；有 Apache-2.0 许可证；版本号存在。但缺少变更日志、已知限制未明确。扣分：无变更日志，已知限制未列出。
证据显示：README 声称输出可操作（如交易信号、代码重构），提供成本明细；YOPO 模式声称按结果付费。但成本效益未验证，边际价值未量化。扣分：成本效益未证实，边际价值未量化。
证据显示：README 包含具体数字（如模型数量、节省百分比），但未提供数据来源；品牌数字工作流存在，但未验证。扣分：声明缺乏可追溯性，事实与推断未分离。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 该代理能够自主花费 USDC，存在资金损失风险；务必设置支出上限并审查交易计划。
- 依赖项包含来自 GitHub 的 tarball URL，供应链风险较高；建议锁定版本并审计。
- 发布者身份未经验证，需谨慎对待。