夜雨聆风💡 为什么选择 AiboteClaw？
AiboteClaw 采用标准 WebSocket 协议，实现了一套极简的“指令-响应”架构。这意味着无论你使用 Node.js、Python、C++ 还是 Java，只要支持网络通信，就能轻松操控 AiboteClaw 的全量自动化能力。
一、 连接规范
接入第一步，建立稳定的双向连接。
默认地址：
ws://127.0.0.1:8016网络兼容：全面支持 IPv6（格式如
ws://[::1]:8016）。最佳实践：建议在
onopen握手成功后，立即调用getWindowsId指令，既能验证连接有效性，也能获取设备唯一标识。
二、 通信协议：简单而纯粹
1. 发送请求 (Request)
所有指令均以 JSON 格式发送。
字段说明：
requestId建议使用“时间戳+随机数”，用于在异步响应中匹配对应的请求。
JSON
{
"requestId": "1710000001",
"payload": {
"cmd": "指令名称",
"参数": "值"
}
}
2. 接收响应 (Response)
服务返回为字符串，格式固定为：requestId_payload。
解析逻辑：寻找第一个下划线
_。左侧：对应的
requestId。右侧：执行结果（JSON 字符串或纯文本）。
三、 核心指令集 (API)
1. 系统与工具配置
| 指令 (cmd) | 功能描述 | 返回值 |
| getWindowsId | 获取设备唯一识别 ID | 字符串 ID |
| setTool | [关键] 设置 AI 参数（模型、APIKey、工具列表） | 执行结果 |
| getCredits | 查询账户剩余算力积分 | 数值字符串 |
2. 动态发现
| 指令 (cmd) | 功能描述 |
| showExtendList | 获取已加载的扩展插件列表 |
| showMcpList | 获取已安装的 MCP 服务列表 |
| showSkillsList | 获取技能模块列表 |
3. AI 交互核心
| 指令 (cmd) | 参数 | 功能 |
| llmChat | input, thinking | 发送对话指令（支持开启推理模式） |
| stopLlm | {} | 强制中断当前的 AI 生成 |
| clearMessage | {} | 重置对话，清空上下文历史 |
四、 特殊功能：文件与语音
📤 文件传输
AiboteClaw 采用“上传-引用”分离模式。
POST 上传：通过
/upload接口将文件传至服务器。标签引用：在
llmChat的输入框中，使用<file_paths>标签包裹路径。
🎙️ 语音识别
完美支持浏览器 SpeechRecognition 接口。识别完成后，建议将结果直接透传给 llmChat，实现流畅的语音指挥体验。
五、 5 分钟上手示例 (JavaScript)
JavaScript
const WebSocket = require('ws');
const ws = new WebSocket('ws://127.0.0.1:8016');
// 连接成功
ws.on('open', () => {
const request = {
requestId: Date.now().toString(),
payload: { cmd: "getWindowsId" }
};
ws.send(JSON.stringify(request));
console.log("🚀 请求已发送...");
});
// 处理响应
ws.on('message', (data) => {
const raw = data.toString();
const splitIndex = raw.indexOf('_');
const id = raw.slice(0, splitIndex);
const result = raw.slice(splitIndex + 1);
console.log(`✅ 收到响应 [ID: ${id}]:`, result);
});
📂 资源归档
服务端路径：
Aibote\Project\Agent\start.exe开源 WebUI 源码：
Aibote\Project\Agent\webUIGithub地址：https://github.com/chengzhenabc/Aibote
🌟 Aibote Agent 它是什么？
Aibote Agent 是一款国产自研的本地 AI 自动化平台。它不只是聊天机器人，而是具备全平台控制能力的“智能体”：
全平台制霸：Windows、Web、安卓手机，一网打尽。
深度交互：读写文件、执行系统命令、自主编写代码并运行。
私密安全：本地运行，隐私不出户。
💡 快速通道：
官网：
https://www.aibote.net 视频教程：B站搜索“Aibote 教程”
福利：完全免费，支持自定义 UI、名称和 LOGO！
🛠️ 极速安装指南
硬件要求：Windows 10+ | 内存 2GB+ | 硬盘 5GB+
准备：关闭杀毒软件（防止误删核心组件）。
下载：https://dl.aibote.net/InstallAibote.exe
安装：双击运行，全自动解压。
算力福利：新用户无需配置，即刻赠送 2 万 Token 免费算力！
🧩 核心功能模块详解
技术硬核优势：底层自研 6 年，功能高度模块化。相比同类开源项目，Aibote 的 Token 消耗仅为 1%，精准度更高！
1. 自动化控制全家桶
WindowsBot：基于 DOM 树+AI 视觉，毫秒级操控各种 ERP、办公软件。
WebBot：深度适配网页 DOM，自动化采集、填表、截图。
AndroidBot：无需 Root（支持无障碍/HID），点外卖、刷任务的利器。
2. 人工智能进化
实时数字人：基于本地 CPU，支持语音实时对话指令。
AI 视觉分析：能读懂视频，帮你写脚本、做二创。
系统 Agent 模式：超级模式，像真人一样操控电脑解决复杂问题。
🔌 开发者天堂：插件与生态
Aibote 提供了极强的扩展能力，你可以通过 Node.js 或 Python 为其增加无限可能。
示例：三步开发一个文件读写插件
写逻辑：编写
read_writeFile.js。写配置：编写对应的
.json描述文件。部署：放入
\Aibote\Project\Agent\extend文件夹即可生效。
此外，它还完美支持 MCP (Model Context Protocol) 生态，百度地图、股票行情等服务一键接入。