etemaro：AI Agent 工具实践指南

面对实际交付，我看etemaro的重点不在星标，而在这项能力：自动 dlmm Meteora 机器人系统， romankurnovskii/etemaro。从硬件与仿真开发的使用方式看，接口、单位、环境差异和真实设备风险难以靠示例覆盖是采用前必须回答的问题。落地前可以先在仿真或备用硬件上跑最小闭环，用接口约束、参数单位、异常保护和复现实验记录判断它是否真的省事。它更像给能提供测试环境并理解硬件边界的工程师准备的可审查方案，是否长期使用应由试跑数据决定。

埃特马罗

一个由 LLM- 支持的代理，可自主管理 Solana 的 Meteora DLMM 上的流动性头寸。

etemaro 运行连续的筛选和管理周期，将资金部署到高质量的 Meteora DLMM 池中，并根据实时 PnL、收益率和范围数据平仓——所有这些都是由 LLM 对真实链上状态的推理驱动，而不是遵循固定的规则集。

特点

• LLM- 驱动的 ReAct 循环 — 代理检查实时池和头寸数据、风险和收益原因，然后调用工具来部署、管理或平仓。
• HiveMind 集体学习 - 代理在整个队列相关组织享经验教训和绩效事件，因此每个实例都可以从其他实例中学到的知识中受益。
• 试运行安全模拟 — 针对真实链上数据测试策略，无需消耗 Gas；模拟位置在本地进行跟踪。
• 多表面界面 — 用于一次性命令的 CLI、用于远程控制的 TG 平台 机器人以及跨平台桌面应用程序。
• 策略库+信号适配 — 预设LP策略，可配置bin分布；信号权重根据平仓表现而变化。

架构一览

