Uniswap Swap

安装指南

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

什么是

Uniswap Swap 是一份操作指南，用于获取代币交易报价、审查授权、准备未签名交易交接，以及处理已提交的兑换或已签名订单。它使用官方 Uniswap Trading API 或经验证的官方界面，区分 CLASSIC AMM 交易与 UniswapX 路径，并保留精确的原始金额和特定路径的生命周期详情。
此 skill 旨在让 Openclaw Skills 工作流在涉及金融操作时更加谨慎且可审计。它不包含签名器：无需连接钱包即可解读报价，但可执行的报价需要实际的 swapper 地址，任何交易或订单签名都需要明确的钱包授权。

应用场景

比较针对指定链、代币对、金额和兑换意图的公开 Uniswap 报价。
准备精确输入或精确输出报价，同时显示正确的最小输出或最大输入。
在执行工作流前审查 ERC-20 allowance 和 Permit2 授权详情。
在经授权的钱包发送 CLASSIC 交易交接前进行检查。
按照 UniswapX 路径有文档记录的订单流程处理订单，而不是使用 AMM 兑换流程。
核对已提交的 AMM 交易，或查询订单的成交、到期和取消状态。
调查 RPC 超时，避免盲目提交重复交易或签署另一笔订单。

工作原理

收集链 ID、精确的代币合约地址、原始整数金额、精确输入或精确输出意图、swapper、收款方意图、滑点，以及到期或成本限制。
在所选链上检查代币小数位；不要仅凭符号识别资产。通过用户现有的密钥管理机制获取 API key，或在没有可用密钥时使用官方界面。
使用始终固定且受支持的 x-universal-router-version 请求报价。解读返回的路由判别项、报价 ID、金额、gas、收款方、链、代币身份、报价时间和任何 txFailureReason；保留返回的报价 JSON。
针对实际钱包、代币、链和所需金额检查授权。区分对 Permit2 的 ERC-20 allowance 与对已签名 Permit2 消息的授权，并检查每笔授权交易的目标、spender、代币、上限和链。
遵循特定路径的生命周期：对于 CLASSIC 路径，使用保留的报价以及需要时匹配的 permit 数据调用 /swap；对于 UniswapX 路径，使用有文档记录的 /order 流程。绝不可用一种路径的流程替代另一种。
在任何经授权的钱包发送交易或签署订单之前，检查相关链、收款方、金额、合约详情、限制和授权。适当时模拟返回的 AMM 交易；此 skill 本身不会签名或发送。
对 AMM 兑换，使用交易回执和账户余额变化核对结果；对 UniswapX，使用有文档记录的订单标识符和链上成交进行核对。发送后遇到 RPC 超时，应视为提交状态未知，并检查原始哈希或 nonce。

配置指南

此 skill 不提供签名器，也不要求自动安装。对于应用集成，如果 uniswap/uniswap-ai 中的官方 swap-integration skill 已经可用，请发现并使用它；本操作指南补充该集成接口，但不取代其交易构造器。
使用官方 Trading API 或经验证的官方界面。具体 API 调用和来源请参阅 references/recipes.md。
通过用户现有的密钥管理机制获取任何 API key。绝不可打印密钥。若密钥不可用，请使用已连接的官方工具或 UI，或者提供标记为未查询的完整请求；不要捏造报价。
提供所需的链、精确代币地址、原始金额、兑换意图、swapper、收款方意图、滑点，以及到期或成本界限。在所选链上查询代币小数位。
在整个报价和交接生命周期中始终固定同一个受支持的 x-universal-router-version。只请求用户接受的协议；对于仅限 AMM 的任务，只有在获得批准时才使用受支持的 V2、V3 和 V4 集合。
在准备金融操作前重新核对 API 架构和协议部署。报价端点成功并不能证明已获授权、具备支付能力或已提交交易。
此 skill 未指定任何软件包安装命令。可选的离线辅助工具需要 Node.js 20；RPC 访问为只读，执行操作需要另行授权的钱包。

数据架构

此 skill 会保留使交接可追溯所需的报价和授权上下文。它不规定本地数据库或生成文件格式。
数据组 关键字段与处理方式
请求 链 ID、输入/输出代币地址、原始整数金额、精确输入或精确输出意图、swapper、收款方意图、滑点，以及到期或成本界限。
报价 原始报价 JSON、路由判别项、quoteId、报价输入/输出、最小输出或最大输入、gas、txFailureReason、收款方、链、代币身份和报价时间。
授权 钱包、代币、链、所需金额，以及返回的撤销或授权交易详情：目标、spender、原始上限和链。
Permit2 Permit 域链和验证合约、代币、spender、金额、nonce、截止时间，以及与特定报价的关联。不要在报告中公开签名，也不要在刷新报价后重复使用授权。
CLASSIC 结果 已提交的交易哈希、回执状态和区块、输入扣款、预期收款方收到的输出、已支付的 gas，以及任何未花完的输入或退款。根据实际代币地址和账户余额变化核实代币转账日志。
UniswapX 订单 有文档记录的订单标识符、路径类型、成交、剩余授权、到期时间和取消状态。仅凭报价过期不能证明已签名订单已取消。
代币、收款方、链、路径、报价或限制发生变化时，先前的交接即失效。应刷新并重新检查，而不是悄悄放宽滑点。计算账户余额变化时要考虑无关的并发转账。

高级特性

将 CLASSIC AMM 交易构造与 UniswapX 订单签名和跟踪分开处理，包括
DUTCH_V2
、
DUTCH_V3
PRIORITY
等路径。
将 Permit2 数据视为特定报价的授权，并检查域、验证合约、代币、spender、金额、nonce 和截止时间。
支持经批准的协议范围缩减，以及在整个报价生命周期中始终固定路由器版本。
保留返回的报价 JSON，并区分报价成功与授权、支付能力、模拟和提交状态。
使用回执、代币日志、预期收款方输出、gas 和退款核对 AMM 结果；同时处理无关的并发转账。
将含糊的发送超时视为提交状态未知，通过检查原始哈希或 nonce 处理，而不是重复发送。
跟踪订单成交、剩余授权、到期和取消；不把订单接受视为已上链成交，也不使用另一笔可能成交的订单重试。
提供合成的精确输入示例，并提醒不要将此 API 的百分比滑点约定与 LI.FI 的分数约定混淆。

name: uniswap-swap description: "Use when quoting or preparing a Uniswap token swap, reviewing Permit2 authorization, choosing an AMM versus UniswapX path, or reconciling a submitted swap. Uses the official Trading API with exact raw amounts and route-specific lifecycle handling." license: MIT
compatibility: "Read-only EVM RPC and official protocol APIs or UI. Optional Node.js 20 for offline helpers. No signer included."