1. 项目介绍

vpa agent 是一个运行在本地的AI助理，其通过执行命令行操作你的个人电脑。

• 大模型擅长思考推理。动脑规划
• AI工具擅长调度协调。指挥干活
• 本项目 vpa agent 擅长执行。干活

2. 项目地址

vpa agent 会玩电脑的AI智能体项目地址

3. 使用方法

3.1 必要条件

• 大模型 API_KEY，可以选择任何一个兼容OpenAI的大模型服务
• 搜索服务，推荐使用Tavily，有免费额度，个人使用几乎不花钱
• 支持MCP或A2A协议的工具，下文使用ForeRouter AI举例

3.2 详细步骤

3.2.1 申请大模型服务的API_KEY

以阿里云百炼平台为例，可以使用其他平台，例如火山引擎，百度千帆，智谱清言，硅基流动，OpenAI，OpenRouter等。选择模型时，一定要选择支持工具调用的模型。

3.2.2 申请搜索服务API_KEY

以Tavily 搜索服务为例，个人使用免费额度搜索服务，基本够用

3.2.3 配置vpa agent的大模型服务

第一个 openai 为文本模型，第二个openai_vision 是多模态模型，如果不涉及到图像理解，可不需要配置 openai_vision 模型

3.2.4 配置搜索API_KEY

default_provider 设置为 tavily，并设置 tavily 的 api_key。search_depth 为 advanced 为高级搜索，结果更详细。推荐使用这个选项。

3.2.5 打开ForeRouter AI，并进入左边箭头指向的本地设置

本地设置的内容不会上传云端，只会存储在浏览器本地。切换浏览器或切换电脑不会同步更新，这样做的目的是尽可能保证敏感信息不上云。

3.2.6 选择MCP管理菜单

3.2.7 添加 A2A协议以及vpa agent的本地地址

默认是 http://localhost:31889 点击发现可自动填充 名称 和 描述

3.2.8 回到 AI对话 页面，并在技能工具中选择刚才配置的个人助理智能体

注意第一个选择框需要配置大语言模型，如果不想配置，可注册账号，系统默认提供千问3-8B模型用于体验。

3.2.9 呼唤你的牛马，让他帮你安装个 openclaw 吧。

4. 高级玩法

通过AI工具管理一群牛马。vpa agent 支持mode有三种，分别是 local，gateway，agent。

• gateway：只负责协调，并中转指令，不去执行具体的操作指令
• agent：某个具体的设备，具体执行指令的设备。
• local：gateway和agent合体，通常用于单体设备独立管理
  
  详细的部署模式请参考 vpa agent 项目