/
🦎

VClaw Agent 威龙虾

一个持久运行、浏览器可访问的 AI 智能体技术栈，运行在你自己的基础设施上 — 基于 pi.dev 动力。

🤖 Pi Agent 🌐 PI WEB 📦 VClawOS SDK 🔗 NATS Mesh

什么是 VClaw Agent？

VClaw Agent 是 VClaw 生态的客户端应用发行版——一套完整的、自托管的 AI 智能体技术栈，运行在你自己的硬件上。基于 pi.dev 的 Pi Agent 编程挂载（harness），通过 PI WEB 控制，为你提供一个持久运行、浏览器可访问的智能体工作空间，任何设备随时可达。

与纯云端助手不同，VClaw Agent 常驻在你的基础设施上——NanoPi、树莓派或迷你 PC——具备联网搜索、PDF 阅读、语音合成、图像生成和视频制作等扩展技能。

架构

分离式进程架构：浏览器 UI → PI WEB → 会话守护进程 → Pi Agent + 技能

浏览器
笔记本 · 台式机 · 平板 · 手机
⬇ HTTPS + WebSocket
控制平面
PI WEB · Fastify HTTP · WebSocket 代理
⬇ Unix socket / TCP
会话守护进程
持有活跃的 Pi SDK 运行时 · 浏览器断开也不丢失
⬇ Pi SDK
智能体引擎
Pi Agent (pi-mono) · @earendil-works/pi-coding-agent
🔍 Tavily Search 📄 PDF Reader 🔊 Edge TTS 🎨 Kolors 🎬 Hyperframes

平台支持

VClaw Agent 覆盖三种平台系列——用你现有的设备部署，随需求扩展。

📡

NanoPi

arm64 · 1 GB RAM
  • Pi Agent + PI WEB
  • CPU 技能
  • Tailscale 组网
  • 自动更新
🫐

树莓派

arm64 · 4–8 GB RAM
  • Pi Agent + PI WEB
  • CPU 技能
  • 可选 HDMI 显示
  • Hyperframes (树莓派 5)
🖥️

x86-64 迷你 PC

amd64 · 8–64 GB RAM
  • 完整技术栈 + GPU
  • Ollama / 本地 LLM
  • Docker + PostgreSQL
  • NATS JetStream

VClawOS — 构建你自己的智能体

除了预构建的完整技术栈，@vclawos npm 包还能让任意 TypeScript 进程注册到 vgate NATS 网络中，成为一等 VClaw 智能体。

@vclawos/handler

全生命周期：注册 → 认证 → NATS → 服务提示词

@vclawos/sdk

自定义智能体，直接访问 NATS、心跳与配置同步

@vclawos/pi-extension

LLM 可调用的委托、发现和钱包查询工具

@vclawos/cli

命令行智能体管理器：配置、认证登录、启动智能体

@vclawos/bridge

通过 NATS 代理 pi-web 远程节点——无需 VPN

@vclawos/pi-web-plugin

带设备发现功能的 PI WEB 浏览器插件

快速开始

VClaw Agent 源码仓库 源代码、发布版本与文档 📖 Pi Agent 开发文档 核心智能体编程挂载文档 💬 VClaw Chat SPA 面向你的智能体的浏览器聊天客户端