Aibote Agent —— 从零开始打造你的私人 AI 助手

第一章：认识 Aibote Agent

什么是 Aibote Agent？

Aibote Agent 是一个运行在你本地电脑或服务器上的 AI 助手。与 ChatGPT、Claude 等云端 AI 不同，它跑在你的设备上，数据完全受你掌控。

它不仅仅是一个聊天机器人，更是一个具备“执行力”的数字员工：

• 全平台控制：能操作电脑、浏览器、安卓手机。
• 深度交互：读写文件、执行系统命令、编写并运行代码。
• 私有化：数据安全，隐私无忧。

快速资源导航

• 官方网站：https://www.aibote.net
• 视频教程：Bilibili 教程链接
• 许可证：完全免费，支持自定义界面、名称和 LOGO。

核心功能概览

目标用户

• 个人用户：提升效率，管理日程，随叫随到的资料库。
• 开发者：自动化部署、代码分析，解放双手。
• 企业团队：处理报表、监控报警、智能客服，降本增效。
• 隐私敏感者：对本地数据安全有极高要求的用户。

第二章：安装指南

硬件/系统需求

• 操作系统：Windows 10 及以上
• 最低配置：CPU 1核 / 内存 2GB / 硬盘空间 5GB

一键安装流程

1. ⚠️ 预备工作：请先关闭杀毒软件，防止误删核心组件。
2. 下载地址：InstallAibote.exe
3. 安装：双击运行安装包，系统会自动解压安装。
4. 完成：安装后，桌面会自动生成 Aibote 文件夹。

第三章：核心功能与模块详解

技术优势：Aibote 底层由团队自研 6 年，功能模块化程度极高。相比 OpenClaw，其 Token 消耗仅为 1%，且大模型理解精准度更高。

大模型配置 (AI 大脑)

路径：Aibote 文件夹 -> 双击 Agent -> 配置参数页面

1. 填写 API 地址、模型类型 和 API 密钥。
2. 点击 保存配置并应用。

🚨 注意事项：

• 如果不填 API 密钥，系统将默认使用内置的微调大模型。
• 接口需支持 OpenAI 格式协议。
• API 地址末尾必须加上 /chat/completions。

电脑工具模块 (WindowsBot)

基于 DOM 树结构 + AI 视觉 + 找图取色技术，实现精准 UI 自动化。

• 基础模块 (必选)：初始化环境，分析 UI 树结构。
• 窗口模块 (必选)：获取窗口句柄，99% 的操作依赖此模块。
• UI 元素与鼠键模块：执行具体的点击、输入与数据获取。

网页工具模块 (WebBot)

基于 DOM 树结构 + AI 视觉，专门针对网页元素进行操作。

• 基础模块 (必选)：初始化网页环境。
• Web 元素：负责元素定位与交互执行。

安卓工具模块 (AndroidBot)

基于无障碍/HID/Aibote 键盘等技术，实现手机自动化。

• 基础模块 (必选)：初始化 Android 连接，分析 UI 树。
• 元素模块：获取手机界面数据，执行点击与触屏。

人工智能模块

• 生成 Aibote 脚本：自动生成 Node.js/Python 自动化代码。
• AI 视觉：理解图片及 20M 以内的视频内容。
• 实时数字人：基于本地 CPU 算力，支持语音互动与指令指挥。
• 非实时数字人：批量创作口播视频、短剧素材生成。
• 系统 Agent：超级模式。控制电脑/手机解决任意问题（需 ADB 权限，请慎用）。

技巧：快速了解更多模块

1. 勾选感兴趣的模块。
2. 切换到 AI 对话，发送指令：“列出所有工具详细参数”。

插件扩展生态

支持 JS/Python 源码或 EXE 程序。插件存放目录：\Aibote\Project\Agent\extend。

示例 1：纯 Node.js 读写插件

JS 逻辑 (read_writeFile.js):

const fs = require('fs');

async function readFile(args) {
    if (!fs.existsSync(args.filePath)) return "文件不存在";
    return await fs.readFileSync(args.filePath, 'utf8');
}

async function writeFile(args) {
    if (!fs.existsSync(args.filePath))
        await fs.writeFileSync(args.filePath, args.data, 'utf8');
    else
        return "文件已存在，禁止写入";
    return "文件写入成功";
}

module.exports = { readFile, writeFile }

JSON 配置 (read_writeFile.json):

