🏆 打包后仅 ~2 MB —— 全网最小的本地 AI 智能体，单文件发布、秒级启动，插U盘就能跑。
PiPiClaw (皮皮虾) 是一款运行在你自己的设备上的个人 AI 智能管家，基于 OpenAI 接口规范，默认示例使用 Qwen，但也可对接任何兼容 OpenAI 协议的 LLM（如 OpenAI/Azure OpenAI、通义千问、DeepSeek、Moonshot、SiliconFlow、Together 等）。通过终端和内置 Web 控制台，它能在 Windows、macOS、Linux 上陪伴你的工作流，实时渲染由你控制的命令与任务画面——网关只是管理入口，真正执行的是在你机器上常驻的助手本体。
- 不止运维：它是全能的本地智能体，能编排开发、自动化、数据处理、信息检索等任意任务。
- 原生对接 Skill-Hub，一键搜索并安装 10,000+ 生态技能，无限扩展能力版图。
如果你想要一个像本地助手一样、速度快、始终在线的AI 助手，PiPiClaw 正好契合这一需求。
推荐设置：直接在终端运行
dotnet run，首次启动会引导你完成 API Key、模型与 Web 控制台的配置（支持任意 OpenAI 协议兼容的服务）；也可以用自包含 AOT 发布（dotnet publish -c Release -r win-x64|osx-x64|linux-x64 --self-contained true），在 macOS、Linux、Windows（含 WSL2）上即装即用。全新安装可以从下方「快速开始」走起。
桌面端设置页可自由添加任意 OpenAI 协议兼容的模型与 Endpoint，轻松切换 Qwen、DeepSeek、Moonshot、OpenAI/Azure 等不同 LLM。
| 功能 | 描述 |
|---|---|
| 🔧 命令执行 | 跨平台终端命令执行 (ls, git, npm, docker, systemctl 等) |
| 📄 文件读取 | 智能读取文本、代码、配置文件内容，自动检测编码 (UTF-8/GBK) |
| ✍️ 文件写入 | 自动生成代码、配置文件并写入本地，支持局部修改 |
| 🖼️ 图片分析 | 支持本地截图、照片的识别与分析 (Base64 编码) |
| 🔍 内容搜索 | 在指定目录下搜索包含特定关键字的文件 (函数名、变量名、类名等) |
| ⏰ 定时任务 | 支持一次性/周期性任务调度，持久化存储，自动执行 |
| 🧩 技能扩展 | 支持从 Skill-Hub 搜索和安装扩展技能，无限拓展能力 |
| 🌐 Web 控制台 | 内置轻量级 Web UI (端口 5050)，支持浏览器远程操控 |
| 🧠 记忆管理 | 多轮对话上下文记忆，任务完成后自动清理节省 Token |
| 🔐 权限处理 | 智能 sudo 提权拦截，自动处理密码输入 (非 Windows) |
- .NET 10.0 SDK 或更高版本
- 任意 OpenAI 协议兼容 的 API Key（示例：OpenAI/Azure OpenAI、阿里云 DashScope、DeepSeek、Moonshot、SiliconFlow、Together AI 等）
# 克隆项目
git clone https://github.com/anan1213095357/PiPiClaw.git
cd PiPiClaw
# 还原依赖
dotnet restore
# 运行项目
dotnet run首次运行时会自动生成 appsettings.json 配置文件，按提示输入 API Key 即可。
# 发布 AOT 编译版本（单文件、高性能）
dotnet publish -c Release -r win-x64 --self-contained true
dotnet publish -c Release -r osx-x64 --self-contained true
dotnet publish -c Release -r linux-x64 --self-contained true首次运行会自动生成，内置
Models列表可在 Web 控制台中增删并下拉切换。
{
"Models": [
{
"ApiKey": "sk-your-actual-api-key-here",
"Model": "qwen3.5-plus",
"Endpoint": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
}
],
"SudoPassword": "",
"WebPort": 5050
}| 配置项 | 说明 |
|---|---|
Models |
模型配置列表，首个为默认模型，Web UI 下拉实时切换 |
Models[].ApiKey |
任意 OpenAI/兼容接口的 API Key（示例为 DashScope） |
Models[].Model |
使用的 AI 模型 (默认示例 qwen3.5-plus，可填 DeepSeek/Moonshot/GPT 等) |
Models[].Endpoint |
OpenAI 协议兼容的 API 端点地址 |
SudoPassword |
(可选) Linux/macOS 自动提权密码 |
WebPort |
Web 控制台端口 (默认 5050) |
# macOS / Linux
export ApiKey="sk-your-api-key-here"
export Model="qwen3.5-plus"
export Endpoint="https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
export WebPort=5050
export SudoPassword=""
# Windows PowerShell
$env:ApiKey="sk-your-api-key-here"
$env:Model="qwen3.5-plus"
$env:Endpoint="https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"
$env:WebPort="5050"
$env:SudoPassword=""环境变量名与配置字段一致（区分大小写），适合容器或临时覆盖。
以上为 DashScope 示例，请将
Model与Endpoint替换为你所使用的 OpenAI 兼容服务（OpenAI/Azure/DeepSeek/Moonshot 等）的地址。
启动 PiPiClaw 后，你可以输入各种自然语言指令：
> 帮我扫描一下当前目录，看有没有 C# 相关的源码文件
> 读取 package.json 的内容并分析依赖
> 执行 git status 查看当前仓库状态
> 帮我查一下系统当前的内存占用情况，并把结果写进 memory_log.txt
> 创建一个名为 config.json 的配置文件，包含数据库连接信息
> 把 main.cs 里的所有 Console.WriteLine 替换成 Debug.WriteLine
> 每天下午 3 点，帮我屏幕截图看一下我在干什么
> 每隔 30 分钟检查一次 CPU 使用率，超过 80% 就记录到日志
> 帮我搜索 weather 相关的技能
> 安装 calendar 技能
PiPiClaw/
├── Program.cs # 主程序入口 (全部逻辑)
├── PiPiClaw.csproj # 项目配置文件
├── README.md # 项目说明文档 (中文)
├── README_EN.md # 项目说明文档 (英文)
├── .gitignore # Git 忽略规则
├── appsettings.json # 配置文件（本地使用，不提交）
├── appsettings.example.json # 配置模板（可提交）
├── Properties/ # 项目属性配置
├── bin/ # 编译输出目录
├── obj/ # 临时构建文件
├── logs/ # 日志目录
├── skills/ # 扩展技能目录 (自动创建)
├── pi_history.json # 对话记忆存档
└── pi_scheduled_tasks.json # 定时任务存档
| 组件 | 技术选型 |
|---|---|
| 运行时 | .NET 10.0 |
| 编译优化 | AOT (Ahead-of-Time) 编译 |
| AI 模型 | OpenAI 协议兼容 LLM（示例：Qwen、DeepSeek、Moonshot、OpenAI/Azure 等） |
| HTTP 客户端 | System.Net.Http |
| JSON 处理 | System.Text.Json |
| 编码支持 | UTF-8 / GBK 自动检测 |
- ✅ AOT 编译 - 更小的体积、更快的启动速度
- ✅ 极致轻量 - 发布包仅 ~2 MB，随身携带、秒开即用
- ✅ 跨平台 - 支持 Windows、Linux、macOS
- ✅ 流式对话 - 支持多轮上下文对话
- ✅ 工具调用 - 10+ 内置工具智能调度
- ✅ 定时调度 - 持久化任务队列，自动循环执行
- ✅ Web UI - 内置 HTTP 服务器，浏览器远程操控
- ✅ 技能系统 - 支持在线搜索和安装扩展技能
- ✅ 错误处理 - 完善的异常捕获与提示
- ✅ 安全配置 - API Key 与代码分离，支持环境变量
- ✅ 日志压缩 - 自动折叠相似日志行，节省 Token
PiPiClaw 内置轻量级 Web UI，启动后自动监听 http://localhost:5050
功能特性：
- 📱 响应式设计，支持手机/平板访问
- 🎨 赛博朋克风格界面
- 📡 实时流式输出工具调用过程
- ⏰ 定时任务可视化查看
- 🔧 在线配置 / 切换多模型（API Key / 模型下拉）
- 📷 左下角二维码，手机扫码即连
- API Key 安全:
appsettings.json已加入.gitignore，请勿手动提交包含真实 Key 的文件 - 命令执行权限: 工具执行的命令具有与当前用户相同的权限，请谨慎操作
- 网络依赖: 需要稳定的网络连接以调用 AI 服务
- Token 限制: 大文件读取会自动截断，防止 Token 溢出
- 文件修改: 修改现有文件时，请确保提供精确的 old_content 进行替换
- Windows 提权: Windows 环境下无法自动处理 sudo，请以管理员身份运行程序
欢迎提交 Issue 和 Pull Request！
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
本项目采用 MIT 许可证 开源。
Made with ❤️ by 奶茶叔叔
如果这个项目对你有帮助，请给一个 ⭐ Star 支持一下！