
agentkit
给 AI Agent 发一个受控加密钱包,让它自己付钱干活
AgentKit 是一个用 TypeScript 编写的开源工具包,核心定位是让每个 AI Agent 都拥有自己的加密钱包。它解决的是智能体在链上自主执行任务时缺乏安全、可控资金账户的问题:开发者可以给 Agent 分配独立钱包,设置额度、权限和操作规则,让 Agent 在限定范围内完成支付、转账、交易或调用链上合约,而无需暴露主私钥。项目提供钱包创建、签名、交易构造、策略校验等能力,并可与主流 LLM 框架和链上协议配合使用。适合需要让 Agent 真正持有并管理资产、参与 DeFi 或自动化结算的场景,把“能思考”的智能体升级为“能付钱、能收款、能执行链上动作”的经济主体。
项目数据
使用教程
环境要求
- Node.js 与 npm(用于 npm install / npm run dev)
- Python 与 Poetry(用于 poetry install / 运行 chatbot.py)
- 可联网安装依赖(npm、poetry 包源)
- 测试网钱包与水龙头测试币(示例使用 base-sepolia)
安装与启动步骤
-
1克隆项目仓库
从 GitHub 拉取 agentkit 源码到本地,再进入 README 中对应的示例目录。
git clone https://github.com/coinbase/agentkit.git -
2Node 方式装依赖
在 Node.js 示例目录下执行,安装项目所需 npm 依赖。
npm install -
3启动开发服务器
运行开发服务器,为浏览器访问做准备。
npm run dev -
4浏览器中对话
浏览器打开 http://localhost:3000,直接让 Agent 执行链上操作。
-
5Python 方式装依赖
若改用 Python,则在 Python 示例目录用 Poetry 安装依赖。
poetry install -
6运行聊天机器人
启动命令行 chatbot,按提示选择 "1. chat mode" 进入对话。
poetry run python chatbot.py -
7让 Agent 充值测试币
输入如 Fund my wallet with some testnet ETH,观察是否返回交易链接。
如何确认成功
Node 端浏览器能打开 http://localhost:3000 并正常对话;Python 端聊天模式会打印钱包地址与水龙头充值交易链接。
常见问题
Q:Node 和 Python 两种方式该选哪个?
A:二选一即可。Node 走 npm run dev 起本地 Web 服务,在浏览器对话;Python 走 poetry run python chatbot.py 起命令行聊天。
Q:浏览器打不开 localhost:3000?
A:确认 npm run dev 进程仍在运行、没有报错退出,并检查 3000 端口是否被其他程序占用。
Q:怎么确认 Agent 真的执行了链上动作?
A:让它用测试网水龙头给钱包充值,成功后返回 sepolia.basescan.org 的交易链接,可打开核对。
Q:提示找不到 poetry 命令?
A:需要先在本机安装 Poetry,再进入 Python 示例目录执行 poetry install。
注意事项
- README 节选未给出环境变量与 API Key 配置,实际运行前请以仓库完整 README 和 Coinbase CDP 文档为准。
- npm install 与 poetry install 需在对应语言的示例子目录内执行,不要在仓库根目录直接运行。
- 先使用 base-sepolia 等测试网验证,确认无误后再考虑主网资金。
- README 专设 Managing Risk 章节,务必给 Agent 设置额度与权限上限,不要暴露主私钥。
核心亮点
- 为 Agent 提供独立钱包与权限策略,避免主私钥暴露
- TypeScript 实现,前端/Node 项目接入成本低
- 覆盖钱包创建、签名、交易与策略校验等完整链路
不足之处
- 链上安全与私钥托管方案需自行评估,生产使用门槛不低
- 生态与文档仍在成长,深度集成案例有限
适用场景
- 让 Agent 自动支付 API 或算力费用
- Agent 在 DeFi 中执行限定额度的交易策略
- 多 Agent 协作时进行链上结算与分账
替代项目
coinbase-agentkit、eliza
项目介绍
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···