给AI代理配一个链上钱包:agentkit的设计与边界

agentkit 链上钱包 项目概念

当一个社区客服机器人需要替用户查余额、领取测试币,甚至发起一笔小额转账时,它缺的是更聪明的模型,还是一个能接入的链上钱包?agentkit 是 Coinbase Developer Platform 提供的工具包,README 将其定位为让 AI 代理获得加密钱包并进行链上交互的框架无关、钱包无关工具集。下面用一个明确标为假设的场景贯穿全文:假设你要做一个社区客服代理,允许用户用自然语言查询余额、领取测试网代币,并在测试网上发起小额转账。这个场景只用于解释设计,不是实测。

模型接入钱包后,错误动作为何会变成交易?

在假设场景里,用户可能说“帮我领点测试币”或“给这个地址转一点”。这不是单纯的问答,而是模型要选择工具、钱包要执行链上操作。难点在于:模型输出不一定稳定,外部文本又可能混进上下文;一旦钱包有资金、动作能转账,错误选择就会变成真实交易。README 把 AgentKit 定位为给 AI 代理提供加密钱包和链上交互的工具包。它把“模型决策”和“钱包执行”接在一起,要解决的不是让模型更聪明,而是提供一套可插拔的动作与钱包适配层,让开发者把链上能力接入现有代理框架,同时自行处理权限与风险。这个场景里,查询余额风险较低,领取测试币和转账则需要额外防护。

动作与钱包适配层如何接入现有代理框架?

agentkit 的项目身份是 Coinbase Developer Platform 的开源工具包。README 说明 AgentKit 组织为 Python 和 Typescript 两个 monorepo,每个包含多个包。它的思路不是另造一个代理框架,而是做适配层:动作提供者把可执行能力包装成模型可调用的工具,钱包提供者负责承接钱包、签名与网络差异。README 称它设计为框架无关,可与任意 AI 框架配合;也设计为钱包无关,可与任意钱包配合。在假设场景里,客服代理可以继续用你熟悉的代理框架,只把“查余额”“领水”“转账”注册为动作,再选择一个钱包提供者。这样做的代价是,能力越强,越需要开发者自己设计审批、额度和地址限制。

动作提供者、钱包提供者与框架扩展如何分工?

核心机制可以拆成两条线。动作提供者把链上或协议操作封装成工具,模型通过工具调用选择动作;钱包提供者把不同钱包的差异藏起来,让动作不必关心底层是 CDP、Privy 还是 viem。AgentKit 的 TypeScript 代码库在 action-providers 目录中提供 50 多个动作。Python 的 action_providers 目录也标注了 30 多个动作。AgentKit 的钱包提供者目录包含 cdp、privy 和 viem。框架扩展则把 AgentKit 接到 LangChain、Vercel AI SDK、模型上下文协议等框架上。这里的“模型上下文协议”可理解为让模型以统一方式发现和调用外部工具的协议。在假设场景里,客服代理看到“领水”这个动作,就调用对应提供者,再把交易结果作为工具输出交回模型组织成自然语言。

agentkit 工作流程 机制示意

从创建项目到请求测试币要经过哪些环节?

README 的快速开始给出两种入口:Node.js 和 Python。README 的 Node.js 快速开始列出 npm create onchain-agent@latest 作为创建项目的命令。README 的 Python 快速开始使用 pipx run create-onchain-agent 创建聊天机器人项目。随后按 README 填写 CDP Secret API Key、OpenAI API Key 等环境变量,安装依赖并运行。以假设场景走一遍:用户说“帮我领测试币”,代理框架把这句话和可用动作交给模型;模型选择领水动作;动作提供者调用钱包或协议;结果回到模型;模型用自然语言回复并附上交易信息。README 的示例对话展示了从用户请求到钱包地址、交易结果和回复的链路。需要强调,这只是 README 描述的工作流,本文没有独立运行验证。

动作与钱包如何解耦,护栏为何仍需自行配置?

