ClawQuant CLI

AI Agent 量化交易平台命令行工具 — Twitter/X 监控 + 链上数据分析

🚀 快速开始

安装

# Linux (x86_64)
curl -L https://clawquant.ai/downloads/clawquant-linux-amd64 -o clawquant
chmod +x clawquant
sudo mv clawquant /usr/local/bin/

# macOS (Intel)
curl -L https://clawquant.ai/downloads/clawquant-darwin-amd64 -o clawquant
chmod +x clawquant
sudo mv clawquant /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://clawquant.ai/downloads/clawquant-darwin-arm64 -o clawquant
chmod +x clawquant
sudo mv clawquant /usr/local/bin/

验证安装

clawquant --version
# 输出: 0.1.0

首次运行

clawquant x list

首次运行会自动：

1. 注册 Agent 账号
2. 获取 JWT Token
3. 保存到 ~/.config/clawquant/credentials.json

📖 功能特性

Twitter/X 监控

监控加密货币 KOL 的推文，获取市场情绪和关键观点。

# 添加监控账号
clawquant x add vitalikbuterin cz_binance

# 查看推文 feed
clawquant x feed -l 20 -h 24

# 获取 LLM 智能摘要
clawquant x summary -l 50 -h 12

特性:

• ✅ 支持批量添加监控账号（最多 50 个）
• ✅ 自定义时间范围和数量
• ✅ DeepSeek LLM 智能分析
• ✅ Redis 缓存（10 分钟）

📚 命令参考

Twitter/X 监控

# 查看监控列表
clawquant x list

# 添加监控账号（支持批量）
clawquant x add <username1> <username2> ...

# 移除监控账号
clawquant x remove <username>

# 查看推文 feed
clawquant x feed [options]
  -l, --limit <number>   返回推文数量（默认 20）
  -h, --hours <number>   时间范围（小时，默认 24）

# 获取智能摘要
clawquant x summary [options]
  -l, --limit <number>   分析推文数量（默认 20）
  -h, --hours <number>   时间范围（小时，默认 24）

🎯 使用场景

1. 监控加密货币 KOL

clawquant x add vitalikbuterin cz_binance elonmusk
clawquant x feed -h 1  # 每小时查看最新动态

2. 追踪项目方动态

clawquant x add Uniswap AaveAave Optimism
clawquant x feed -h 6  # 查看最近 6 小时的更新

3. 市场情绪分析

clawquant x add CryptoQuant glassnode santimentfeed
clawquant x summary -l 100 -h 12  # 获取综合分析

4. 定时任务集成

# 每天早上 9 点获取昨日摘要
0 9 * * * /usr/local/bin/clawquant x summary -h 24 > /tmp/crypto-summary.txt

🔧 技术架构

ClawQuant CLI
    │
    ├─→ https://clawquant.ai/api/v1/agents/register (首次注册)
    │
    └─→ https://clawquant.ai/datahub/agent/twitter/* (Twitter API)
         │
         ├─ /accounts (管理监控列表)
         ├─ /feed (获取推文)
         └─ /feed/summary (LLM 摘要)

技术栈:

• Commander.js - CLI 框架
• Axios - HTTP 客户端
• Kleur - 终端颜色
• @yao-pkg/pkg - 二进制打包
• Node.js 18.x - 运行时

📊 性能指标

| 指标 | 数值 | |------|------| | 二进制文件大小 | 48-55 MB | | 首次注册 | < 2 秒 | | 推文查询 | < 1 秒 | | LLM 摘要（首次） | 3-5 秒 | | LLM 摘要（缓存） | < 0.5 秒 |

🔐 安全性

• JWT 认证: HS256 算法，有效期 1 年
• HTTPS 强制: 所有 API 调用使用 HTTPS
• 文件权限: 配置文件权限 0600
• 域名限制: 仅允许 clawquant.ai 域名

🛠️ 开发

构建

cd cli
npm install
npm run build

打包

npm run package

生成的二进制文件位于 binaries/ 目录：

• clawquant-linux-x64
• clawquant-macos-x64
• clawquant-macos-arm64

部署

# 复制到 Web 服务器
cp binaries/* /root/clawquant/web/public/downloads/

# 创建符号链接
cd /root/clawquant/web/public/downloads
ln -sf clawquant-linux-x64 clawquant-linux-amd64
ln -sf clawquant-macos-x64 clawquant-darwin-amd64
ln -sf clawquant-macos-arm64 clawquant-darwin-arm64

🐛 故障排查

Token 问题

# 检查 Token 是否存在
cat ~/.config/clawquant/credentials.json

# 删除 Token 重新注册
rm ~/.config/clawquant/credentials.json
clawquant x list

网络问题

# 测试连接
curl -I https://clawquant.ai/api/v1/agents/status

# 检查 DNS
nslookup clawquant.ai

常见错误

| 错误信息 | 原因 | 解决方法 | |---------|------|---------| | 401 Unauthorized | Token 无效或过期 | 删除 credentials.json 重新注册 | | 404 Not Found | API 路径错误 | 检查 CLI 版本是否最新 | | 429 Too Many Requests | 请求过于频繁 | 等待 1 分钟后重试 | | Network error | 无法连接服务器 | 检查网络和防火墙设置 |

📝 文档

• 完整文档 - 用户安装和使用指南
• 下载页面 - 可视化下载页面
• 快速参考 - 命令速查表
• 部署总结 - 完整部署文档
• 验证报告 - 部署验证报告

🗺️ 路线图

Phase 2: 功能扩展

• [ ] 添加 clawquant news 命令（新闻查询）
• [ ] 添加 clawquant agent 命令（Agent 管理）
• [ ] 添加 clawquant skill 命令（Skill 管理）
• [ ] 实现自动更新检查功能

Phase 3: 分发优化

• [ ] 创建 Homebrew formula（macOS）
• [ ] 创建 APT/YUM 仓库（Linux）
• [ ] 添加 Windows 版本支持
• [ ] 实现 Shell 自动补全

Phase 4: 用户体验

• [ ] 添加配置文件管理命令
• [ ] 实现交互式配置向导
• [ ] 添加彩色输出和进度条
• [ ] 支持 JSON 输出格式

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🙏 致谢

• Commander.js - CLI 框架
• Axios - HTTP 客户端
• pkg - 二进制打包工具
• DeepSeek - LLM 智能分析

📧 联系方式

• 网站: https://clawquant.ai
• GitHub: https://github.com/clawquant/cli
• Discord: https://discord.gg/clawquant
• Email: [email protected]

版本: 0.1.0 更新日期: 2026-03-22 适用于: OpenClaw 生态 AI Agent