KryptoGO 迷因幣交易代理技能
關閉通知 — kg-xyz 分析後端
KryptoGO XYZ 分析後端 (
wallet-data.kryptogo.app) 將於 2026-05-04 停止服務。在此日期之後，所有依賴集群分析、錢包標籤、訊號儀表板以及 DCA/限價單重建的工具將無法運作。兌換執行路徑（OKX DEX 聚合器 + 本地交易簽署）與 kg-xyz 後端無關，將繼續正常運作。
各工具的影響已於下方內文標註。腳本和 MCP 工具實作仍保留在原地，以便它們優雅地失敗（後端將回傳 HTTP 錯誤），並且如果計畫有變，也能輕鬆還原。
概述
此技能使 AI 代理程式能夠透過 KryptoGO 平台分析與交易迷因幣，將深入的鏈上集群分析與交易執行相結合。
自 2026-05-04 起功能降級： 當 kg-xyz 後端關閉時，集群分析、錢包/代幣標籤、訊號儀表板、DCA/限價單重建以及投資組合損益增強將停止運作。兌換執行則繼續有效。
分析（支援多鏈：Solana、BSC、Base、Monad）：錢包集群、累積/分佈檢測、地址行為標籤、網絡層級累積訊號（Pro/Alpha 層級）。
交易（僅限 Solana）：投資組合監控（含損益追蹤）、透過 DEX 聚合器進行兌換執行、本地交易簽署（私鑰永不離開機器）。
預設模式為受監督模式——所有交易都需要用戶確認。可選擇加入全自動交易。請參閱 references/autonomous-trading.md 以了解自動模式、排程設定和學習系統的詳細資訊。
使用時機
- 用戶要求分析 Solana/BSC/Base/Monad 上的迷因幣或代幣
- 用戶要求交易、買入或賣出代幣
- 用戶要求掃描熱門代幣或市場機會
- 用戶要求監控投資組合部位或檢查損益
- 排程觸發的定期投資組合監控和訊號掃描
不應使用時機
- 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（權限設為 chmod 600），並列印出需要注資的公開地址。
3. 為錢包注資
將 SOL 發送至代理程式的公開地址（最低 0.1 SOL）。
安全性規則
- 絕對不要在訊息或 CLI 參數中列印、記錄或包含私鑰
- 絕對不要接受直接貼到聊天中的機密資訊——請指示用戶在
.env中設定 - 絕對不要使用 Read 工具讀取
.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，並將status設為"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> — 在 15m/1h/4h/1d/7d 時間範圍內的 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。
核心概念
| 概念 | 關鍵洞察 |
|---|---|
| 集群 | 由同一實體控制的一組錢包 |
| 集群 |
…
[為翻譯而截斷]