Locker Protocol Agentic

Locker Protocol Agentic

您的私钥无处可寻：不在我们的服务器上，不在 Agent 的机器上，也不在任何人手里。

Agent 负责交易，不持有任何资产。

• **密钥在哪里：**账户的私钥留在 Locker Vault 中，这是手机或平板上的离线应用。此电脑只保存 Agent 密钥，并用密码加密封存；该密钥会自行过期（默认 6 个月，这是 Hyperliquid 允许的最长时限）。
• **谁可以提现：**只有 Vault 可以通过二维码提现，由人扫描并签名。Hyperliquid 会拒绝 Agent 密钥发起的每笔提现和转账；它唯一接受的资金操作，是用该密钥向 Hyperliquid Vault 存入资金，而 lpa 从不为此签名（在主网上测得，2026-09-28）。
• **数据发往何处：**订单和读取请求发往 Hyperliquid，存款和余额请求发往 Arbitrum 节点；除非您主动启用其他连接（列表见下文），不会发送到其他地方。没有我们的服务器、没有账户，也没有遥测数据。

文档：doc.lockerprotocol.com/agent-wallet：安装、分步设置、交易方式和所有命令。网站：hyperagentictrader.com。

Locker Protocol Agentic 是用于 Hyperliquid 永续合约的 Agent 钱包：面向用户和 AI Agent 的 lpa 命令、一个 MCP 服务，以及两个 SDK 包。它提供一个基于真实订单簿的模拟账户、每笔订单发出前都会检查的本地策略，以及由手机签名的每笔资金操作。

本仓库是其主页：包含文档、更新日志、附有每个 tarball 的 SHA-256 值的发布记录，以及问题跟踪器。四个 npm 包的 repository 字段均指向此处。源代码未公开。

工作原理

三个位置，一条规则：拥有资金的密钥永远不会离开手机。

  PHONE (offline)              THIS COMPUTER                              HYPERLIQUID
 +--------------------+      +-----------------------------------+      +----------------+
 | Locker Vault       |      | lpa   <- you, a script, or an AI  |      |                |
 |                    |      |  |       agent (shell or MCP)     |      |  order book    |
 | holds the ACCOUNT  |      |  |                                |      |                |
 | key; it never      |  QR  |  |  1. quote on the live book     |      |  your account  |
 | leaves the phone   |<---->|  |  2. local policy               |      |                |
 |                    |codes |  |  3. your go                    |      |                |
 | signs: the agent's |      |  v                                |      |                |
 | approval, deposits,|      | guardian (background process)     |      |                |
 | withdrawals, dex   |      |   holds the AGENT key in memory,  |----->|  orders,       |
 | transfers, revoke  |      |   checks the policy again, signs  |      |  cancels,      |
 +--------------------+      |   trading actions only            |      |  leverage,     |
                             +-----------------------------------+      |  TP/SL         |
                                                                        +----------------+

• Locker Vault 是一款在手机或平板上运行、保持离线的应用。它保存账户密钥并通过二维码签名：电脑显示请求，手机摄像头读取请求，用户在手机上查看操作内容并签名，手机显示签名，电脑摄像头再读取签名。
• Agent 密钥由电脑上的 lpa init 创建，经 Vault 一次性批准后，用密码加密封存在磁盘上。Hyperliquid 允许它交易，但会拒绝它发起的每笔提现和转账。该密钥会自行过期。
• 守护进程是由 lpa unlock 启动的后台进程。它将 Agent 密钥保存在内存中，再次检查每笔订单是否符合策略；您在手机上签署授权书后，它还会检查订单是否符合授权书，并且只会为明确列出的交易操作签名。它只响应携带自身启动时写入的令牌的请求，插件无法读取该令牌。调用 lpa 的 Agent 永远看不到密码或密钥。

