核心用法
x-cli 是一套面向 OpenClaw 代理的 X（原 Twitter）全功能命令行工具集，底层基于 twikit 库，采用 cookie 认证机制，无需申请官方 API 密钥即可调用绝大多数 Twitter 功能。
主要功能模块
| 模块 | 功能描述 |
|------|---------|
| **x_read.py** | 读取单条推文、用户时间线、首页/推荐流、回复串、提及、精选内容及用户搜索 |
| **x_search.py** | 全局搜索，支持高级语法（如 `from:username keyword`） |
| **x_post.py** | 发推、带媒体发推、回复、引用、定时发布（⚠️ 需用户确认） |
| **x_interact.py** | 点赞/取消、转发/取消、书签、关注/取消、屏蔽、静音、删推 |
| **x_dm.py** | 发送私信、读取收件箱 |
| **x_extra.py** | 趋势榜、通知、书签列表、用户资料、粉丝/关注列表、媒体上传、投票、列表管理 |
| **x_auth.py** | 登录状态检查、当前用户识别、登录流程 |
输出与扩展
- 默认纯文本输出，
--json可切换结构化数据 - 自动提取媒体 URL（图片 🖼️ / 视频 🎥）及回复上下文
- 支持代理配置（HTTP/HTTPS）
---
显著优点
1. 零 API 成本：绕过 Twitter API 的付费 tier 限制，特别适合高频读取场景
2. 功能完整：覆盖读、写、互动、私信、列表、投票等 90%+ 的 Web 端功能
3. 代理友好：内置代理支持，适配多账号/多地区运营需求
4. OpenClaw 原生：专为 AI Agent 设计，输出格式便于程序解析
潜在缺点与局限
| 风险点 | 说明 |
|--------|------|
| **账号安全** | Cookie 认证依赖模拟浏览器请求，存在被平台识别为"自动化工具"而限流或封禁的风险 |
| **稳定性** | twikit 通过逆向工程实现，Twitter 前端变更可能导致功能突然失效 |
| **速率限制** | 无官方文档明确限流阈值，高频率操作易触发隐形限制 |
| **无 OAuth 审计** | 无法像官方 API 一样细粒度控制权限范围 |
| **法律灰色地带** | 可能违反 Twitter/X 的服务条款（ToS）第 4 条关于自动化的规定 |
适合人群
- 社交自动化开发者：需要低成本、高频读取 Twitter 数据的场景
- 舆情监测团队：追踪关键词、趋势、特定账号动态
- 内容运营者：多账号管理、定时发布、互动维护
- 研究人员：社交媒体数据分析（需遵守平台规则与伦理）
常规风险
- 账号封禁：建议搭配备用账号、代理轮换、操作频率控制
- 数据隐私：Cookie 文件包含敏感凭证，需妥善保管
- 内容责任：发帖模块（
x_post.py）明确标注需用户确认，避免 AI 误发不当内容