流动性管理工具

面向个人用户的 Uniswap V2/V3/V4 流动性查询与基础管理工具。Use when 用户需要liquidity-mgr-tool-free相关功能时使用。不适用于超出本技能能力范围的复杂需求。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。

天轰穿@thcjp

Install

openclaw skills install @thcjp/liquidity-mgr-tool-free

功能说明: 本技能涵盖中文交互、化工作流场景等核心能力。

流动性管理工具（免费版）

概述

本工具帮助个人用户管理 Uniswap V2/V3/V4 流动性，覆盖池子与头寸查询、单头寸添加/移除、价格区间与费率查询、收益与无常损失基础估算。适合个人单头寸管理。

核心能力

能力	说明	免费版范围
池子查询	V2/V3/V4 池子信息	只读
头寸管理	查询/添加/移除	单头寸
区间费率	V3/V4 区间与费率	查询
收益估算	费用收益与无常损失	基础
技术实现要点：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

核心功能执行

用input_params参数进行配置。

输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：面向个人用户的、Uniswap、流动性查询与基础、管理工具、面向个人用户的去、中心化交易所流动、性管理工具等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：查询头寸

bash

# 查询我的 V3 头寸
{baseDir}/scripts/liq.sh positions --version v3 --address 0xYOUR

# 查询池子信息
sh pool --version v3 --pool 0xPOOL

场景二：添加流动性

bash

# V3 集中流动性
  --version v3 \
  --token0 WETH \
  --token1 USDC \
  --fee 3000 \
  --lower 1800 \
  --upper 2200 \
  --amount0 1 \
  --amount1 2000

场景三：收益估算

python

# 无常损失基础估算
initial_ratio = 0.5  # 初始 50/50
new_ratio = 0.6      # 价格变动后
# IL = 2*sqrt(r/(1-r)) - 1 近似
import math
il = 2 * math.sqrt(new_ratio / (1-new_ratio)) - 1
print(f"无常损失近似: {il:.2%}")

不适用场景

以下场景流动性管理工具不适合处理：

3D建模和动画制作
照片级写实渲染
手绘原创插画

触发条件

需要设计创作、UI设计、海报制作、品牌视觉时使用。不适用于非本工具能力范围的需求。

快速开始

配置钱包与 RPC。
查询现有头寸与池子。
选择区间与费率添加流动性。
定期查看收益与区间。

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

V2/V3/V4 费率对照：

版本	支持费率
V2	0.3%（固定）
V3	0.01% / 0.05% / 0.3% / 1%
V4	自定义（Hook 可调）

优选实践

区间别太窄：V3 区间过窄易被套利踢出，赚不到手续费。
费率按波动选：稳定币对 0.05%，主流对 0.3%，长尾 1%。
无常损失要算：价格剧烈波动时无常损失可能吃掉手续费。
定期再平衡：V3 区间偏离需再平衡，免费版手动操作。
小额定投试：新池先小额试，熟悉再放量。

常见问题

Q1：V2 和 V3 怎么选？ A：被动持有选 V2，主动管理选 V3 集中流动性收益更高。

Q2：免费版能批量管理吗？ A：不能。批量头寸与自动再平衡为专业版能力。

Q3：无常损失能避免吗？ A：不能完全避免，区间越窄越易触发，稳定币对损失较小。

Q4：V4 的 Hook 是什么？ A：V4 通过 Hook 自定义池子逻辑（动态费率、限价单等）。

Q5：移除流动性要 gas 吗？ A：要。所有链上操作都需 gas，建议低 gas 时段操作。

进阶用法

V3 区间选择策略

text

区间选择原则:
  全范围:   收益低但永不踢出，适合被动持有
  宽区间:   ±30% 价格范围，平衡收益与稳定
  窄区间:   ±10% 价格范围，收益高但易被踢出

选择依据:
  - 高波动对: 选宽区间，避免频繁再平衡
  - 稳定币对: 选窄区间，收益最大化
  - 看不懂走势: 选全范围，被动持有

无常损失详解

python

# 无常损失精确计算
import math

def impermanent_loss(price_ratio):
    """price_ratio = 新价格/旧价格"""
    r = price_ratio
    il = 2 * math.sqrt(r) / (1 + r) - 1
    return il

# 价格涨 2 倍
print(f"IL: {impermanent_loss(2):.2%}")   # IL: -5.72%
# 价格涨 4 倍
print(f"IL: {impermanent_loss(4):.2%}")   # IL: -20.00%

text

关键结论:
  - 价格变动越大，无常损失越大
  - 无常损失是「相对持有可能」，不是绝对亏损
  - 手续费收入需覆盖无常损失才盈利

头寸监控

bash

# 查询头寸详情
sh position --id 12345

# 查看收益
sh earnings --id 12345

# 检查区间偏离
sh deviation --id 12345

V2/V3/V4 对比

特性	V2	V3	V4
流动性	均匀分布	集中区间	集中+Hook
费率	固定 0.3%	多档可选	自定义
再平衡	不需要	手动	可自动
复杂度	低	中	高
适合	被动持有	主动管理	高级策略

风险提示

无常损失：价格剧烈波动时无常损失可能吃掉手续费。
区间被踢：V3 窄区间价格超出即停止赚手续费。
智能合约风险：协议漏洞可能导致资金损失。
gas 成本：频繁操作消耗 gas，需计入成本。
价格风险：积分本身价格下跌是最大风险。

依赖说明

运行环境

Agent 平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
操作系统: Windows / macOS / Linux
网络: 可访问以太坊/L2 RPC

依赖详情

依赖项	类型	是否必需	获取方式
Node.js	运行时	必需	nodejs.org
ethers.js	链交互	必需	`npm install ethers`
EVM 钱包	签名	必需	MetaMask 等
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

RPC_URL：以太坊/L2 节点 RPC 地址（Alchemy/Infura 等）
钱包密钥仅本地签名，不上传
建议密钥存环境变量或权限 0600 配置文件

可用性分类

分类: MD+EXEC（Markdown 指令 + 命令行执行）
说明: 通过自然语言指令驱动 Agent 调用合约管理流动性

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

需LLM支持,无LLM环境不可用
复杂业务场景建议结合人工经验判断
执行效率受模型能力与网络环境影响
当前为免费版本,如需完整功能请升级到付费版获取全部能力