文章目录
- [1. 项目介绍](#1. 项目介绍)
- [2. 项目地址](#2. 项目地址)
- [3. 使用方法](#3. 使用方法)
-
- [3.1 必要条件](#3.1 必要条件)
- [3.2 详细步骤](#3.2 详细步骤)
-
- [3.2.1 申请大模型服务的API_KEY](#3.2.1 申请大模型服务的API_KEY)
- [3.2.2 申请搜索服务API_KEY](#3.2.2 申请搜索服务API_KEY)
- [3.2.3 配置vpa agent的大模型服务](#3.2.3 配置vpa agent的大模型服务)
- [3.2.4 配置搜索API_KEY](#3.2.4 配置搜索API_KEY)
- [3.2.5 打开ForeRouter AI，并进入左边箭头指向的本地设置](#3.2.5 打开ForeRouter AI，并进入左边箭头指向的本地设置)
- [3.2.6 选择MCP管理菜单](#3.2.6 选择MCP管理菜单)
- [3.2.7 添加 A2A协议以及vpa agent的本地地址](#3.2.7 添加 A2A协议以及vpa agent的本地地址)
- [3.2.8 回到 AI对话 页面，并在技能工具中选择刚才配置的个人助理智能体](#3.2.8 回到 AI对话 页面，并在技能工具中选择刚才配置的个人助理智能体)
- [3.2.9 呼唤你的牛马，让他帮你安装个 openclaw 吧。](#3.2.9 呼唤你的牛马，让他帮你安装个 openclaw 吧。)
- [4. 高级玩法](#4. 高级玩法)
1. 项目介绍
vpa agent 是一个运行在本地的AI助理，其通过执行命令行操作你的个人电脑。
- 大模型擅长思考推理。动脑规划
- AI工具擅长调度协调。指挥干活
- 本项目 vpa agent 擅长执行。干活
2. 项目地址
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 项目