账号池
Grok Bot 账号凭证与使用状态。添加账号：打开 Grok Bot 客户端 → 设置中添加账号登录 → 点「从本机收割账号」。Token 临期自动续签。
–
账号数
–
空闲账号
–
累计请求
账号列表
同机所有账号共享一个 machine-id（实测服务端接受）。
| 账号 | Token 到期 | 本周额度 | 状态 | 请求数 | 最近使用 | 对话 Agent |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
对话测试
与外部客户端走完全相同的链路（/v1/chat/completions）。生成类任务约 30~130 秒，流式有心跳不会中断。
在线测试
发送测试请求会消耗 Grok Bot 账号额度。
选择模型后发送消息。grok-bot 带记忆；grok-bot-new 每次独立对话。
接入文档
将 Grok Bot 接入支持自定义 OpenAI 接口的客户端，例如 Cherry Studio、Chatbox、DeepSeek Harness。管理接口仅监听本机，请勿暴露到公网。
客户端接入参数
在客户端的「自定义 Provider / 模型服务」设置中填入以下参数。
API 地址（Base URL）
需要完整端点的客户端填写
API Key
sk-none（任意值）
默认未启用鉴权。开启方式：start.bat 中
set GROKBOT_API_KEY=你的keyAPI 协议
OpenAI Chat Completions
标准 SSE 流式（
stream:true），长任务含 keepalive 心跳。模型 ID
grok-bot ｜ grok-bot-new
grok-bot：账号默认 bot，带跨请求记忆。 grok-bot-new：每请求全新独立对话、无记忆，推荐接入客户端使用。
请求示例
按所选模型与流式开关生成，可直接复制运行。
能力规格（实测）
以下数值来自对本服务的实测。
| 项目 | 数值 | 说明 |
|---|---|---|
| 问答延迟 | ~15s | 简单问答端到端耗时；流式 0 秒响应头 + 心跳。 |
| 生成类任务 | 30~130s | 写 HTML / 画图等 agent 任务；完成信号（附件/收尾措辞/问句/拒绝）自动收尾。 |
| 文件产物 | ✅ 自动落盘 | bot 生成的 HTML / 图片等附件存入 files/，回复含本地路径 + 在线预览链接（HTML 渲染动画、图片/音频/视频直接播放）。上限 5MB。 |
| 图片输入 | ✅ 多模态 | OpenAI content 数组格式（image_url，data URI 或 http 链接），图片自动上传 bot 沙箱。 |
| 视频生成 | ❌ 不支持 | Grok Bot 客户端无视频生成通道。 |
| 工具调用（tools） | ❌ 不透传 | bot 自带工具（联网、文件、画图）；客户端 tools 参数不透传。 |
| 并发 | 排队 | 单账号串行（忙时排队 ≤120s）；多账号自动轮转并发。 |
协议与管理端点
支持的 API 端点。管理接口无鉴权、仅监听 127.0.0.1。
| 方法 | 路径 | 说明 |
|---|---|---|
POST | /v1/chat/completions | 对话端点，支持流式与多模态。 |
GET | /v1/models | 模型列表（grok-bot / grok-bot-new）。 |
GET | /files/<name> | 附件预览/下载，按扩展名设置 Content-Type。 |
GET | /admin/status | 账号池状态。 |
POST | /admin/refresh-all | 强制刷新全部账号 token。 |
POST | /admin/harvest | 收割本机 Grok Bot 登录凭证并加入池。 |
多轮任务：会话历史含任务词（生成/创建/画图/修改等）时，后续短确认消息（"对，补全即可"）自动延续任务等待档，不会被提前截断；bot 拒绝类回复 4 秒内快速返回。
客户端兼容性
已验证的接入方式。
| 客户端类型 | 接入方式 | 状态 |
|---|---|---|
| OpenAI 兼容聊天客户端（Cherry Studio、Chatbox 等） | Base URL 填 API 地址，模型选 grok-bot-new（或 grok-bot）。 | ✅ 已验证 |
| 智能体客户端（DeepSeek Harness 等） | Chat Completions + 流式；harness 的系统注入/环境声明/标题请求已自动过滤与代答。 | ✅ 已验证（含多轮任务延续） |
| 多模态请求（带图提问） | content 数组含 image_url，图片自动上传。 | ✅ 已验证 |
| 依赖 tools / function calling 的客户端 | — | ❌ 不支持 |