{
    "modulesPath":["./extend/read_writeFile.js"],
    "tools":[
        {
            "type": "function",
            "function": {
                "name": "readFile",
                "description": "读取文本内容",
                "parameters": {
                    "type": "object",
                    "properties": { "filePath": { "type": "string", "description": "文件路径" } },
                    "required": ["filePath"]
                }
            }
        },
        {
            "type": "function",
            "function": {
                "name": "writeFile",
                "description": "写入文本内容",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "filePath": { "type": "string", "description": "文件路径" },
                        "data": { "type": "string", "description": "写入的数据" }
                    },
                    "required": ["filePath", "data"]
                }
            }
        }
    ]
}

示例 2：EXE 程序插件 (远程安装)

JS 逻辑 (aiSketch.js):

const { spawn } = require('child_process');
const fs = require('fs');
const installExtend = require('../lib/installExtend.js');

async function aiSketch(args) {
  const exePath = "script\\ai_sketch_image.exe";
  if(!fs.existsSync(exePath))
    await installExtend("http://124.248.66.46:81/agentExtend/ai_sketch.zip", "script");

  spawn(exePath, [args.imagePath], { detached: true, stdio: 'ignore', shell: true }).unref();
  return true;
}
module.exports = { aiSketch }

JSON 配置 (aiSketch.json):

{
    "modulesPath": [
        "./extend/aiSketch.js"
    ],
    "tools": [
        {
            "type": "function",
            "function": {
            "name": "aiSketch",
            "description": "模拟手工绘制",
            "parameters": {
                    "type": "object",
                    "properties": {
                        "imagePath": {
                            "type": "string",
                            "description": "参照图片路径，未指定则默认设置为：'script\\defaultImage.png'"
                        }
                    },
                    "required": [
                        "imagePath"
                    ]
                }
            }
        }
    ]
}

MCP 服务生态

配置目录：\Aibote\Project\Agent\mcpService。

• 远程 MCP 配置 (baiduMap.json):

    {
        "description":"百度地图。提供地图搜索服务",
        "url":"https://mcp.map.baidu.com/mcp?ak=xxxxxxxx"
    }
  

• 本地 MCP 配置 (a_share_mcp.json):

    {
      "mcpServers": {
        "股票行情。提供 A 股实时行情": {
          "command": "uv",
          "args": ["--directory", "d:\\a-share-mcp", "run", "python", "mcp_server.py"],
          "transport": "stdio"
        }
      }
    }
  

Skills 技能生态

配置目录：\Aibote\Project\skills。 每个技能单独存放到一个文件夹。

skill.md 规范示例:

---
name: 安装与开发扩展插件
description: 参考现有插件模板，为系统开发并安装新的功能插件。
---

# 问题处理

**执行步骤**：

1. **参考学习（Reference）**：
   - 调用 \`readFile\` 工具读取并分析以下两类插件示例：
     - **Node.js 类**：\`extend/read_writeFile.js\`（逻辑）及 \`extend/read_writeFile.json\`（配置）。
     - **EXE 类**：\`extend/aiSketch.js\`（逻辑）及 \`extend/aiSketch.json\`（配置）。
   - **分析重点**：观察 JS 中的导出函数、参数传递方式，以及 JSON 中定义的 \`name\`, \`description\`, \`parameters\` 等字段的对应关系。
2. **插件实现（Implementation）**：
   - 严格遵循示例的架构规则，编写新插件的代码。
   - 确保 JS 逻辑与 JSON 配置文件中的定义（如指令名、参数类型）完全匹配。
3. **部署安装（Deployment）**：
   - 使用 \`writeFile\` 工具 将生成的 JS 和 JSON 文件写入到 \`./extend\` 目录下。
   - 确保文件命名规范且不覆盖已有关键文件。

**约束条件**：
- 必须同时生成 .js 和 .json 两个文件。
- 代码注释需清晰，JSON 格式需合法。
---

第四章：使用场景示例

UI 自动化进阶指南

高级模式指令示例：

“结合 AndroidBot 源码，生成脚本执行以下操作：1. 点击搜索；2. 输入 'Aibote' (XPath: com.ss.android.ugc.aweme:id=et_search_kw)；3. 获取文本...”

AI 视觉与短视频创作

1. 视频分析：

   “使用 AI 视觉分析 C:\Users\Desktop\2.mp4。请详细描述人物特征、面相、穿着、背景及风格。”

2. 脚本创作：

   “根据分析结果编写 8 秒一集的拍摄脚本，包含详细的卡点建议和特写描述。”

3. 批量生成：

   “根据脚本生成视频，比例 16:9，并利用尾帧技术生成后续集，全程使用普通话。”