内容	签名方	位置
市场、报价、仓位、余额	无人	公开读取
模拟订单	无人	在电脑上基于实时订单簿模拟
开仓、平仓、取消、修改	守护进程中的 Agent 密钥	报价、策略和您的确认通过后
批准 Agent、撤销 Agent	您的钱包：Locker Vault，或您选择的扩展程序或移动钱包	手机上的二维码流程，或您在钱包中批准的请求
存款、提现、在 DEX 之间划转保证金	您的钱包	同上
授权书：Agent 的限制，经您签名一次	您的钱包	同上
实盘副本的订单	守护进程中的 Agent 密钥	遵循策略和指定交易者的授权书
插件的命令	不会对真实账户执行任何操作	独立进程，只读取自身文件夹

账户签名的三种方式

上方的示意图采用 Locker Vault，这是最安全、也是我们推荐的方式。lpa setup 会先询问你的账户如何签名，并优先显示 Locker Vault；lpa init --with vault|browser|mobile 会用一行指定方式，而 lpa signer show 会在之后显示该方式。

方式	你需要准备	哪些内容会离开这台电脑
Locker Vault，最安全、推荐	一部或一台保持离线的手机或平板电脑上的 Locker Vault、一个网络摄像头	什么都不会：请求和响应通过二维码传递
你的浏览器扩展（MetaMask、Rabby）	扩展，以及用于打开 lpa 本地页面的浏览器	不会有更多内容：扩展会在该页面上签名
你的手机钱包	手机上的钱包：扫描一次 WalletConnect 二维码，然后在那里批准每个请求	请求会通过 WalletConnect 的中继端点进行端到端加密传输；中继端点能看到这台电脑的 IP 地址和时间

使用扩展或手机钱包时，系统会先验证账户，在涉及任何资金之前，由账户进行一次不会转移任何资产的签名；系统会在本地检查该签名，不会将其发送到任何地方。如果地址是合约，系统会拒绝。前两种方式使用联网钱包，且会以原始字段的形式显示类型化签名，因此本地页面会逐项说明钱包将显示的内容。Locker Vault 会将密钥保存在一台从不联网的设备上，并以文字显示每个请求。lpa signer use 可为同一地址更改签名方式；Agent 密钥和授权保持不变。

授权、实时跟单和插件

• 不按百分比止损。 自 2.4.0 起，无论单日还是从开始以来的亏损占比，都不会拒绝订单；权益下跌也不会停止每日自动交易。资金限制由以下因素决定：订单规模、杠杆、市场、订单和单日名义金额、风险回报比、到期时间、这台电脑上的其他限制、授权、模型预算、连续亏损后的暂停时间，以及各策略为自身设定的止损。
• 授权是由你的钱包一次性签署的 Agent 限制：策略限制、每日开仓名义金额上限、费用接收方，以及密钥允许用于哪些用途。Locker Vault 会将每项限制单独列出。自 2.4.0 起，授权在其 EIP-712 域版本 2 下包含十五个字段；在 2.4.0 之前签署的授权会被整体拒绝（MANDATE_OUTDATED），直到你使用 lpa mandate sign 重新签署。守护程序会在每次开仓前检查授权，绝不会让授权放宽本地策略。该文件夹会记录已签署授权的最高版本及撤销状态，因此文件被删除、旧版本被放回或授权已撤销时，无论此守护程序还是之后运行的守护程序，都不会开仓；lpa mandate revoke 会阻止所有开仓，直到你签署新授权；lpa mandate release（需输入密码）则会恢复为仅使用本地策略。
• 实时跟单（lpa copy start --live）会在真实账户上跟随一名交易者。它需要你解锁守护程序，并且授权中列明该交易者，且跟单预算有足够余量。每笔订单都会像你的订单一样经过策略和授权检查，并由 Agent 密钥签名，绝不会使用账户密钥签名。守护程序无法执行的减仓会保留并重试，绝不会丢失；只要跟单仓位仍然开着，跟单预算就会持续计入；绝不会跟单你自己的账户。默认仍为模拟模式。
• 插件会添加命令和 MCP 工具。插件会在独立的 Node 进程中运行，该进程只能读取自己的文件夹：无法读取你的密钥、设置或守护程序令牌。它确实能知道你的用户名、电脑名称和网络地址，安装界面会说明这一点。插件只能通过其声明并经你批准的能力访问你的钱包，而这些能力都不能为真实账户签名。安装时会为插件文件生成指纹，插件一旦发生更改就不会运行。

