核心用法
@openserv-labs/client 是 OpenServ AI 平台的官方 TypeScript 客户端，与 openserv-agent-sdk 配套使用构建可部署智能体。核心入口为 provision()——单次调用即可完成钱包创建、平台认证、智能体注册、工作流与触发器配置，并自动生成 API 密钥。开发者仅需调用 provision() 与 run() 两个函数即可启动完整服务。
显著优点
- 极简部署:
provision()实现真正的一键上链，自动处理钱包、认证、工作流图构建与激活 - 灵活触发器: 内置 webhook（免费）、x402（按次付费，支持 USDC）、cron（定时）、manual（平台手动）四种触发模式
- 支付原生集成: x402 协议实现"无钱包感知"支付，调用方支付后才执行任务，适合 SaaS 化 Agent 服务
- 链上身份: ERC-8004 标准支持在 Base 链铸造身份 NFT，发布服务元数据至 IPFS，实现可发现、可验证的链上 Agent 经济
- 模型参数配置: 支持为 Agent 任务指定 LLM 模型与生成参数（如 GPT-5、reasoning_effort 等）
潜在局限与风险
- 双包依赖: 必须与
openserv-agent-sdk配合使用，单独安装无法运行 - Gas 成本: ERC-8004 链上注册需要 Base 链 ETH，新手可能遗漏充值步骤
- 环境变量复杂: 存在 Agent API key、User API key、Wallet private key 三种凭证，用途易混淆，错误使用会导致 401 错误
- 超时配置敏感: 复杂任务需显式设置 600-900 秒超时，默认值可能不足
适合人群
- 希望将 AI Agent 快速产品化的开发者
- 需要构建多步骤工作流或 Multi-Agent 系统的团队
- 探索 Agent 经济模型（按调用付费、链上服务发现）的 Web3 开发者
常规风险
- 钱包私钥由
provision()自动生成并写入.openserv.json，需妥善保管该文件 WALLET_PRIVATE_KEY写入.env后需重新加载（dotenv.config({ override: true })），否则进程环境变量仍为旧值- 删除工作流/Agent 操作不可逆，生产环境需谨慎执行