KryptoGO Meme Trader Agent Skill
关闭通知 — kg-xyz 分析后端
KryptoGO XYZ 分析后端 (
wallet-data.kryptogo.app) 将于 2026-05-04 停止服务。此后，所有依赖聚类分析、钱包标签、信号仪表盘以及 DCA/限价单重建的工具将无法使用。交易执行路径（OKX DEX 聚合器 + 本地交易签名）独立于 kg-xyz 后端，将继续正常工作。
每个工具的影响已在下方内联标注。脚本和 MCP 工具实现已保留，以便它们优雅地失败（后端将返回 HTTP 错误），并在计划变更时轻松恢复。
概述
此技能使 AI 代理能够通过 KryptoGO 平台分析和交易 Meme 币，将深度链上聚类分析与交易执行相结合。
从 2026-05-04 开始功能降级： 当 kg-xyz 后端关闭时，聚类分析、钱包/代币标签、信号仪表盘、DCA/限价单重建以及投资组合盈亏增强将停止工作。交易执行继续有效。
分析（多链：Solana、BSC、Base、Monad）：钱包聚类、累积/分布检测、地址行为标签、全网累积信号（Pro/Alpha 层级）。
交易（仅限 Solana）：带盈亏追踪的投资组合监控、通过 DEX 聚合器交易执行、本地交易签名（私钥永不离机）。
默认模式为监督模式——所有交易需要用户确认。可选自动交易。有关自动模式、定时任务设置和学习系统的详细信息，请参阅 references/autonomous-trading.md。
使用时机
- 用户要求分析 Solana/BSC/Base/Monad 上的 Meme 币或代币
- 用户要求交易、买入或卖出代币
- 用户要求扫描热门代币或市场机会
- 用户要求监控投资组合仓位或检查盈亏
- 定时触发的定期投资组合监控和信号扫描
禁止使用场景
- BTC/ETH/主要 L1 宏观分析、NFT、跨链桥接、非 DEX 交易、非 Solana 交易
设置流程
1. 获取 API 密钥
-
访问 kryptogo.xyz/account 并创建 API 密钥
-
添加到
~/.openclaw/workspace/.env：echo 'KRYPTOGO_API_KEY=sk_live_YOUR_KEY' >> ~/.openclaw/workspace/.env && chmod 600 ~/.openclaw/workspace/.env
不要直接在聊天中粘贴您的 API 密钥。 始终通过
.env文件设置密钥。
2. 生成代理钱包
python3 scripts/setup.py
创建 Solana 密钥对，保存到 .env（权限设为 600），并打印用于充值的公钥地址。
3. 充值钱包
向代理的公钥地址发送 SOL（最少 0.1 SOL）。
安全规则
- 绝不在消息或 CLI 参数中打印、记录或包含私钥
- 绝不接受直接粘贴在聊天中的密钥——指导用户在
.env中设置 - 绝不使用读取工具读取
.env——仅通过source命令加载凭证 - 运行时脚本不直接读取
.env——所有凭证仅通过环境变量访问，必须由调用者预先加载（source ~/.openclaw/workspace/.env） - 例外：
scripts/setup.py读取和写入.env用于初始密钥对生成和地址修复——这是唯一接触凭证文件的脚本 - 私钥仅在本地签名期间保留在内存中——从不发送到任何服务器
身份验证
所有端点需要：Authorization: Bearer sk_live_<48 个十六进制字符>
| 层级 | 每日 API 调用次数 | 交易手续费 | 信号仪表盘 | KOL 查找器 |
|---|---|---|---|---|
| 免费 | 100 次/天 | 1% | 否 | 否 |
| Pro | 1,000 次/天 | 0.5% | 是 | 是 |
| Alpha | 5,000 次/天 | 0% | 是 | 是 |
代理行为
会话初始化
每次会话启动（包括心跳/定时任务）时，代理必须先加载凭证，然后再运行任何脚本：
source ~/.openclaw/workspace/.env
这是必需的——脚本不直接读取 .env。所有凭证仅通过环境变量访问。
默认模式：监督模式
默认情况下，代理以监督模式运行：它分析代币，给出建议，并等待用户批准后才执行任何交易。止损/止盈条件会报告给用户，但不会自动执行。
要启用自动交易，请将 require_trade_confirmation 设置为 false。有关完整详情，请参阅 references/autonomous-trading.md。
持久化（关键）
提交交易后立即，代理必须：
- 将交易详情写入
memory/trading-journal.json，状态为"OPEN" - 包括：
token_symbol、token_address、entry_price、position_size_sol、tx_hash、timestamp
用户偏好
存储在 memory/trading-preferences.json 中：
| 偏好 | 默认值 | 描述 |
|---|---|---|
max_position_size | 0.1 SOL | 每笔交易最大 SOL 数量 |
max_open_positions | 5 | 最大并发持仓数量 |
max_daily_trades | 20 | 每日最大交易次数 |
stop_loss_pct | 30% | 亏损超过此值时通知/卖出 |
take_profit_pct | 100% | 盈利超过此值时通知/卖出 |
min_market_cap | $500K | 跳过低于此市值的代币 |
scan_count | 10 | 每次扫描的热门代币数量 |
risk_tolerance | "conservative" | "conservative"（跳过中等风险）、"moderate"（中等风险询问）、"aggressive"（中等风险自动交易） |
require_trade_confirmation | true | 设为 false 以启用自动模式 |
chains | ["solana"] | 要扫描的链 |
安全护栏
交易限制（硬上限）
| 限制 | 默认值 | 可覆盖？ |
|---|---|---|
| 单笔最大交易 | 0.1 SOL | 是，通过 max_position_size |
| 最大并发持仓 | 5 | 是，通过 max_open_positions |
| 每日最大交易次数 | 20 | 是，通过 max_daily_trades |
| 价格影响中止 | >10% | 否——始终中止 |
| 价格影响警告 | >5% | 否——始终警告 |
如果达到任何限制，代理必须停止并通知用户。
凭证隔离
此技能的运行时脚本不直接读取 .env 文件。所有凭证仅通过环境变量访问，必须由调用者预先加载（source ~/.openclaw/workspace/.env）。这确保没有运行时脚本可以独立访问或窃取凭证文件。
例外： scripts/setup.py 读取和写入 .env——它加载现有密钥以避免重新生成，在更改前备份 .env，并写入新的密钥对条目。这是唯一接触凭证文件的脚本，并且仅在初始设置或显式的 --force 重新生成时运行。
自动化监控（定时任务）
快速设置
# 监督模式（默认）：分析 + 通知，无自动执行
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-default
# 自动模式（选择加入）：自动买入和卖出
source ~/.openclaw/workspace/.env && bash scripts/cron-examples.sh setup-autonomous
# 移除所有定时任务
bash scripts/cron-examples.sh teardown
| 任务 | 间隔 | 默认行为 |
|---|---|---|
stop-loss-tp | 5 分钟 | 报告触发的条件，不自动卖出 |
discovery-scan | 1 小时 | 分析并发送建议，不自动买入 |
有关完整的定时任务配置、手动设置、心跳替代方案和监控工作流详情，请参阅 references/autonomous-trading.md。
链上分析框架（7 步流程）
⚠️ 2026-05-04 后不可用： 步骤 1–6 都访问
wallet-data.kryptogo.app，当 kg-xyz 后端关闭后将停止工作。步骤 7（通过swap.py执行交易）继续工作，因为交易路径通过 OKX DEX 聚合器并在本地签名。
步骤 1：代币概览和市值过滤器
/token-overview?address=<mint>&chain_id=<id> — 获取名称、价格、市值、持有者、风险等级。如果市值小于 min_market_cap 则跳过。
步骤 2：聚类分析
/analyze/<mint>?chain_id=<id> — 钱包聚类、前持有者、元数据。
- ≥30-35% = "受控" — 存在主要实体
- ≥50% = 高度集中风险
- 单个聚类 >50% → 跳过（拉地毯风险）
免费层级限制： 聚类分析仅返回前 2 个聚类。要查看完整聚类数据，请升级至 kryptogo.xyz/pricing。
步骤 3：聚类趋势（多时间框架）
/analyze-cluster-change/<mint> — 跨 15 分钟/1 小时/4 小时/1 天/7 天的 cluster_ratio + changes。
核心洞察：价格和聚类持有量分化是关键信号。
- 价格上涨 + 聚类占比下降 = 分布（看跌）
- 价格下跌 + 聚类占比上升 = 累积（看涨）
步骤 4：地址标签和卖出压力验证
/token-wallet-labels→ 识别开发者/狙击手/捆绑钱包- 对每个风险地址进行
/balance-history→ 检查是否仍持有 - 计算
risky_ratio= 活跃风险持有量 / 总聚类持有量 -
30% = 高风险，10-30% = 中等，<10% = 低
标签代表行为历史，而非当前持有量。始终通过
/balance-history进行验证。
步骤 5：深度分析（可选）
/balance-history、/balance-increase/<mint>、/top-holders-snapshot/<mint>、/analyze-dca-limit-orders/<mint>、/cluster-wallet-connections
步骤 6：决策
应用 references/decision-framework.md 中的看涨清单。
步骤 7：执行交易
使用 scripts/swap.py 执行——处理钱包地址注入、错误检查和日志记录。
✓ 2026-05-04 后继续工作： 交易执行通过 OKX DEX 聚合器并进行本地签名，独立于 kg-xyz 后端。
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> 0.1
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <token_mint> <amount> --sell
API 快速参考
⚠️ 2026-05-04 后： 以下每个端点都由
wallet-data.kryptogo.app提供，并将关闭。交易工具（swap_tokens/scripts/swap.py）绕过这些端点，直接访问 OKX DEX 聚合器，因此继续工作。
| 端点 | 方法 | 用途 | 2026-05-04 后 |
|---|---|---|---|
/agent/account | GET | 检查层级和配额 | ⚠️ 不可用 |
/agent/trending-tokens | GET | 扫描热门代币 | ⚠️ 不可用 |
/agent/portfolio | GET | 钱包投资组合 + 盈亏 | ⚠️ 不可用（盈亏增强失效）；余额仍可通过 Solana RPC 获取 |
/agent/swap | POST | 构建未签名的交易（仅 Solana） | ⚠️ 不可用（交易现在通过 OKX DEX；请参见 scripts/swap.py） |
/agent/submit | POST | 提交已签名的交易（仅 Solana） | ⚠️ 不可用（改为直接提交至 Solana RPC） |
/token-overview | GET | 代币元数据和市场数据 | ⚠️ 不可用 |
/analyze/:token_mint | GET | 完整聚类分析 | ⚠️ 不可用 |
/analyze-cluster-change/:token_mint | GET | 聚类占比趋势 | ⚠️ 不可用 |
/balance-history | POST | 时序余额数据 | ⚠️ 不可用 |
/wallet-labels | POST | 行为标签 | ⚠️ 不可用 |
/token-wallet-labels | POST | 特定代币标签 | ⚠️ 不可用 |
/signal-dashboard | GET | 精选累积信号（Pro+） | ⚠️ 不可用 |
完整请求/响应详情：请参阅
references/api-reference.md
多链支持
| 链 | chain_id | 分析 | 交易 |
|---|---|---|---|
| Solana | 501 | 是 | 是 |
| BSC | 56 | 是 | 否 |
| Base | 8453 | 是 | 否 |
| Monad | 143 | 是 | 否 |
错误处理
| 代码 | 含义 | 操作 |
|---|---|---|
| 400 | 错误请求 | 检查参数 |
| 401 | 未授权 | 检查 API 密钥 |
| 402 | 配额超出 | 等待每日重置或升级 |
| 403 | 禁止访问 | 需要更高层级 |
| 502/504 | 服务器错误 | 10 秒后重试一次 |
操作脚本
所有脚本需要预先加载凭证：在运行前执行 source ~/.openclaw/workspace/.env。
关闭后（2026-05-04）：
portfolio.sh、trending.sh、analysis.sh和test-api.sh都会调用 kg-xyz 后端，并将开始返回 HTTP 错误。swap.py继续工作，因为它使用 OKX DEX 聚合器并在本地签名。脚本已保留，以便技能优雅地失败，并在后端恢复时轻松回退。
source ~/.openclaw/workspace/.env && bash scripts/portfolio.sh # 投资组合检查 (⚠️ 2026-05-04 后失效)
source ~/.openclaw/workspace/.env && bash scripts/trending.sh # 热门代币 (⚠️ 2026-05-04 后失效)
source ~/.openclaw/workspace/.env && bash scripts/analysis.sh # 完整分析仪表盘 (⚠️ 2026-05-04 后失效)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> 0.1 # 买入 (✓ 继续工作)
source ~/.openclaw/workspace/.env && python3 scripts/swap.py <mint> <amt> --sell # 卖出 (✓ 继续工作)
source ~/.openclaw/workspace/.env && bash scripts/test-api.sh # API 连接性测试 (⚠️ 2026-05-04 后失效)
学习与适应
代理通过记录交易、分析结果和调整策略来不断改进。每笔交易记录到 memory/trading-journal.json，亏损触发事后分析，定期审查提出参数变更。
有关学习系统、交易日记格式、事后分析流程和策略审查的完整细节，请参阅 references/autonomous-trading.md。
核心概念
| 概念 | 关键见解 |
|---|---|
| 聚类 | 由同一实体控制的一组钱包 |
| 聚类占比 | 聚类持有的代币总量百分比 |
| 累积 | 聚类在价格下跌时增加持有量（看涨信号） |
| 分布 | 聚类在价格上涨时减少持有量（看跌信号） |
| 狙击手钱包 | 在首次 DEX 添加后立即买入，意图快速抛售 |
| 捆绑钱包 | 同时使用多个钱包买入，制造虚假需求 |
参考
| 文档 | 描述 |
|---|---|
references/autonomous-trading.md | 完整自动模式指南、定时任务设置、学习系统 |
references/decision-framework.md | 看涨清单、风险评分指引 |
references/api-reference.md | 完整 API 请求/响应规范 |