LP 计划

安装指南

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

什么是

LP Plan 是 Openclaw Skills 中的一款工具，用于规划或回测 Uniswap v2、v3、v4、Aerodrome 和 Slipstream 上的流动性操作。它可将选定的池、钱包、操作和资金预算转化为结构化计划，涵盖仓位规模、代币金额、范围或刻度、授权、交易限制和执行前检查。
此技能仅用于规划：不会连接钱包、请求确认、签名或提交交易。缺少必要的身份、风险、报价或模拟证据时，计划会明确保持不可执行状态。这一边界使 Openclaw Skills 可用于准备可审查的交接内容，同时不暗示报价或模拟能够保证交易执行。

应用场景

为选定且已验证的池规划新的流动性存入操作，并设置用户定义的资金、支出上限、目标和风险限制。
在适当情况下，利用历史表现证据比较或回测集中流动性范围。
根据报价执行价格确定代币所需资金，包括在完整报价序列支持时使用单代币或第三方代币提供资金的工作流。
使用现有仓位及其实际资产，准备手续费领取、奖励领取、移除、解除质押或其他仓位操作。
检查手续费等级、授权、滑点和价格影响限制、gas、截止时间、交易顺序及执行前要求。
生成供审查或移交给执行工作流的未签名计划，不请求签名。

工作原理

收集所需输入：链、钱包地址、协议版本、准确的池或仓位身份，以及请求的操作。只询问缺少的重要信息；不要臆造钱包身份、支出限额或风险承受能力。
重新读取并绑定当前链 ID、区块、钱包、池、代币顺序和小数位数、手续费及刻度间距或不变量，以及相关的 hook、manager、router、gauge 和奖励信息。
为该协议选择正确的仓位模型。对于新的或变更后的集中流动性范围，设计并可选择回测该范围；不要将集中流动性数学应用于全范围仓位。
使用精确整数运算或当前官方 SDK 计算所需资金。对于领取、奖励申领或移除操作，使用现有仓位的准确数量和预期输出，并考虑钱包余额及闲置资产。
构建并报价完整交易序列。对每一步应用支出上限、最低输出或流动性、价格影响和 gas 限制以及截止时间；如果后续 calldata 取决于前序交易的结果，则延后构建。
将每项授权绑定到其代币、spender、金额、机制、到期时间和清理规则。
使用实际钱包及准确的 value 和 calldata 模拟每笔交易。如果无法获取必要报价、读取数据或模拟结果，则保持计划不可执行。
输出包含状态读取、恢复检查点、到期条件及任何可选界面交接的结构化计划。不要请求签名或声称交易已执行。

配置指南

从已安装的技能目录使用该技能，并在该目录中解析其脚本和参考资料，不要假定这些文件位于代理工作区。可执行计划需要只读链上数据和报价访问权限；模拟还需要适用的钱包、RPC、ABI 和交易构建能力。仅有说明并不能提供实时数据或集成。
捆绑的范围工具要求 Node.js 20 或更高版本。确认代币方向和刻度间距后，查看其支持的参数：
node scripts/range.mjs --help
将脚本输出视为确定性的刻度算术结果，而非策略建议。如果缺少 RPC、ABI、报价或钱包能力，请在可用时使用 lp-setup；否则盘点现有工具并报告缺少的内容。通过代理运行环境按精确名称发现可选的相关技能，不要假设它们位于相邻目录，也不要暗中安装。

数据架构

LP Plan 会输出一种计划契约，旨在保留审查和交接所需的身份、交易详情、证据及限制。请纳入适用字段，例如：
区域 需绑定的信息
身份与状态 链 ID、观测区块、钱包、池或仓位、协议、代币顺序、代币小数位数，以及相关池或合约状态
仓位与操作 请求的操作、仓位模型、准确金额、流动性、适用时的范围或刻度，以及预期资产输出
资金与交易限制 最大支出、授权、spender、授权金额及到期时间、calldata、交易 value、滑点或价格限制、gas 限制及截止时间
证据与恢复 报价、模拟结果、预期影响、状态读取、恢复检查点，以及未解决或缺失的字段
有效性 区块时效、价格、池、hook、gauge、钱包或代币余额变动时的到期时间和容差
金额、余额、流动性、授权和 calldata 均为整数；小数值仅用于展示。上限刻度不包含在范围内，且必须明确说明面向用户的价格方向及协议的 token0/token1 顺序。对于不相关字段，应注明不适用并说明原因。该技能描述的是结构化计划输出，而非单独生成的文件或持久化元数据分类体系。

高级特性

支持针对 Uniswap v2、v3、v4、Aerodrome 和 Slipstream 进行规划，并采用适合各协议的仓位模型。
通过捆绑的 Node.js 范围脚本提供确定性的刻度对齐；按照所引用的回测标准使用时，也支持历史回测。
处理资金提供和转换的交易序列；当后续 calldata 依赖已挖出交易的输出时，会延后构建。
应用授权策略及每一步的输入、输出、流动性、价格影响、gas、截止时间和支出上限限制。
在可用时可选集成相关分析、设置、执行和特定协议技能；通过精确名称发现相关技能，不会暗中安装。
严格遵守未签名边界：不连接钱包、不请求确认、不签名、不提交，也不声称已完成。只有在用户明确请求执行后，经过审查的计划才可转交给
lp-execute
。

name: lp-plan description: "Design or backtest an exact unsigned liquidity plan for a chosen Uniswap v2, v3, or v4 or Aerodrome or Slipstream pool. Use when the user asks for position size, token amounts, range or ticks, historical range performance, fee tier, staking route, approvals, slippage limits, deadlines, transaction order, or preflight checks. Planning only; not for selecting an unassessed pool, signing, or submitting." license: MIT
compatibility: "Requires read-only chain and quote access for executable plans. The bundled range script needs Node.js 20 or newer."