Franklin Agent

这个 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 微支付结算，余额耗尽时停止。

1. 加密资产交易者在终端询问 BTC 或 SOL 行情，希望依据本地计算的 RSI、MACD、Bollinger 和波动率获得信号，再审阅交易计划。
2. 开发者希望在一个命令行会话中让工具读取 src/auth.ts、编辑代码并运行 npm test，同时查看每个步骤的费用。
3. 研究人员需要让 /goal 在限定轮次和 --max-spend 下调查多个 x402 兼容数据 API，并由对抗性审阅者核验完成声明。
4. 独立创作者想在没有 OpenAI API key 的情况下，通过已充值的钱包从 CLI 生成 logo 或其他图像。
5. 需要远程处理任务的用户，可在常驻机器配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_OWNER_ID，通过所有者锁定的 Telegram bot 恢复会话并执行请求。

如何安装或部署这个 Agent？

需要 Node.js 20.19+，项目建议 Node 22 LTS。安装并启动：

npm install -g @blockrun/franklin

franklin
也可以直接运行：

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 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

[![FARS 评测](https://followagents.com/badge/franklin.svg?lang=zh)](https://followagents.com/zh/agents/franklin)

<a href="https://followagents.com/zh/agents/franklin"><img src="https://followagents.com/badge/franklin.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v3.49.25 Franklin Agent 3.49.25 2026-11-08
   发布说明摘录

   What's Changed * chore(brand): refresh numbers — 117 models, 91 chat, 8 free by @VickyXAI in https://github.com/BlockRunAI/Franklin/pull/239 * chore: bump @blockrun/router-core to 273c2af, release 3.49.25 by @VickyXAI in https://github.com/BlockRunAI/Franklin/pull/243 Full Changelog: https://github.com/BlockRunAI/Franklin/compare/v3.49.24...v3.49.25

   在 GitHub 查看 ↗
2. v3.49.24 Franklin Agent 3.49.24 2026-11-06
   发布说明摘录

   Upgrade if you use Modal sandboxes. - The price follows the size. The gateways now bill a sandbox above 1 CPU or 1024 MB by the hour for its whole lifetime, never below the flat rate. ModalCreate looked its price up by GPU type alone, so an 8-core T4 would have confirmed and reserved $0.05 and then signed about $0.33. The confirm dialog, the reservation and the usage record now use the same rule. - Correct defaults in the tool text. cpu defaults to 1 and memory to 512 MB. The text said 0.125 and 128.

   在 GitHub 查看 ↗
3. v3.49.23 Franklin Agent 3.49.23 2026-11-03
   发布说明摘录

   Security fix. Upgrade if you run franklin proxy, franklin daemon or franklin init. - The proxy needs a token. franklin proxy signs a USDC payment from your wallet for every request it forwards, and until now it accepted any request that reached 127.0.0.1. Any other account on the machine, any local program, and any web page served from a local dev server could spend from your wallet through it. The proxy now refuses requests without its token with a 401. The token is created once in ~/.blockrun/proxy-token (owner-only) and is accepted as …

   在 GitHub 查看 ↗

常见问题