GOAT 快速上手指南

GOAT 是专为 AI Agent 打造的最大型金融工具包。它赋予 AI 代理经济行为能力，使其能够发送/接收支付、购买商品服务、执行投资策略（如赚取收益、预测市场、购买加密资产）、代币化资产以及获取金融洞察。

GOAT 基于区块链、加密货币和钱包构建，具有轻量级和高度可扩展的特点，支持按需安装插件。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Windows, macOS, 或 Linux
• Node.js: 版本 v20.12.2 或更高（TypeScript 开发必需）
• Python: 版本 3.9 或更高（Python 开发必需）
• 包管理器:
  • TypeScript: npm 或 yarn
  • Python: pip
• 钱包与密钥: 您需要一个兼容的区块链钱包（如 EVM 或 Solana 钱包）及相应的私钥或 API 密钥用于测试交易。

安装步骤

GOAT 采用模块化设计，您只需安装核心库和您需要的特定插件。

选项 A: TypeScript / Node.js

1. 初始化项目并安装核心库：

   npm install @goat-sdk/core
   

2. 安装所需的插件和钱包适配器（示例：安装 0x 交换插件和 EVM 钱包适配器）：

   npm install @goat-sdk/plugin-0x @goat-sdk/wallet-evm
   

   提示：您可以从 支持的工具列表 中选择其他插件，如 @goat-sdk/plugin-coingecko 或 @goat-sdk/plugin-crossmint-mint-faucet-wallets。

3. 安装 Agent 框架适配器（可选，根据您使用的框架）：

   # 例如安装 LangChain 适配器
   npm install @goat-sdk/adapter-langchain
   

选项 B: Python

1. 安装核心库：

   pip install goat-sdk
   

2. 安装所需的插件（示例：安装 1inch 插件）：

   pip install goat-sdk-plugin-1inch
   

   国内加速建议：如果下载速度慢，可使用国内镜像源：

   pip install goat-sdk -i https://pypi.tuna.tsinghua.edu.cn/simple
   

3. 安装 Agent 框架适配器（可选）：

   # 例如安装 CrewAI 适配器（需确认具体包名，参考官方 examples）
   pip install crewai
   

基本使用

以下是一个最简单的 TypeScript 示例，展示如何创建一个具备“发送代币”能力的 AI Agent。

TypeScript 示例 (配合 Vercel AI SDK)

import { createGoat } from "@goat-sdk/core";
import { evmWallet } from "@goat-sdk/wallet-evm";
import { sendToken } from "@goat-sdk/plugin-send-token"; // 假设存在此类基础插件或使用具体链插件
import { openai } from "@ai-sdk/openai";
import { generateText } from "ai";

// 1. 初始化 GOAT 客户端
const goat = await createGoat({
  // 配置钱包 (此处仅为示例，实际需传入真实的钱包实例或私钥管理器)
  wallet: evmWallet({
    privateKey: process.env.PRIVATE_KEY, 
    chainId: 1 // Ethereum Mainnet
  }),
  // 加载插件
  plugins: [
    // 添加您需要的功能插件，例如发送代币
    // sendToken(), 
  ],
});

// 2. 将 GOAT 工具集成到 AI 模型中
// 这里以 Vercel AI SDK 为例，将 GOAT 提供的工具转换为 Model 可调用的 Tools
const tools = goat.getTools();

// 3. 让 Agent 执行任务
const result = await generateText({
  model: openai("gpt-4o"),
  tools: tools,
  prompt: "向地址 0x123...abc 发送 0.01 ETH",
});

console.log(result.text);

Python 示例 (伪代码逻辑)

from goat_sdk import GoatClient
from goat_sdk.wallet.evm import EvmWallet
# 导入具体插件
# from goat_sdk_plugin_1inch import OneInchPlugin

# 1. 初始化客户端
client = GoatClient(
    wallet=EvmWallet(private_key="YOUR_PRIVATE_KEY"),
    plugins=[
        # 添加插件实例
        # OneInchPlugin()
    ]
)

# 2. 获取工具列表供 Agent 使用
tools = client.get_tools()

# 3. 在您选择的 Agent 框架 (如 LangChain, CrewAI) 中注册这些 tools
# agent = MyAgent(tools=tools)
# response = agent.run("查询当前 ETH 价格")

下一步

• 探索更多用例：访问官方仓库的 examples 目录，查看按用例（如亚马逊购物、DeFi 收益）、框架（LangChain, Eliza, Mastra）和钱包分类的完整代码示例。
• 自定义插件：如果现有 200+ 工具不满足需求，您可以参考文档轻松创建自定义插件、集成新链或新钱包。