traderclaw-cli 1.0.58 → 1.0.60

package/bin/installer-step-engine.mjs

@@ -768,7 +768,7 @@ function traderCronPrescriptiveJobs(agentId) {
       schedule: "30 */2 * * *",
       agentId,
       message:
-        "CRON_JOB: portfolio_risk_audit — Portfolio stress tests, exposure checks, correlation analysis, drawdown monitoring. Produce risk report for CTO.",
+        "CRON_JOB: portfolio_risk_audit\n\nStep 1: Call solana_capital_status to get wallet balance and portfolio value.\n\nStep 2: Call solana_positions to get all open positions with entry prices and sizes.\n\nStep 3: For each open position, call solana_token_snapshot to get current price, 24h volume, and market cap.\n\nStep 4: Run concentration check — flag WARNING if any single position exceeds 30 percent of total portfolio value, CRITICAL if above 50 percent.\n\nStep 5: Run exposure check — flag WARNING if total exposure exceeds 50 percent of wallet balance, CRITICAL if above 75 percent.\n\nStep 6: Run drawdown check — CRITICAL if portfolio drawdown exceeds 25 percent from peak capital.\n\nStep 7: Calculate portfolio heat (sum of all position risk scores). Flag WARNING above 50 percent, CRITICAL above 75 percent.\n\nStep 8: Run liquidity check — WARNING if any position exceeds 2 percent of its pool depth.\n\nStep 9: Check solana_killswitch_status.\n\nStep 10: Write risk report via solana_memory_write with tag 'risk_audit'.\n\nFORMATTING RULES:\n- Every token reference MUST use SYMBOL (full_CA) format.\n- Do not execute trades. Do not ask questions.",
       enabled: true,
     },
     {
@@ -776,15 +776,15 @@ function traderCronPrescriptiveJobs(agentId) {
       schedule: "0 */3 * * *",
       agentId,
       message:
-        "CRON_JOB: source_reputation_recalc — Analyze which alpha signal sources led to wins vs losses. Update reputation tracking in memory.",
+        "CRON_JOB: source_reputation_recalc\n\nStep 1: Call solana_alpha_sources to get per-source performance stats (signal count, conversion rate, avg score).\n\nStep 2: Call solana_alpha_history to get recent signal history with scores and source identifiers.\n\nStep 3: Call solana_trades to get recent trade outcomes. Cross-reference each trade back to its originating signal source.\n\nStep 4: For each source, calculate: win rate (trades that hit TP vs SL), average PnL per trade, signal-to-trade conversion rate.\n\nStep 5: Assign tier rankings:\n- TIER-1 (LOCK): Win rate above 60% AND 5+ trades AND positive avg PnL\n- TIER-2 (CONDITIONAL): Win rate 30-60% OR fewer than 5 trades\n- TIER-3 (BLACKLIST): Win rate below 30% with 5+ trades\n\nStep 6: Write scorecard to memory using solana_memory_write with tag 'source_reputation'.\n\nFORMATTING RULES:\n- Every token reference MUST use SYMBOL (full_CA) format.\n- Do not execute trades. Do not ask questions.",
       enabled: true,
     },
     {
-      id: "meta-rotation-analysis",
+      id: "meta-rotation",
       schedule: "30 */3 * * *",
       agentId,
       message:
-        "CRON_JOB: meta_rotation_analysis — Analyze narrative clusters across recent scans and trades. Identify hot vs cooling metas. Write observations to memory.",
+        "CRON_JOB: meta_rotation_analysis\n\nStep 0: Call x_search_tweets with queries: 'solana memecoin', 'pump fun gem', 'sol alpha'. Note which token names and narratives appear most frequently in the last 3 hours. Use this social signal to validate or challenge the on-chain data in the following steps.\n\nStep 1: Call solana_scan_launches to get recent token launches (last 3-6 hours).\n\nStep 2: Categorize each token by narrative cluster: AI/Agents, Animal Memes, Political, Celebrity/IP, DeFi, Gaming, Culture/Humor, Other.\n\nStep 3: For each cluster, aggregate: token count, total volume, average market cap.\n\nStep 4: Call solana_memory_search for 'meta_rotation' to compare with prior scan.\n\nStep 5: Classify each narrative: GAINING, SATURATED, COOLING, DORMANT.\n\nStep 6: Write rotation report via solana_memory_write with tag 'meta_rotation'.\n\nFORMATTING RULES:\n- Every token reference MUST use SYMBOL (full_CA) format.\n- Do not execute trades. Do not ask questions.",
       enabled: true,
     },
     {
@@ -800,7 +800,7 @@ function traderCronPrescriptiveJobs(agentId) {
       schedule: "15 * * * *",
       agentId,
       message:
-        "CRON_JOB: subscription_cleanup — Check active Bitquery subscriptions. Unsubscribe from streams no longer needed (sold tokens, closed positions).",
+        "CRON_JOB: subscription_cleanup\n\nStep 1: Call solana_positions to get all open positions and extract their contract addresses.\n\nStep 2: Call solana_bitquery_subscriptions to list all active Bitquery subscriptions. If this call returns an AUTH_SCOPE_MISSING error, log the error to memory and stop gracefully — do not retry or error out.\n\nStep 3: For each active subscription, check if the associated token CA still has an open position. Build two lists: 'matched' (has position) and 'orphaned' (no position).\n\nStep 4: Unsubscribe orphans via solana_bitquery_unsubscribe.\n\nStep 5: Reopen subscriptions nearing 24h expiry via solana_bitquery_subscription_reopen.\n\nStep 6: Write summary via solana_memory_write with tag 'subscription_cleanup'.\n\nFORMATTING RULES:\n- Every token reference MUST use SYMBOL (full_CA) format.\n- Do not execute trades. Do not ask questions.",
       enabled: true,
     },
     {

package/bin/openclaw-trader.mjs

@@ -3,7 +3,7 @@
 import { createInterface } from "readline";
 import { readFileSync, writeFileSync, mkdirSync, appendFileSync, existsSync } from "fs";
 import { dirname, join } from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath, pathToFileURL } from "url";
 import { homedir } from "os";
 import { randomUUID, createPrivateKey, sign as cryptoSign } from "crypto";
 import { execFile, execSync } from "child_process";
@@ -665,6 +665,7 @@ async function cmdSetup(args) {
   let writeGatewayEnvFlag = false;
   let noEnsureGatewayPersistent = false;
   let signupRecoverySecret = undefined;
+  let forwardTelegramRecipientArg = "";
 
   for (let i = 0; i < args.length; i++) {
     if ((args[i] === "--api-key" || args[i] === "-k") && args[i + 1]) {
@@ -703,6 +704,14 @@ async function cmdSetup(args) {
     if (args[i] === "--no-ensure-gateway-persistent") {
       noEnsureGatewayPersistent = true;
     }
+    if (
+      (args[i] === "--telegram-recipient" ||
+        args[i] === "--forward-telegram-chat-id" ||
+        args[i] === "--telegram-chat-id") &&
+      args[i + 1]
+    ) {
+      forwardTelegramRecipientArg = args[++i];
+    }
   }
   const runtimeWalletPrivateKey = getRuntimeWalletPrivateKey(walletPrivateKey);
 
@@ -970,6 +979,49 @@ async function cmdSetup(args) {
     }
   }
 
+  let forwardTelegramRecipient = forwardTelegramRecipientArg.trim();
+  print("\nTelegram delivery (optional)...\n");
+  printInfo("  Enter your Telegram @username or numeric chat id so agent replies can be routed to you.");
+  printInfo(
+    "  Usernames resolve when plugin config telegramBotToken is set, or TELEGRAM_BOT_TOKEN / OPENCLAW_TELEGRAM_BOT_TOKEN is set for this prompt.",
+  );
+  printInfo("  Private chats: message your bot once first.\n");
+  if (!forwardTelegramRecipient) {
+    forwardTelegramRecipient = await prompt("Telegram @username or chat id (optional, Enter to skip)", "");
+  }
+  forwardTelegramRecipient = forwardTelegramRecipient.trim();
+
+  if (forwardTelegramRecipient) {
+    const botToken = String(
+      prevPlugin?.telegramBotToken ||
+        process.env.TELEGRAM_BOT_TOKEN ||
+        process.env.OPENCLAW_TELEGRAM_BOT_TOKEN ||
+        "",
+    ).trim();
+    try {
+      const { looksLikeTelegramChatId, resolveTelegramRecipientToChatId } = await import(
+        pathToFileURL(join(PLUGIN_ROOT, "dist", "src", "telegram-resolve.js")).href,
+      );
+      if (looksLikeTelegramChatId(forwardTelegramRecipient)) {
+        pluginConfig.forwardTelegramRecipient = forwardTelegramRecipient;
+        printSuccess(`  Saved Telegram chat id`);
+      } else if (botToken) {
+        const id = await resolveTelegramRecipientToChatId({ botToken, raw: forwardTelegramRecipient });
+        pluginConfig.forwardTelegramRecipient = id;
+        printSuccess(`  Resolved @${forwardTelegramRecipient.replace(/^@/, "")} → chat id ${id}`);
+      } else {
+        pluginConfig.forwardTelegramRecipient = forwardTelegramRecipient;
+        printInfo(
+          "  Saved as-is; set plugin telegramBotToken or gateway TELEGRAM_BOT_TOKEN to resolve @username on first run.",
+        );
+      }
+    } catch (err) {
+      printWarn(`  Telegram resolve failed: ${err instanceof Error ? err.message : String(err)}`);
+      printInfo("  Saving your username anyway — fix token or use numeric chat id.");
+      pluginConfig.forwardTelegramRecipient = forwardTelegramRecipient;
+    }
+  }
+
   print("\nWriting configuration...\n");
 
   const existingConfig = readConfig();
@@ -1178,6 +1230,7 @@ async function cmdSetup(args) {
   Wallet PrivKey:${lastSeenWalletPrivateKey ? (createdNewWallet || showWalletPrivateKey ? " " + lastSeenWalletPrivateKey : " " + maskKey(lastSeenWalletPrivateKey)) : " not saved"}
   Gateway URL:   ${gatewayBaseUrl || "not set"}
   Gateway Token: ${gatewayToken ? maskKey(gatewayToken) : "not set"}
+  Telegram fwd:  ${pluginConfig.forwardTelegramRecipient || "(not set)"}
   API Key:       ${showApiKey ? apiKey : maskKey(apiKey)}
   Session:       Active (tier: ${sessionTokens.session?.tier || "?"})
   Config:        ${CONFIG_FILE}
@@ -3154,6 +3207,7 @@ Setup options:
   --wallet-private-key  Optional base58 private key for wallet proof flow (runtime only, never saved)
   --gateway-base-url, -g  Gateway public HTTPS URL for orchestrator callbacks
   --gateway-token, -t     Gateway bearer token (defaults to API key)
+  --telegram-recipient    Telegram @username or chat id (aliases: --forward-telegram-chat-id, --telegram-chat-id)
   --skip-gateway-registration  Skip gateway URL registration with orchestrator
   --show-api-key     Extra hint after signup (full key is always shown once; confirm with API_KEY_STORED)
   --show-wallet-private-key  Reveal full wallet private key in setup output
@@ -3186,6 +3240,7 @@ Examples:
   traderclaw setup --signup --user-id my_agent_001
   traderclaw setup --api-key oc_xxx --url https://api.traderclaw.ai
   traderclaw setup --gateway-base-url https://gateway.myhost.ts.net
+  traderclaw setup --telegram-recipient @myusername
   traderclaw login
   traderclaw login --force-reauth --wallet-private-key <base58_key>
   traderclaw logout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "traderclaw-cli",
-  "version": "1.0.58",
+  "version": "1.0.60",
   "description": "Global TraderClaw CLI (install --wizard, setup, precheck). Installs solana-traderclaw as a dependency for OpenClaw plugin files.",
   "type": "module",
   "bin": {
@@ -17,7 +17,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "solana-traderclaw": "^1.0.58"
+    "solana-traderclaw": "^1.0.60"
   },
   "keywords": [
     "traderclaw",