flowchart LR
    subgraph T["Telemetry"]
        RPC["Solana RPC
(blockhash, balances)"]
        DATAPI["Meteora Datapi
(positions, PnL, fees)"]
        JUP["Jupiter Price API
(token valuation)"]
    end

    subgraph M["Market Ingestion"]
        DISC["Pool Discovery API"]
        FILTER["Hard filters + 0–100 scoring"]
        RESEARCH["Token research
(holders, narrative, smart wallets, LP study)"]
    end

    subgraph D["Agent Decision Logic"]
        REACT["LLM ReAct loop
agent-loop.ts"]
        TOOLS["Tool definitions + executor
(safety checks)"]
    end

    subgraph E["Execution / RPC"]
        DLMM["Meteora DLMM SDK
(deploy / claim / close)"]
        SWAP["Jupiter Swap
(base → SOL)"]
        STATE["State & decision logs
(state.json, decision-log.json)"]
    end

    T --> M --> D --> E
    E -->|"open positions / PnL"| DATAPI

更深入的细节：docs/ARCHITECTURE.md（域边界、适配器、状态）和docs/FULL_FLOW.md（规范的 screening/management 流）。

运行代理

需要 Node.js 22+。然后是两条命令：

curl -fsSL https://etemaro.com/install.sh | sh
etemaro init

etemaro init 是首次设置（约 1 分钟）。它创建 ~/.config/etemaro，检查资产账户密钥和 LLM 密钥，并告诉您缺少什么。仅在稍后进行实时交换时才需要木星。

添加资产账户

资产账户位于 ~/.config/etemaro/.credentials/wallets/<alias>.json 的密钥库中（模式 0600）：

etemaro wallet generate --name etemaro-01-100          # brand-new keypair
etemaro wallet import --name etemaro-01-100 --prompt   # existing Base58 key (hidden prompt)

不需要标志：只需运行 etemaro wallet import，它就会引导您完成别名 → 密钥对 JSON 文件或 Base58 私钥 → 导入。

然后将代理指向其配置中的别名："wallet": "etemaro-01-100"（config/agent-config.json 或 config/instances/<id>.json）。用 etemaro wallet list 检查。

来自源克隆（无全局 etemaro），前缀为 npm run cli -- — 需要 --：

npm run cli -- wallet generate --name etemaro-01-100
npm run cli -- wallet import --name etemaro-01-100 --prompt

如果没有 --，npm 会使用 --name/--prompt 作为自己的标志，并使用 Unknown cli flag 产生错误。

当清单为绿色时：

etemaro start --dry-run

实时模式（真实交易）：添加JUPITER_API_KEY，然后添加etemaro start。

或通过 npm install -g @etemaro/cli / brew install romankurnovskii/awesome-brew/etemaro. 安装

交互式仪表板和实时聊天 ( etemaro attach )

要使用实时终端 UI 监控代理、流式传输实时日志并用简单的英语与其聊天：

1. 启动代理（在后台或通过 PM2）：

   etemaro start --dry-run
   # or with PM2 (24/7 background):
   pnpm run pm2:start
   

2. 附上交互式CLI：

   etemaro attach
   # or from source:
   pnpm run attach
   

交互式终端仪表板内部：

• 状态和 PnL — 实时资产账户余额、未平仓 DLMM 仓位、24 小时 PnL 和下一个 screening/management 倒计时器。
• 日志流 — 颜色编码的实时日志流，没有标准输出抓取或文件拖尾。
• 代理聊天 — 在底部提示处键入说明或问题（what pools are you watching?、run screen、why did you close position 1?）。
• 分离 — 按 Ctrl+C 随时分离；交易守护进程继续在后台运行。

常见问题：docs/QA.md。

浏览器 UI ( etemaro serve )

更喜欢浏览器而不是终端？无头启动代理并打开内置控制台：

etemaro serve --open      # http://127.0.0.1:8765/

• 仪表板 — 实时位置、PnL 和循环计时器。
• 工具 — 运行任何代理工具（与 LLM 使用的目录相同）；状态改变工具需要明确的确认。
• 日志/聊天/代理 — 流式传输日志、与代理聊天以及监控多个代理端点。

UI 由 IPC 端口上的守护进程本身提供服务（无额外进程）； etemaro attach 与浏览器共享相同的协议。请参见 apps/web/README.md。

桌面应用程序 (GUI)

• macOS（通过 Homebrew）：

  brew tap romankurnovskii/awesome-brew
  brew trust --cask romankurnovskii/awesome-brew/etemaro
  brew install romankurnovskii/awesome-brew/etemaro --cask
  

• Windows / Linux / macOS（直接下载）： 从 GitHub 版本 下载最新的安装程序或捆绑包。

开发人员/源设置

# 1. Clone repo & install dependencies
git clone https://github.com/romankurnovskii/etemaro
cd etemaro
pnpm install

# 2.初始化配置（.env和agent-config.json）
pnpm cli init

# 3. Start in dry-run mode
pnpm run dev

# 或在实时模式下使用默认代理策略配置
pnpm run start

# run with custom strategy config
npm run start -- --config config/instances/your-config.json

服务器

VPS 上的两个命令相同。使用 tmux、systemd 保持进程运行，或者：

nohup etemaro start --dry-run >> ~/.config/etemaro/data/agent.out 2>&1 &

克隆 + PM2 / Docker 是上面的 源设置。

文档和指南

• ❓ 问答 / FAQ 指南 — 常见问题，涵盖设置、多实例部署、试运行、智能资产账户和 PnL 指标（此处涵盖了大多数用户问题）。
• 入门指南 — 分步首次设置、环境变量、策略选择。
• 使用指南 — 日常操作、CLI 命令、TG 平台 机器人控件、REPL 和决策流程。
• 架构指南 — 系统布局、域边界、适配器层和状态管理。
• 性能和可靠性 — 延迟预算、RPC/cost 占用空间、内存和容错机制。
• ⚙ 配置参考 — agent-config.json 的详尽配置参考。
• HiveMind 指南 — 舰队学习、课程共享和共享预设。
• 桌面应用程序 — 基于 Tauri 的跨平台桌面 UI。