Uniswap v3 流动性

安装指南

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

什么是

Uniswap v3 流动性可利用经验证的池身份、链上仓位数据、可用刻度、代币组成和预估交易成本，评估现有 NFT 仓位或规划新仓位。它采用符合协议规则的代币排序与刻度计算，并区分应收代币、本金和费用收入。
作为 Openclaw Skills 中用于 DeFi 仓位分析的技能，它会准备未签名的操作序列，而不会签名或提交交易。公开的区间分析不需要钱包；执行则需要现有的授权钱包工具，并且必须对具体操作拥有明确授权。

应用场景

使用代币 ID、链和池数据检查现有 Uniswap v3 NFT 仓位。
分析代币对，并为新仓位选择一个包含当前价格且符合刻度间距的区间。
决定是持有、领取费用、向当前区间添加流动性，还是降低敞口。
通过比较所选期限内的模型费用与兑换、gas 和价格影响，评估替换区间。
通过规划完整的流动性减少、领取以及可选的 NFT 销毁来关闭仓位。
调查费用领取情况，避免将返还的本金误分类为费用收入。
使用附带的区间探测工具离线检查刻度取整和代币库存方向。

工作原理

确定链，并提供仓位代币 ID 或代币对。仅有代币 ID 不足以确定管理器和链。
在同一个区块验证官方 v3 factory 和 NonfungiblePositionManager 的部署、字节码、factory 身份及池身份。
对现有 NFT，读取其所有者和仓位字段，解析对应池，并检查当前价格、刻度间距、流动性和代币小数位。如果 NFT 归金库所有，则停止直接所有者工作流，并查明其赎回接口。
在解读价格前，先按地址排序确定 token0 和 token1。设置用户的时间范围与库存约束，然后将请求的边界向外取整到有效刻度间距和可用的 TickMath 限值。
使用官方 v3 SDK 的 Pool 和 Position.fromAmounts，并结合观测到的价格数据和原始代币预算来确定组成及铸造数量；不得根据 USD 权重或浮点运算推断所需数量。
选择符合目标的最小操作：领取、增加、减少并领取、替换区间或完全关闭。若更改区间，则将成本与模型增量费用及持有基准进行比较。
阅读相关操作配方，绑定接收方、支出和输出限额、截止时间、管理器、授权和 gas 预算，然后从实际所有者处模拟最终 calldata。除非可以模拟完整原子调用，否则应暂缓依赖输出的多步操作。
除非授权钱包工具拥有明确授权，否则只返回未签名方案。对于已提交的交易，核对其哈希，并要求在已确认的区块上取得成功回执、管理器后置状态，以及接收方余额或事件证据，之后才能报告完成。

配置指南

该技能指定只读 EVM RPC 和官方协议 API 或 UI 作为分析输入。它不包含签名器或签名运行时，也未定义软件包安装命令。使用已安装的技能目录，并且只针对正在准备的操作查阅 references/recipes.md。
Node.js 20 可用于离线刻度区间辅助工具（可选）。在已安装的技能目录中运行：
node scripts/ticks.mjs '{"lower":-121,"upper":119,"spacing":60,"current":120}'
该辅助工具会将整数刻度边界向外取整，并识别代币库存方向。它不会发现代币顺序、选择盈利区间或计算铸造数量。准备金融操作前，请重新核验官方部署和 API 架构。

数据架构

该技能介绍链上仓位数据和已安装文件；它未定义独立的持久化数据库或生成的仓位文件。
数据或文件 用途
SKILL.md 元数据 声明技能名称、描述、MIT 许可证、兼容性、作者和版本 0.6.1。
链和管理器身份 使用该链官方的 v3 factory 和 NonfungiblePositionManager，并检查部署和字节码。
仓位和池字段 读取 ownerOf(tokenId)、positions(tokenId)、池身份、slot0()、tickSpacing()、liquidity() 和代币小数位。
数量表示 将原始代币数量保留为整数字符串；token0 和 token1 遵循协议按地址排序的顺序。
区间数据 跟踪下限和上限刻度、间距、当前刻度，以及仓位是否处于活跃状态或适用哪一侧代币库存。
费用和本金核算 将 tokensOwed0/1 视为检查点核算数据，并不一定是当前费用；先前的减少操作可能会将本金加入应付代币。
references/recipes.md 包含所选操作的具体调用和协议来源。
scripts/ticks.mjs 用于刻度边界取整和识别库存方向的离线辅助工具。
方案和核对证据 未签名方案可包含操作、旧代币 ID、拟议刻度、成本和缺失的模拟。完成证据包括区块上的回执、管理器后置状态，以及接收方余额或事件数据。

高级特性

在规划操作前，验证官方 factory 和管理器身份，并解析特定区块的池状态。
使用按地址排序的代币顺序、考虑小数位的价格解读、可用刻度边界和官方 SDK 组成计算。
区分池级流动性与 NFT 流动性，并区分检查点应收余额与当前可领取费用。
通过针对各操作的完成证据，对领取、增加、减少、区间替换和关闭工作流建模。
提供可选的 Node.js 20 离线刻度探测工具，用于向外取整和检查库存方向。
要求从实际所有者处模拟最终 calldata，并获得明确操作授权；仅安装或研究绝不意味着获准交易。
在重新发送前核对先前提交的交易哈希，并避免编造铸造 ID 或根据醒目的 APR 宣称盈利。

name: uniswap-v3-liquidity description: "Use when managing a Uniswap v3 NFT position: choose usable ticks, mint or increase liquidity, collect fees, remove liquidity, or move a range. Resolves position inventory and fee accounting with exact manager calls; excludes v4 and gauge custody." license: MIT
compatibility: "Read-only EVM RPC and official protocol APIs or UI. Optional Node.js 20 for offline helpers. No signer included."