一个把 VPet 做成 OpenClaw AI 桌宠成品体验的开源项目。
目标不是“再塞一个聊天入口”，而是把安装、配置、连接、模型切换和扩展入口都尽量收进同一套桌宠工作流里。

下载最新版 · 安装指南 · 配置模板

项目定位

VpetClaw 想做的不是“给 VPet 装一个 OpenClaw 插件”，而是做成一个新用户也能较顺手上手的 AI 桌宠成品。

• 默认围绕实际使用链路来设计：安装、首次启动、检测连接、补配置、开始聊天。
• OpenClaw 的核心入口已经收敛到桌宠里，而不是让用户到处找脚本和命令。
• 发布包是 Windows x64 自包含版本，运行桌宠本体通常不需要额外安装 .NET。

你会得到什么

模块	现在的成品体验
启动体验	首次启动优先检查 OpenClaw 连接状态，必要时尝试自动拉起网关
桌宠交互	对话输入、回复展示、底部消息区和顶栏输入框都做过产品化调整
菜单结构	底部入口收成 系统 和 VpetClaw 两组，减少重复和学习成本
配置体验	配置 只保留 文件配置、切换模型、打开网关 三条主路径
扩展能力	扩展 里保留技能、飞书、文档、数据目录等进阶能力入口
发布方式	已提供可直接分发的安装包、快捷方式脚本、配置模板和安装指南

新用户上手

3 步开始

1. 从 Releases 下载并解压 VpetClaw.zip
2. 运行 install-vpetclaw.bat
3. 按提示填写 %USERPROFILE%\.openclaw\openclaw.json 后启动桌面快捷方式 VpetClaw

你仍然需要准备的东西

• API Key 你自己的模型供应商密钥，通常只需要在 openclaw.json 里填一次。
• Node.js 18+ 只有在本机启动 OpenClaw 网关时才需要；桌宠本体不是靠 Node 运行的。
• Windows x64 当前发布包按 Windows x64 自包含方式打包。

桌宠内的推荐操作路径

一级入口	二级功能	用途
系统	原有系统能力	保留 VPet 原生系统向功能
VpetClaw -> 配置 -> 文件配置	打开 openclaw.json	首次配置和手动修正最快
VpetClaw -> 配置 -> 切换模型	修改 primary / fallbacks	直接切主模型，不用翻完整配置
VpetClaw -> 配置 -> 打开网关	打开或检查 OpenClaw 网关	用来处理连接、排错、观察状态
VpetClaw -> 扩展	技能、飞书、官方文档、数据目录等	给进阶用户的扩展入口

配置示例

openclaw.json

{
  "models": {
    "providers": {
      "openai": {
        "api": "openai-responses",
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "REPLACE_WITH_YOUR_API_KEY"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5.4",
        "fallbacks": []
      }
    }
  }
}

适合谁

• 想把 VPet 和 OpenClaw 做成一个真正可分发成品的人
• 想减少新用户首次安装和配置成本的人
• 想在桌宠界面里直接管理模型、网关和扩展入口的人
• 想在开源基础上继续二开、继续魔改的人

常见问题

运行桌宠还需要单独安装 .NET 吗？

通常不需要。当前发布包是 Windows x64 自包含版本，桌宠本体已经带上运行时。

为什么还提到 Node.js？

Node.js 是给本机 OpenClaw 网关用的，不是给桌宠本体用的。如果你想让桌宠自动连接并拉起本地 OpenClaw，就需要本机有 Node.js 18+。

为什么我第一次启动还是需要手动配一点东西？

因为模型供应商、接口地址和密钥最终还是你的环境信息。VpetClaw 已经把入口尽量收敛了，但 apiKey 和模型路由仍然需要你自己填写。

如果 OpenClaw 没连上会怎样？

当前默认体验会优先检查连接状态，并尽可能走自动拉起路径。如果网关没有起来，你可以在 VpetClaw -> 配置 -> 打开网关 里快速处理。

开发与二开

解决方案结构

• VpetClaw.sln
• VPet-Simulator.Windows/VPet-Simulator.Windows.csproj
• VPet-Simulator.Windows/OpenClaw/
• scripts/publish-vpetclaw.ps1
• scripts/publish-github.ps1

本地打包

powershell -ExecutionPolicy Bypass -File .\scripts\publish-vpetclaw.ps1

默认输出：

• release\VpetClaw\
• release\VpetClaw.zip

发布到 GitHub

powershell -ExecutionPolicy Bypass -File .\scripts\publish-github.ps1 -RepoName VpetClaw -TagName v0.1.0

这个脚本会：

• 初始化仓库并推送源码
• 调用本地打包脚本生成最新成品
• 创建 GitHub Release
• 上传 VpetClaw.zip、安装指南和配置模板

开源说明

• 本项目基于 VPet 二次开发，并把 OpenClaw 深度接入桌宠工作流
• 当前优先级是“新用户安装简单”和“桌宠内配置集中”
• 欢迎 issue、PR、二开和分支魔改