关键设计之一是把“动作”和“钱包”解耦,让同一套动作可以搭配不同钱包,也让同一钱包接入不同代理框架。README 的仓库结构显示,TypeScript 和 Python 都提供框架扩展与示例,示例覆盖聊天机器人、智能钱包、Farcaster、Twitter、Solana 等组合;这些示例是作者提供的参考,不是本文实测结果。另一个关键设计是把风险控制留给开发者。README 把护栏中间件称为一种常见策略。它提到 LangChain 中间件文档和 guardrails 聊天机器人示例,后者把转账的人工在环审批与提示注入过滤结合起来。在假设场景里,这意味着你可以先在测试网跑通“领水”和查询,再对转账动作加审批;但 README 本身没有把这些护栏设为默认。

哪些链上原型可按需组合钱包与动作?

在假设场景里,AgentKit 更适合做“自然语言触发链上操作”的原型或内部工具:社区客服、测试网演示、跨框架实验、需要同时适配多种钱包和多条链的代理。README 称支持所有 EVM 和 SVM 网络,并对所列网络提供较深的协议支持。它还列出多种钱包提供者、动作提供者和框架扩展,说明设计目标是让开发者按需组合,而不是绑定单一技术栈。对需要免手续费稳定币支付或代理商业化探索的团队,README 也把它描述为相关方向;但这不是收益保证。若你的场景是无人值守、钱包长期有较大余额、用户可以自由输入文本,那么它不是一个“开箱即安全”的方案,而是一个需要你补上审批、限额、白名单和监控的基础设施。

提示注入为何可能触发缺少默认护栏的转账?

最大限制来自模型与资金的组合。README 指出 LLM 不能可靠区分指令与数据,因此进入模型上下文的文本可能影响代理采取的动作,包括转账。直接面包括第三方给代理发文本的网站、聊天机器人或 API;间接面包括把外部内容拉进上下文的动作,例如 Twitter 动作提供者返回提及、Farcaster 动作提供者返回资料,这些都会作为工具输出被模型读到。README 说明 AgentKit 不会在转账前要求人工批准,也不强制花费上限或目的地白名单。README 说明 walletActionProvider 默认注册。于是,一个有钱包且有转账动作的代理,可能被注入文本诱导转账;README 称这种风险是设计固有的,无法在 SDK 内解决。本文未独立实测,上述均为 README 自述。法律部分还称软件是实验性的、按现状提供,输出可能不准确。

接入前如何评估资金、输入面与安全责任?

使用前先判断三件事。第一,钱包里放什么:如果只是测试网代币和少量资金,风险可控些;如果是主网真实资产,就要把人工审批、花费上限、地址白名单和监控当成必需项。第二,输入面有多大:公开网站、公开聊天、社交媒体提及和外部 API 都会扩大提示注入面;假设场景中的社区客服若允许任何人发消息,就属于高风险输入面。第三,是否接受“开发者负责安全”的前提。README 说明使用 AgentKit 即表示开发者接受管理这些输入面并保护资金安全的责任。它不把转账护栏设为默认,因此适合先做小范围、可回滚的试验,再逐步收紧权限。若团队没有链上安全经验,至少应先读风险章节和护栏示例,并做独立审计与测试;本文仅依据 README 资料整理,未独立实测。

本文仅依据README资料整理,未独立实测。

参考来源

本文仅据固定版本 README 整理,未独立实测;仅作技术介绍,不构成安全审计或投资建议。

采集时间:2026-10-26T10:35:24.828Z;1339 Star 快照。首次发现;暂无可用的约24小时基线,日增长未知。

coinbase/agentkit README · f2f3e8c11a91d56a17979a229a172ba6e61a85c2

GitHub 仓库及采集时元数据

标签 链上钱包agentkitAgent钱包钱包权限管理

本文基于公开媒体报道整理,仅作信息参考,不构成任何投资依据,内容以原文为准。

相关阅读

同分类「网络安全」的其他稿件

更多网络安全 →