TinyClaw

Ultra-lightweight OpenClaw variant with SQLite storage and Docker support. Perfect for resource-constrained environments and home servers.

超轻量级 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/latest

Web 界面

内置 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-stopped

$#3.
Web 门户

功能?

聊天界面
对话历史
设置管理
配置编辑?
系统状?

访问?

安装后：
http://localhost:8080

$#4.
多种实现

TinyClaw 有多个变种：

实现	语言	重点
zclaw	TypeScript	原版
tinyclaw-py	Python	Python 生?
tinyclaw-go	Go	性能

安装方式

方式一：Docker（推荐）

步骤 1：安?Docker

下载：https://www.docker.com/

步骤 2：运?TinyClaw

docker run -d --name tinyclaw \
  -p 8080:8080 \
  -v ./tinyclaw-data:/app/data \
  tinyclaw/latest

步骤 3：访?Web 界面

打开：http://localhost:8080

方式二：源码安装

前置条件?

Node.js 16+（TypeScript 版本?
?Python 3.8+（Python 版本?

TypeScript 版本?

git clone https://github.com/tnm/zclaw
cd zclaw
npm install
npm start

Python 版本?

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 许可