用途:把 AI 智能体接入 Senpi 交易平台。完成后智能体将拥有 Senpi 账户、API 密钥和可用的 MCP 服务器连接,用于投资组合管理、交易员发现、策略创建及在 Hyperliquid 上执行订单。
前提条件:具备 Shell/代码执行权限,并安装 Node.js(npx 需要)。默认 MCP 端点为 https://mcp.prod.senpi.ai,推荐码可选。
主要流程:先初始化 ~/.config/senpi/state.json 状态文件并切换到 ONBOARDING;随后收集身份(Telegram 用户 ID、用户提供的 0x 钱包地址,或由智能体生成 EVM 钱包);设置可选推荐码;调用公开 GraphQL 接口 CreateAgentStubAccount 创建账户并获取 API 密钥;解析并保存凭据到 ~/.config/senpi/credentials.json(权限 600);再按平台配置 MCP 服务器(OpenClaw 用 mcporter、Claude Code 用 claude mcp add,或写入 .mcp.json);最后更新状态为 UNFUNDED 并输出确认信息。
使用方式:按步骤顺序执行,不可跳过;状态为 ONBOARDING 时从记录的步骤恢复。生成钱包时使用 ethers@6 脚本,私钥与助记词写入 wallet.json 并设权限 600,切勿记录或显示。
适用场景:需要让智能体自动完成 Senpi 账户开通、密钥配置与 MCP 接入,并准备后续首次交易。
限制与安全:API 密钥只能发送到指定 MCP 端点,不得公开或泄露;钱包私钥泄露即失去资金控制;需向智能体钱包地址充值 USDC(支持 Hyperliquid、Base、Arbitrum、Optimism、Polygon、Ethereum),余额不足 100 美元时无法交易。涉及 Arena 相关提问须先调用 read_senpi_guide(uri="senpi://guides/arena")。其余细节以官方参考文件为准。