TinyClaw
创建于 2026年3月22日
更新于 2026年3月22日
超轻量级 OpenClaw 变种,采用 SQLite 存储,支持 Docker 部署。非常适合资源受限环境和家庭服务器使用。
超轻量级 OpenClaw 变种
TinyClaw 是一个极简的 OpenClaw 实现,专注于简单性和低资源占用,同时保持核心功能。它使用 SQLite 进行本地存储,支持 Docker 部署,非常适合家庭服务器和资源受限的环境。
理念:"小即是美"----只包含您需要的功能,没有多余的东西。
为什么选择 TinyClaw?
轻量设计
TinyClaw 专为资源重要的环境设计:
| 指标 | TinyClaw | OpenClaw |
|---|---|---|
| 内存 | 256MB | 2GB+ |
| 存储 | 50MB | 500MB+ |
| 启动 | 小于5 秒 | ~30 秒 |
| 复杂度 | 简单 | 复杂 |
SQLite 存储
无需数据库设置:
TinyClaw 使用 SQLite:
├── 单文件数据库
├── 无需安装
├── 零配置
└── 非常适合单用户设置优势:
- ✅ 无需 MySQL/PostgreSQL 设置
- ✅ 无需数据库管理
- ✅ 备份 = 复制一个文件
- ✅ 可离线工作
Docker 就绪
一条命令即可部署:
# 拉取并运行
docker run -d --name tinyclaw \
-p 8080:8080 \
-v ./data:/app/data \
tinyclaw/latestWeb 界面
内置 Web 门户便于管理:
┌─────────────────────────────────┐
│ TinyClaw Web 门户 │
├─────────────────────────────────┤
│ ┌─────────────────────────┐ │
│ │ 聊天界面 │ │
│ │ │ │
│ │ [输入您的消息] │ │
│ │ [发送] │ │
│ └─────────────────────────┘ │
│ │
│ 设置 | 历史记录 | 配置 │
└─────────────────────────────────┘核心特性
1. SQLite 存储
什么是 SQLite?
- 自包含的数据库引擎
- 零配置要求
- 单文件存储
- 被数十亿设备使用
TinyClaw + SQLite:
数据存储:
├── 对话历史
├── 用户偏好
├── 配置
└── 全部在一个 .db 文件中2. Docker 支持
为什么用 Docker?
- 跨平台一致
- 无依赖冲突
- 易于备份和迁移
- 一键部署
Docker Compose 示例:
version: '3'
services:
tinyclaw:
image: tinyclaw/latest
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped3. Web 门户
功能:
- 聊天界面
- 对话历史
- 设置管理
- 配置编辑器
- 系统状态
访问:
安装后:
http://localhost:80804. 多种实现
TinyClaw 有多个变种:
| 实现 | 语言 | 重点 |
|---|---|---|
| zclaw | TypeScript | 原版 |
| tinyclaw-py | Python | Python 生态 |
| tinyclaw-go | Go | 性能 |
安装方式
方式一:Docker(推荐)
步骤 1:安装 Docker
步骤 2:运行 TinyClaw
docker run -d --name tinyclaw \
-p 8080:8080 \
-v ./tinyclaw-data:/app/data \
tinyclaw/latest步骤 3:访问 Web 界面
方式二:源码安装
前置条件:
- Node.js 16+(TypeScript 版本)
- 或 Python 3.8+(Python 版本)
TypeScript 版本:
git clone https://github.com/tnm/zclaw
cd zclaw
npm install
npm startPython 版本:
git clone https://github.com/tinyclaw/tinyclaw-py
cd tinyclaw-py
pip install -r requirements.txt
python main.py方式三:预编译二进制
# 下载适合您的平台
# Windows
curl -O https://github.com/tinyclaw/releases/tinyclaw-windows.exe
# macOS
curl -O https://github.com/tinyclaw/releases/tinyclaw-macos
# Linux
curl -O https://github.com/tinyclaw/releases/tinyclaw-linux
chmod +x tinyclaw-linux配置说明
基本配置
# config.yaml
# 服务器设置
server:
port: 8080
host: 0.0.0.0
# AI 模型设置
model:
provider: openai
api_key: "your-api-key"
model: "gpt-4o-mini"
# 数据库设置
database:
type: sqlite
path: ./data/tinyclaw.db
# 功能设置
features:
web_interface: true
conversation_history: true
file_upload: false使用场景
家庭服务器
场景:在家庭服务器上运行 AI 助手
设置:
家庭服务器(如树莓派、旧电脑)
├── Docker 中的 TinyClaw
├── 家庭网络上任何设备访问
├── 本地数据存储(隐私)
└── 低功耗优势:
- ✅ 始终可用
- ✅ 私密(数据留在家里)
- ✅ 无云依赖
- ✅ 低成本
开发和测试
场景:测试 AI 功能而不需要复杂性
为什么选 TinyClaw?
- 快速设置(5 分钟)
- 简单易理解
- 易于修改
- 清晰的代码库
工作流程:
1. 克隆仓库
2. 进行修改
3. 立即测试
4. 部署到生产小型办公室
场景:小型团队的办公室自动化
设置:
办公室服务器上的 TinyClaw
├── 共享对话历史
├── 团队知识库
├── 文档辅助
└── 客户服务助手示例用途:
- 回答常见客户问题
- 帮助创建文档
- 内部知识查询
- 会议纪要总结
系统要求
| 组件 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 1 核 | 2 核 |
| 内存 | 256MB RAM | 512MB RAM |
| 存储 | 50MB | 200MB |
| 操作系统 | 任意(Docker) | 任意(Docker) |
| Docker | 必需 | 必需 |
与替代方案对比
| 特性 | TinyClaw | OpenClaw | MicroClaw | ZeroClaw |
|---|---|---|---|---|
| 数据库 | SQLite | PostgreSQL | 文件 | 内存 |
| Docker | ✅ 原生 | ✅ | ⚠️ 手动 | ✅ |
| Web 界面 | ✅ 内置 | ⚠️ 插件 | ❌ | ❌ |
| 内存 | 256MB | 2GB+ | 256MB | 小于5MB |
| 最适合 | 家庭服务器 | 企业 | 学习 | 边缘 |
优缺点分析
优点
| 优势 | 说明 |
|---|---|
| 轻量 | 在最小硬件上运行 |
| 易部署 | Docker 一键设置 |
| Web 界面 | 基于浏览器的管理 |
| SQLite | 无需数据库管理 |
| 简单 | 易于理解和使用 |
| 免费 | MIT 许可 |
局限性
| 局限性 | 说明 |
|---|---|
| 功能有限 | 不如 OpenClaw 功能多 |
| 生态较小 | 插件和技能较少 |
| 活跃度低 | 开发社区较小 |
| 文档基础 | 文档有限 |
定价
TinyClaw 软件:完全免费(MIT 许可)
额外成本:
- AI API 成本(您自己的 API 密钥)
- 服务器/托管成本(如果使用云端)
社区和支持
- GitHub:https://github.com/tnm/zclaw
- 问题反馈:https://github.com/tnm/zclaw/issues
- 讨论区:https://github.com/tnm/zclaw/discussions
许可证
MIT 许可证 - 个人和商业使用免费。
总结
TinyClaw 是一款超轻量级 AI 助手,提供:
- 轻量 -- 256MB 内存,最小存储
- SQLite 存储 -- 无需数据库设置
- Docker 就绪 -- 一键部署
- Web 界面 -- 基于浏览器的管理
- 简单 -- 易于理解和使用
适合人群:
- 家庭服务器爱好者
- 资源受限环境
- 开发和测试
- 小型办公室自动化
- 想要简单性的用户
不推荐:
- 企业需求
- 复杂自动化需求
- 大规模部署
信息来源
- TinyClaw GitHub 仓库 - 2025年12月
- 使用 SQLite 为 AI 助手实现内存 - PingCAP - 2025年12月