TinyClaw

创建于 2026年3月22日
更新于 2026年3月22日

超轻量级 OpenClaw 变种,采用 SQLite 存储,支持 Docker 部署。非常适合资源受限环境和家庭服务器使用。

超轻量级 OpenClaw 变种

TinyClaw 是一个极简的 OpenClaw 实现,专注于简单性和低资源占用,同时保持核心功能。它使用 SQLite 进行本地存储,支持 Docker 部署,非常适合家庭服务器和资源受限的环境。

理念:"小即是美"----只包含您需要的功能,没有多余的东西。


为什么选择 TinyClaw?

轻量设计

TinyClaw 专为资源重要的环境设计:

指标TinyClawOpenClaw
内存256MB2GB+
存储50MB500MB+
启动小于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 有多个变种:

实现语言重点
zclawTypeScript原版
tinyclaw-pyPythonPython 生态
tinyclaw-goGo性能

安装方式

方式一: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
├── 共享对话历史
├── 团队知识库
├── 文档辅助
└── 客户服务助手

示例用途

  • 回答常见客户问题
  • 帮助创建文档
  • 内部知识查询
  • 会议纪要总结

系统要求

组件最低要求推荐配置
CPU1 核2 核
内存256MB RAM512MB RAM
存储50MB200MB
操作系统任意(Docker)任意(Docker)
Docker必需必需

与替代方案对比

特性TinyClawOpenClawMicroClawZeroClaw
数据库SQLitePostgreSQL文件内存
Docker✅ 原生⚠️ 手动
Web 界面✅ 内置⚠️ 插件
内存256MB2GB+256MB小于5MB
最适合家庭服务器企业学习边缘

优缺点分析

优点

优势说明
轻量在最小硬件上运行
易部署Docker 一键设置
Web 界面基于浏览器的管理
SQLite无需数据库管理
简单易于理解和使用
免费MIT 许可

局限性

局限性说明
功能有限不如 OpenClaw 功能多
生态较小插件和技能较少
活跃度低开发社区较小
文档基础文档有限

定价

TinyClaw 软件:完全免费(MIT 许可)

额外成本

  • AI API 成本(您自己的 API 密钥)
  • 服务器/托管成本(如果使用云端)

社区和支持


许可证

MIT 许可证 - 个人和商业使用免费。


总结

TinyClaw 是一款超轻量级 AI 助手,提供:

  1. 轻量 -- 256MB 内存,最小存储
  2. SQLite 存储 -- 无需数据库设置
  3. Docker 就绪 -- 一键部署
  4. Web 界面 -- 基于浏览器的管理
  5. 简单 -- 易于理解和使用

适合人群

  • 家庭服务器爱好者
  • 资源受限环境
  • 开发和测试
  • 小型办公室自动化
  • 想要简单性的用户

不推荐

  • 企业需求
  • 复杂自动化需求
  • 大规模部署

信息来源