LP Setup

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install galleon-lp-setup
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 galleon-lp-setup。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

LP Setup 帮助 Agent 从已安装的技能过渡到已验证的链观察，以及用户预期的流动性任务所需功能的明确盘点。它检查连接证据，识别缺失或失败的工具，并返回结构化的就绪报告，而不处理钱包权限。
对于使用 Openclaw Skills 的团队，此技能为 LP 工作流提供了一个安全、可操作的起点：最新的 RPC 观察可以确认端点连接性，但它不能证明协议就绪性、共识或交易授权。此技能绝不选择流动性池、授权钱包、签名或执行交易。

应用场景

在 Agent 执行第一个流动性提供者任务之前，验证预期的链和 RPC 连接性。
安装 LP Skills 时，确定当前 Harness 实际暴露了哪些 web、RPC、ABI、报价、模拟或钱包功能。
诊断缺失、过时、格式错误或链不匹配的 RPC 观察。
在将工作移交给另一个 LP 技能之前，识别所需的具体缺失功能和配置。
为流动性池分析、规划、监控或适配器工程准备已验证的只读工具证据。
在相关 VFAT 指南适用时，筛选 VFAT 收益、Sickle 持仓或自动化。

工作原理

发现 Harness 的可用工具并记录其真实名称和允许的方法；安装技能不会创建集成。
确认用户预期的链和协议。如果未指定链，在继续工具盘点的同时询问用户。
使用现有的 RPC 工具或内置的 Node.js 诊断工具获取只读链观察。诊断工具仅调用 eth_chainId 和 eth_getBlockByNumber。
将观察到的链 ID 与预期的链进行比较，并评估区块结果的有效性和新鲜度。将错误、格式错误的数据、过时的区块头和不匹配视为失败的检查。
参考工具连接图，仅测试预期任务所需的额外功能。将每个功能记录为 available、missing、failed 或 not-tested，并带有证据和观察时间。
返回就绪契约，包括不存在观察值的未知值，以及 Agent 已准备好执行的具体只读任务、缺失的要求和下一步行动。
将相关的链、工具和证据详细信息移交给适当的 LP 技能。Setup 本身绝不授予交易批准或执行权限。

配置指南

通过用户的具备技能能力的 Agent Harness 安装或使其可用；源码未规定通用的安装命令。可选的 RPC 诊断工具需要 Node.js 20 或更高版本以及用户配置的 LP_RPC_URL 环境变量。通过环境或 Harness 密钥设置配置 URL——切勿将其粘贴到聊天或日志中。从该技能的目录运行命令，根据需要替换预期的十进制链 ID：
node scripts/connection.mjs --chain-id 8453
示例检查了 Base (链 ID 8453)。脚本执行只读 RPC 调用，不检查钱包余额或写入交易。如果现有的 RPC 工具可用，请改用它进行相同的两次读取。关于工具选择，请参考 references/official-tools.md；使用 references/connections.md 来映射任务需求。对于 VFAT 收益筛选、Sickle 持仓或自动化，还请参考 references/vfat.md。

数据架构

此技能生成就绪报告；源码未指定持久化输出文件或存储格式。包含以下字段：
字段 含义
observedAt 观察到就绪证据的时间。
expectedChainId 用户预期的十进制链 ID。
observedChainId 只读检查返回的链 ID。
blockNumber, blockHash, blockTimestamp 观察到的区块详情。
fresh 观察到的区块头是否通过新鲜度检查。
capabilities 每个功能的名称、实际工具、状态和证据。状态为 available、missing、failed 或 not-tested。
readyFor 由已验证功能支持的具体只读任务。
missing 仍需要的功能或配置。
nextAction 建议的下一步。
未观察到的值必须为 unknown。切勿包含端点 URL、授权头、凭据或私钥。最新的区块仅作为端点连接性的证据，不作为独立的共识验证或协议/工具就绪性的证明。

高级特性

仅使用
eth_chainId
eth_getBlockByNumber
执行最小的只读 RPC 诊断。
支持内置的 Node.js 诊断工具或通过已可用的 RPC 工具进行等效读取。
将功能状态与证据和观察时间分离，使就绪检查可被审计。
当一个集成失败时，继续进行独立的只读检查，而不是将一次失败作为捏造结果的理由。
lp-analyze
、
lp-plan
、
lp-monitor
、
lp-execute
lp-engineer
提供明确的移交要求。
将钱包权限置于技能之外：它不导入密钥、更改权限、请求批准、签名、发送交易或资助账户。
在保持工具采用可选性的同时，指导重用维护良好的上游工具（如适用）。

name: lp-setup description: "Set up and diagnose an agent's LP data and tool capabilities before its first liquidity task. Use when the user installs LP Skills, asks how to connect RPC or wallet tools, or needs missing/stale connection diagnostics. Produces a read-only readiness report; not pool selection, wallet authorization, or transaction execution." license: MIT
compatibility: "Portable instructions for any skill-capable agent. The optional read-only RPC diagnostic requires Node.js 20+ and a user-configured LP_RPC_URL environment variable."