Agent 密钥能做什么，不能做什么

2026-09-28 在 Hyperliquid 主网上使用获批的 Agent 密钥进行测试：

操作	Agent 密钥签署的结果
下单、修改和取消订单，设置杠杆	接受
withdraw3、usdSend、spotSend、sendAsset、usdClassTransfer	拒绝
approveAgent（批准另一个 Agent）、approveBuilderFee	拒绝
vaultTransfer（将账户存入金库）	接受

被盗的 Agent 密钥无法提现，但可能导致资金损失：可以在流动性低的市场上与同伙对敲，也可以将账户存入他人运营的金库。lpa 绝不会签署 vaultTransfer（其 guardian 只会签署一个封闭列表中的交易操作），但窃贼若同时拥有密钥和密码，就不需要 lpa。真正的保障在于使用专用账户，只存入你愿意承担风险的资金。

关于这一点与其他 Agent 钱包的比较，逐条引用、逐个来源列于：COMPARISON.md。

四个软件包

每个软件包在 npm 上的页面都是完整参考文档：先介绍工作原理，再列出每个命令、工具或函数及其示例。

软件包	内容	参考文档
@locker-protocol/agent-wallet-hyperliquid-trader	lpa 命令：用于 Hyperliquid 永续合约的 Agent 钱包，密钥离线保存在 Locker Vault 中。也可作为库使用。	npm
@locker-protocol/agent-wallet-hyperliquid-trader-mcp	MCP 服务：通过 stdio 提供与命令相同的 42 个工具，以及你安装的插件中的工具，适用于 Claude Code、Cursor、Codex 和任何 MCP 客户端。	npm
@locker-protocol/agent-wallet-hyperliquid-signer	为密钥保存在 Locker Vault 中的程序提供 Hyperliquid 签名、订单、账户读取和实时数据功能。支持 ESM 和 CommonJS，并附带类型定义。	npm
@locker-protocol/agent-wallet-vault	Locker Vault 的编解码器：将签名请求和签名编码为 QR 码，并同步账户。支持 ESM 和 CommonJS，并附带类型定义。	npm

四个软件包的版本同步更新，每次发布使用同一个版本。钱包和 MCP 服务需要 Node 22.13 或更高版本；两个 SDK 则可在任何 Node 22 版本上运行。

各组件的安装位置：单行安装程序会将 lpa 和 MCP 服务安装到 ~/.lpa，使用同一份软件包副本，并提供两个启动器 lpa 和 locker-mcp，确保两者始终运行相同版本。npm install -g 只会安装 lpa；MCP 客户端随后可以通过 npx 获取 @latest，也就是每次启动时获取最新版本：发布新版本后，重新运行安装程序，让 lpa 同步更新。无论采用哪种方式，两者都会共用 ~/.lpa 文件夹和 guardian；guardian 不会为其他版本的程序签名。

安装

npm install -g @locker-protocol/agent-wallet-hyperliquid-trader@latest

也可以使用单行安装程序；如果缺少 Node，它会自动获取，并将所有内容安装到 ~/.lpa，无需管理员权限。

在 macOS 和 Linux 上：

curl -fsSL https://hyperagentictrader.com/agent-wallet-install.sh | sh

在 Windows 上（PowerShell）：

irm https://hyperagentictrader.com/agent-wallet-install.ps1 | iex

从模拟开始

模拟账户会在 Hyperliquid 的真实订单簿上成交，并收取真实费用，无需密钥或金库。以下交易规模适用于默认策略（每笔订单 $100，杠杆 3）：

lpa paper init --budget 1000
lpa perps quote --symbol ETH --side long --size 0.03 --leverage 3
lpa perps open  --symbol ETH --side long --size 0.03 --leverage 3 --paper
lpa paper status
lpa perps close --symbol ETH --paper

在终端中，open 和 close 会显示报价并在成交前询问确认；如果没有终端（例如脚本或 Agent），在用户同意后添加 --yes 即可。

使用 Locker Vault 设置

lpa setup
lpa init
lpa init --with browser
lpa init --with mobile

