coinbase/agentkit
Coinbase Developer Platform 推出的 AgentKit，为每个 AI 智能体配备加密钱包和链上交互能力，支持多种 AI 框架与钱包，实现免手续费稳定币支付和 AI 代理变现。
社区作者 · zZz
它解决什么问题
AgentKit 是 Coinbase Developer Platform 的开源工具包，旨在为 AI 智能体提供加密钱包和链上交互能力。其设计为框架无关（framework-agnostic）和钱包无关（wallet-agnostic），可搭配任意 AI 框架与任意钱包使用。通过 AgentKit，开发者可以实现免手续费稳定币支付并让 AI 智能体无缝变现。项目仍在积极开发中，欢迎社区贡献。
仓库分为 TypeScript 和 Python 两个 monorepo，包含核心包（agentkit / coinbase-agentkit）、脚手架 create-onchain-agent、多个框架扩展（LangChain、Vercel AI SDK、Model Context Protocol、Autogen、OpenAI Agents SDK、Pydantic AI、Strands Agents 等），以及大量示例（如 langchain-cdp-chatbot、langchain-farcaster-chatbot、openai-agents-sdk-cdp-chatbot 等）。
AgentKit 支持 50+（TypeScript）或 30+（Python）个内置 action provider，覆盖钱包、社交（Twitter、Farcaster、XMTP）、DeFi 协议等，并支持所有 EVM 和 SVM 网络。项目采用 Apache-2.0 许可证，并附带明确的风险管理说明：由于 LLM 无法可靠区分指令和数据，攻击面包括直接接口和间接注入（如 Twitter/Farcaster 数据拉取），结合已注资钱包和资金转移 action provider，可能导致注入文本触发链上转账。
AgentKit 不默认对转账进行人工审批、不设支出上限、不限定目标地址，开发者需自行管理风险，可采用 guardrails 中间件、人工审批循环、提示注入过滤等策略。项目提供 Nightly Build 供体验最新代码。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
AgentKit 提供 Node.js 和 Python 两种快速开始方式，另外还有 Nightly Build 安装方式。
一、Node.js 快速开始
准备环境：需要 Node.js 22+、CDP Secret API Key、OpenAI API Key。
步骤：
- 创建新的全栈 agent 项目并进入项目目录：
npm create onchain-agent@latestcd onchain-agent- 在 .env.local 文件中填入 CDP API key id/secret、OpenAI API key 以及其他环境变量。
- 将 .env.local 重命名为 .env：
mv .env.local .env- 安装依赖：
npm install- 运行开发服务器：
npm run dev- 在浏览器访问 http://localhost:3000，开始让 Agent 执行链上操作。
示例交互： 用户：Fund my wallet with some testnet ETH. Agent：Your wallet has been successfully funded with testnet ETH. You can view the transaction here。
二、Python 快速开始
准备环境：需要 Python 3.10+、Poetry、CDP Secret API Key、OpenAI API Key。
步骤：
pipx run create-onchain-agent
- 创建新的 agent 聊天机器人：
- 进入项目目录：
cd onchain-agent- 在 .env.local 文件中填入 CDP API key id/secret、OpenAI API key 以及其他环境变量。
- 将 .env.local 重命名为 .env：
mv .env.local .envpoetry install
poetry run python chatbot.py
- 安装依赖：
- 运行聊天机器人：
- 选择 "1. chat mode"，开始让 Agent 执行链上操作。
示例交互： Prompt: Fund my wallet with some testnet ETH. 运行后输出钱包信息及交易链接，例如会收到 testnet ETH 并返回 sepolia.basescan.org 的交易地址。
三、Nightly Build 安装（可选）
TypeScript 最新版：
npm install @coinbase/agentkit@nightly @coinbase/agentkit-langchain@nightly若使用其他 AI 框架，请安装对应扩展包而非 @coinbase/agentkit-langchain。 安装指定版本，例如 2025 年 2 月 20 日的 nightly：
npm install @coinbase/[email protected] @coinbase/[email protected]Python 最新版：pip install --pre coinbase-agentkit coinbase-agentkit-langchain或使用 poetry： poetry add coinbase-agentkit coinbase-agentkit-langchain --allow-prereleases 安装指定版本，例如 2025 年 2 月 20 日的 nightly：
pip install coinbase-agentkit==0.1.2.dev20250220 coinbase-agentkit-langchain==0.1.1.dev20250220或 poetry add coinbase-agentkit==0.1.2.dev20250220 coinbase-agentkit-langchain==0.1.1.dev20250220 --allow-prereleases
常见问题与注意事项：
- 环境变量必须正确配置，否则无法连接 CDP 或调用 OpenAI。
- 安装依赖时如遇网络问题，请检查 npm/pip 源或代理设置。
- 运行时若 Agent 无法执行链上操作，请确认钱包有测试币且网络（如 base-sepolia）正确。
- 请务必阅读仓库中的 Managing Risk 部分，防止提示注入导致的资产损失。
