$ cat ~/map/piclaw.md

piclaw

社区维护的自托管工作台，把 Pi 打包成带流式 web UI、持久存储、多 provider LLM 支持与内建工具的完整环境。

tools✓ 10月16日

docker run -d --init --name piclaw --restart unless-stopped -p 8080:8080 -e PICLAW_WEB_PORT=8080 -v "$(pwd)/home:/config" -v "$(pwd)/workspace:/workspace" ghcr.io/rcarmo/piclaw:latest

## 速览

把 pi 编程 agent 打包成自托管工作区：三语流式 Web UI，聊天、编辑器、终端、查看器与自动化集于一个容器，SQLite 持久化状态，另有插件生态。

## 要点

• $一个有状态的工作区：支持转向（steering）与排队追问的聊天、CodeMirror 6 编辑器、内建 xterm.js 网页终端、CSV/PDF/图片/视频查看器、文件上传与 VNC 面板——移动端友好，SSE 流式更新。
• $SQLite 持久化——消息、媒体、任务、token 用量、加密钥匙串与会话级 SSH 配置；/workspace/.piclaw/store/messages.db 是文档明示的真相源。
• $内建工具包括代码编辑、浏览器自动化（cdp_browser）、图片处理与 MCP；agent 工作流覆盖旁路提问、定时任务与可视化产物生成。
• $provider 在应用内 /login 配置——支持自定义 OpenAI 兼容端点与本地 llama.cpp 路由预设；凭据复用 pi 自己的存储，无需在环境变量里放 API key。
• $可选能力：Web UI 的 passkey/TOTP 认证、WhatsApp 集成，以及插件注册表（Ghostty 终端、Draw.io、Office 渲染、Windows 自动化、Proxmox、Portainer）。

## 常见问题

## 参考链接

• README（快速开始、挂载、Web UI 导览） ↗
• 插件注册表 ↗
• llama.cpp 路由预设 ↗

最后更新: 2026年8月31日