核心功能
Katbot Trading Skill 是一个面向 Hyperliquid 生态的专业级加密交易自动化工具，通过与 Katbot.ai 平台深度集成，为 AI Agent 提供从市场分析到链上执行的完整交易闭环。
主要能力
1. 智能市场分析 (BMI 系统)
- 独家 BTC Momentum Index (BMI) 指标：融合趋势分析、MACD、K 线实体、成交量和 RSI 五大维度
- 实时输出市场情绪信号：BULLISH / BEARISH / NEUTRAL
- Telegram 自动警报：市场转向时即时推送通知
- 24 小时涨跌榜追踪：快速定位市场热点
2. 智能代币选择
- 基于 CoinGecko 的动量筛选机制
- 自动匹配当前市场方向（BMI 信号驱动）
- 支持自定义监控代币列表
3. AI 驱动的交易推荐
- 端到端工作流：BMI 分析 → 代币筛选 → 智能推荐
- 结构化输出：入场价 (Entry)、止盈 (TP)、止损 (SL)、杠杆倍数
- 风险收益比自动计算
4. 安全的交易执行
- 用户确认机制：任何交易执行前强制人工确认
- 双重密钥体系：MetaMask 钱包密钥（本地 SIWE 认证）+ Hyperliquid 代理密钥（仅用于交易签名）
- 自动刷新令牌管理，7 天无活动会话过期
安全架构亮点
| 设计 | 说明 |
|------|------|
| 密钥分离 | MetaMask 密钥仅本地用于 SIWE 签名，永不传输；代理密钥仅用于交易签名 |
| 最小权限 | 日常运行仅需代理密钥，环境变量中无需保留敏感信息 |
| 文件权限 | 令牌和密钥文件强制 600 权限，存储于项目外的隔离目录 |
| 透明传输 | 明确告知用户何时何地传输何种密钥，首次使用前强制确认 |
| 应急降级 | 支持 `execute_onchain=False` 模拟执行，验证推荐后再上链 |
技术架构
- 认证层：SIWE (Sign-In with Ethereum) + JWT 双令牌轮换机制
- API 客户端：
katbot_client.py统一封装，自动处理令牌刷新 - 工作流引擎：
katbot_workflow.py编排完整交易流程 - CLI 支持： standalone 模式支持脚本化操作
- 依赖管理：
ensure_env.sh版本感知自动安装
局限性与风险
技术依赖：
- 完全依赖 Katbot.ai 云端 API 的可用性
- BMI 指标为平台专有算法，黑盒性质，用户无法验证计算逻辑
- Hyperliquid 链上执行受限于该平台的流动性与稳定性
资金风险：
- 代理私钥需传输至 Katbot.ai 服务器进行链上签名（尽管文档声称如此，但这是关键信任假设）
- 高杠杆合约交易天然存在爆仓风险
- AI 推荐并非保证收益，市场极端行情下可能失效
操作风险：
- 需要妥善保管
~/.openclaw/workspace/katbot-identity/目录，泄露将导致资金损失 - 7 天未使用需重新用 MetaMask 密钥认证，操作中断风险
适合人群
- 有 Hyperliquid 交易经验的 DeFi 用户：熟悉永续合约机制与风险
- 寻求自动化辅助的交易者：希望借助 AI 分析减少手动盯盘时间
- 技术型投资者：能接受 CLI/代码交互方式，有基础 Python 环境
不适合人群
- 加密货币新手或风险承受能力极低者
- 无法接受私钥传输至第三方服务器的极度保守用户
- 追求完全透明、可审计策略的量化交易者
常规风险提示
> ⚠️ 关键警告：本技能要求将 Hyperliquid 代理私钥传输至 api.katbot.ai 服务器以完成链上交易签名。虽然 MetaMask 主密钥永不离开本地，但代理密钥的云端托管构成了实质性的托管风险。建议：
> 1. 为代理钱包设置独立于主资金的限额
> 2. 定期监控链上授权与持仓
> 3. 首次使用前仔细阅读 Credential Transmission Notice 并确认理解风险