lpa setup 会逐步引导你完成整个流程；lpa init 只设置账户及其交易密钥，默认使用 Locker Vault，除非通过 --with 指定扩展或移动钱包。使用 Locker Vault 时，终端会在这台电脑上打开一个本地页面。手机上的 Locker Vault 会将账户显示为二维码，页面通过网络摄像头读取二维码，然后将新 Agent 密钥的审批请求显示为二维码，供手机签署。Agent 密钥会在此处创建并加密封存，密码由你在终端中输入，然后再由手机签署。账户密钥始终留在手机上。

然后，lpa unlock 会启动 guardian，这是一个在内存中持有 Agent 密钥并签署订单的后台进程；Agent 无法看到密钥或密码。lpa lock 会将密钥从内存中移除。

所有命令

单独运行 lpa 会打开一个交互会话，其中包含与 / 命令相同的命令、实时市场视图，以及一个使用你所选模型的助手。每条命令都以文本形式响应，也可以使用 --json 获取 JSON；拒绝请求时会附带稳定代码及后续操作说明。标志和各自的示例见参考文档。

类别	命令
设置	lpa setup、lpa init、lpa unlock、lpa lock、lpa status、lpa doctor
账户如何签名	lpa signer show、lpa signer use vault、lpa signer use browser、lpa signer use mobile、lpa signer forget
多个账户，每个账户一个配置文件	lpa profile list、add、use、rename、remove；任何命令都可使用 --profile <name>
市场数据	lpa perps venues、lpa perps markets、lpa perps quote、lpa perps regime、lpa perps ranges
账户查询	lpa perps positions、lpa perps balance、lpa perps portfolio、lpa perps orders、lpa perps fills、lpa perps funding、lpa perps fees、lpa perps ledger、lpa wallet address、lpa wallet balances
订单	lpa perps check、lpa perps open、lpa perps close、lpa perps cancel、lpa perps modify；quote、check 和 open 可使用 --tif、--reduce-only 和 --margin
资金，由你的钱包签名	lpa perps deposit、lpa perps withdraw、lpa perps transfer、lpa agent revoke
模拟	lpa paper init、lpa paper status、lpa paper on、lpa paper off、lpa paper record、lpa paper replay
策略和日志	lpa policy show、lpa policy set、lpa journal、lpa journal export
授权，由你的钱包签名	lpa mandate sign、lpa mandate show、lpa mandate revoke、lpa mandate release（你的密码）
跟单，模拟或实盘	lpa copy start、lpa copy stop、lpa copy status、lpa copy resume
每日 Pilot	lpa pilot status、lpa pilot schedule、lpa pilot strategy list、lpa pilot strategy show、lpa pilot model-down、lpa pilot plans、lpa pilot day、lpa pilot end-grid、lpa pilot end-range，以及参考文档中的其他命令
发送到手机的通知，默认关闭	lpa notices、on、off、test
插件	lpa plugins install、list、inspect、remove、disable、enable；之后运行 lpa <plugin> <command>
助手使用的服务，在这台电脑上运行	lpa mcp status、off、on、forget
hyperkeel（可选）	lpa hyperkeel login、status、logout、brief、leaders、follows、follow、unfollow、alerts、off、on
设置	lpa config
服务	lpa service install、status、logs、start、stop、restart、uninstall；lpa console、lpa console password
清理	lpa reset、lpa uninstall

MCP 服务

Claude Code：

claude mcp add locker -- npx -y --ignore-scripts @locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）和 Antigravity（mcp_config.json）：

