xAI

核心功能

xAI 技能为用户提供与 xAI 官方 API 的直接对接能力，支持调用 Grok-4、Grok-4.20、Grok-3、Grok-3-mini 等全系模型，涵盖文本生成、视觉理解及实时 X/Twitter 搜索三大核心场景。

显著优点

1. 实时信息获取：独特的 search-x 命令通过 xAI Responses API 调用 x_search 工具，可检索实时 X 帖子并附带引用来源，这是其他 LLM 技能难以替代的核心优势
2. 模型选择灵活：支持 Grok-3（最强能力）、Grok-3-mini（高效快速）、Grok-3-fast（速度优化）、Grok-2-vision（图像理解）等多种模型按需切换
3. 视觉能力完备：支持本地图像文件分析，满足图文多模态需求
4. 官方背书：直接调用 xAI 官方 API，响应质量与 ChatGPT、Claude 等主流模型处于同一梯队

潜在局限

• 生态封闭性：Grok 的预训练知识库相对较新但深度不如 GPT-4/Claude 3.5，复杂推理任务偶有波动
• 成本考量：xAI API 定价随模型强度浮动，高频使用需关注用量配额
• 地域限制：xAI 服务在某些地区可能存在访问限制
• 搜索依赖 X 平台：实时搜索能力完全绑定 X/Twitter 生态，若目标信息不在该平台则无法获取

适合人群

• 需要实时舆情监控或社交媒体情报分析的研究者、市场从业者
• 已持有 xAI API Key 且希望快速接入 CLI 工作流的开发者
• 偏好 Grok 回答风格（幽默、直接、较少过滤）的用户
• 需要结合图像理解与文本生成的多模态任务场景

常规风险

• API Key 安全：XAI_API_KEY 需妥善保管，避免泄露导致配额被盗用
• 内容合规：X 实时搜索结果可能包含未经验证的用户生成内容，需人工复核
• 速率限制：高频调用可能触发 xAI 端限流，建议实现退避重试机制
• 模型幻觉：与其他 LLM 相同，Grok 可能生成看似合理但错误的信息，关键决策需交叉验证

核心用法

xAI Skill 是 OpenClaw 生态中对接 xAI（原 Twitter/X 旗下 AI 公司）Grok 大语言模型的官方集成方案。该 Skill 提供三类核心功能：

1. 智能对话 (chat.js)：支持 Grok-3/Grok-4 全系列模型，可进行多轮文本交互，默认调用 grok-3 处理复杂任务，grok-3-mini 适用于快速响应场景。

2. 视觉理解 (chat.js --image)：基于 Grok-vision 模型分析本地图像，支持 JPG/PNG 等常见格式，可结合自然语言指令进行图文混合问答。

3. 实时 X 搜索 (search-x.js)：通过 xAI Responses API 调用 x_search 工具，获取 Twitter/X 平台实时帖文，支持按时间窗口（--days）和特定账号（--handles）筛选，返回结果带原文引用链接。

显著优点

• 零供应链风险：完全基于 Node.js 原生模块（https/fs/path）实现，零第三方依赖，彻底规避 npm 供应链攻击面。
• 密钥管理规范：API 密钥通过环境变量 XAI_API_KEY 或 ~/.clawdbot/clawdbot.json 配置获取，无硬编码凭证，符合企业安全合规要求。
• 网络边界清晰：仅与 api.x.ai 官方 HTTPS 端点通信，TLS 1.2+ 加密，无代理中转或可疑域名。
• 功能透明可审计：开源 MIT 许可，代码结构简洁（598 行/3 文件），行为与文档声明完全一致，无隐藏功能或越权操作。

潜在缺点与局限性

• T3 来源级别：由个人开发者（mvanhorn）维护，非企业级背书，生产环境建议先行代码审查。
• X 搜索依赖平台：实时搜索功能完全依赖 Twitter/X 平台数据可用性与 API 策略，存在服务稳定性风险。
• 无超时配置：当前 HTTPS 请求未设置超时阈值，极端网络环境下可能导致进程挂起。
• 图像路径校验基础：虽使用 path.resolve() 和 fs.existsSync() 进行基础防护，但缺乏更严格的路径遍历过滤。

适合人群

• 需要实时社交数据洞察的分析师（X 搜索为独家功能）
• 对供应链安全极度敏感的企业开发者（零依赖架构）
• 追求轻量部署的个人用户或小型团队
• 已持有 xAI API 密钥的 Grok 生态用户

常规风险

| 风险类别 | 等级 | 说明 |

|---------|------|------|

| 数据外泄 | 低 | 用户输入/图像需发送至 xAI 云端处理，属功能必需但涉及第三方数据托管 |

| 密钥泄露 | 低 | 依赖用户环境变量管理，需确保 `chmod 600` 配置文件权限 |

| 服务中断 | 中 | xAI API 或 X 平台策略变更可能影响功能可用性 |

| 供应链攻击 | 极低 | 零第三方依赖，原生模块实现从根本上消除此类风险 |