{
  "mcpServers": {
    "locker": { "command": "npx", "args": ["-y", "--ignore-scripts", "@locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest"] }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.locker]
command = "npx"
args = ["-y", "--ignore-scripts", "@locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest"]

其他任何 MCP 客户端：命令 npx -y --ignore-scripts @locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest，传输方式为 stdio。Node 22.13 或更高版本。它在官方 MCP Registry 中的名称是 io.github.locker-protocol/agentic。

通过单行安装程序安装 lpa 后，将客户端指向它的启动器；启动器始终使用 lpa 的版本：claude mcp add locker -- ~/.lpa/bin/locker-mcp。

每个工具、参数及调用示例：请参阅 MCP 参考。下单时会先生成报价，再使用该报价的 quote_id 确认；资金转移会回答用户在自己终端中输入的那一行内容。

技能和示例

仓库	内容
locker-protocol/agent-skills	教会 AI Agent 使用 lpa 和 MCP 服务的技能，打包为适用于六种宿主的插件，并包含会话启动钩子和评测。
locker-protocol/agentic-examples	可复制使用的操作方案，默认启用模拟模式。

文档

页面	内容
docs/security-model.md	模型永远看不到的内容、在主网上测得的硬性限制、本地策略和风险回报防护，以及策略无法防范的情况。
docs/network.md	lpa 会连接的所有主机，以及连接时机。
docs/strategies.md	每日试点中的策略：四种类型、已提供的十八种策略，以及用于读取、选择、写入和测量策略的命令。
docs/parity-metamask.md	与 MetaMask Agent Wallet 的命令逐项对照。
COMPARISON.md	每项声明各占一行，包含 URL、引文和最后核查日期。
CHANGELOG.md	各版本新增、更改和修复的内容。
RELEASES.md	每个已发布 tarball 的 SHA-256 值，以及自行检查的方法。

网络

lpa 会连接的主机及连接时机：

主机	时机
api.hyperliquid.xyz（HTTPS 和 WebSocket）	市场、报价、订单、账户读取、实时视图
arb1.arbitrum.io、arbitrum-one-rpc.publicnode.com、arbitrum.drpc.org	Arbitrum 余额和存款，使用第一个响应的节点
api.hyperkeel.com	每日试点的档案和 MCP 服务的简报，通过 hyperkeel 面向 Agent 的公开路由获取，无需任何连接；其余内容仅在通过 lpa hyperkeel login 登录后、处于连接状态时获取；通知仅在通过 lpa notices on 开启后获取（通知类型以及最多一个整数，绝不包含账户金额）
api.anthropic.com、api.openai.com、generativelanguage.googleapis.com、openrouter.ai	仅连接你选择的助手提供商（如果有）；本地模型（LM Studio、Ollama）或你自己的地址则留在你指定的位置
nfs.faireconomy.media、api.alternative.me、www.federalreserve.gov、www.ecb.europa.eu、www.coindesk.com	仅供每日试点使用，每天构建档案时读取一次：无需密钥、账户、你的地址或持仓即可进行普通读取
relay.walletconnect.org（WebSocket）	仅当账户使用移动钱包签名时，在请求签名期间连接：请求端到端加密
127.0.0.1	自身页面（验证流程、设置、控制台）以及守护程序的本地套接字

除此之外没有其他连接：没有分析数据、崩溃报告或更新检查。你安装的插件会在自己的进程中运行，并可能自行访问网络；lpa 不会代它访问任何网络。

费用

Hyperliquid 自身的交易费用，另加每笔订单名义价值的 0.05 % 作为构建者费用，支付给 Locker。每份报价都会注明此费用，且总额会汇总在 lpa journal 中。账户在 lpa init 中批准后，此费用才会生效；否则绝不会收取：未经批准，订单会照常发出，不会因此被阻止。激活时会设置推荐码 LOCKERPROTOCOL；已有推荐人的账户会保留原推荐人。模拟账户也会计入相同费用，因此其结果与真实交易一致。

检查此代码库

node tests/check.mjs

tests/check.mjs 无需依赖项。它会检查每个相对链接是否有效、COMPARISON.md 中的每项声明是否都附有 URL、引文和最近查阅日期、是否处处使用同一版本，以及整个目录树中的内容是否都仅包含 ASCII 字符。

报告问题

在此代码库中提交 issue：github.com/locker-protocol/agentic/issues。这里有两个模板，一个用于报告 Bug，另一个用于提问。

安全问题请勿通过 issue 提交。请阅读 SECURITY.md，并发送邮件至其中提供的地址。

许可证

LOCKER PROTOCOL 专有非商业许可证。请参阅 LICENSE。