Skip to content

gaopengbin/lite-claw

Repository files navigation

Lite-Claw 🦞

轻量级本地 AI Agent 框架,兼容 OpenClaw 技能格式,支持 MCP 协议。

✨ 特性

  • 🔌 MCP 协议 - 双向支持,既能调用外部 MCP 服务,也能作为 MCP 服务端
  • 🧠 记忆系统 - 短期对话历史 + 长期向量记忆(SQLite + Embedding)
  • 🦞 技能扩展 - 兼容 OpenClaw SKILL.md 格式,支持从 GitHub 安装技能
  • 📡 多渠道 - CLI / Web 界面 / 飞书
  • 🤖 多模型 - 支持 Ollama、OpenAI 兼容 API(Qwen、DeepSeek 等)
  • 🖥️ 桌面应用 - Tauri 打包,跨平台运行
  • 🛠️ Function Calling - 原生支持工具调用

🚀 快速开始

安装

pnpm install

启动 Agent

# CLI 模式(命令行交互)
pnpm agent start -c cli

# Web 模式(浏览器界面)
pnpm agent start -c web

# 开发模式(Web + 前端热更新)
pnpm dev

配置

编辑 config/agent.yaml

ai:
  provider: ollama
  model: qwen2.5:32b
  baseUrl: http://localhost:11434/v1

skills:
  - shell          # 执行系统命令
  - read-file      # 读取文件
  - write-file     # 写入文件
  - list-dir       # 列出目录
  - open-url       # 打开网页

channels:
  cli:
    enabled: true
  web:
    enabled: true

memory:
  enabled: true
  dbPath: ./data/memory.db

📦 内置技能

技能 说明
shell 执行系统命令
read-file 读取文件内容
write-file 写入文件
list-dir 列出目录
open-url 打开网页/截图
publish-blog 生成并发布博客到掘金
generate-blog 生成博客(不发布)

🦞 OpenClaw 技能

支持 OpenClaw/Moltbot 格式的 SKILL.md 技能:

# 技能放在 skills/openclaw/ 目录下,自动加载
skills/openclaw/
├── web-search/
│   └── SKILL.md
├── youtube-transcript/
│   └── SKILL.md
└── ...

从 GitHub 安装技能(通过 Web 界面或 API)。

🔌 MCP 支持

作为 MCP 客户端(调用外部工具)

# config/agent.yaml
mcp:
  enabled: true
  servers:
    - name: filesystem
      command: npx
      args: ["-y", "@modelcontextprotocol/server-filesystem", "C:/"]
    - name: github
      command: npx
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_TOKEN: "your-token"

作为 MCP 服务端(暴露技能)

pnpm agent mcp

然后在 Claude Desktop 或 Cursor 中配置:

{
  "mcpServers": {
    "lite-claw": {
      "command": "npx",
      "args": ["tsx", "/path/to/src/agent.ts", "mcp"]
    }
  }
}

🖥️ 桌面应用

# 开发
pnpm tauri:dev

# 构建
pnpm tauri:build

📁 项目结构

lite-claw/
├── src/
│   ├── agent.ts        # Agent 入口
│   ├── core/           # 核心:Agent、类型、配置、加载器
│   ├── ai/             # AI Provider(Ollama/OpenAI)
│   ├── skills/         # 内置技能
│   ├── channels/       # 渠道(CLI/Web/飞书)
│   ├── mcp/            # MCP 客户端/服务端
│   ├── memory/         # 记忆系统
│   └── publishers/     # 博客发布器
├── skills/openclaw/    # OpenClaw 格式技能
├── frontend/           # Web 前端(Vue)
├── src-tauri/          # Tauri 桌面应用
├── config/             # 配置文件
└── data/               # 数据(记忆数据库)

🔧 命令

pnpm agent start          # 启动 Agent
pnpm agent start -c cli   # CLI 模式
pnpm agent start -c web   # Web 模式
pnpm agent mcp            # 启动 MCP 服务
pnpm agent init           # 初始化配置
pnpm dev                  # 开发模式
pnpm tauri:dev            # Tauri 开发
pnpm tauri:build          # 构建桌面应用

License

MIT

About

轻量级本地 AI Agent 框架,支持 MCP 协议、Function Calling、记忆系统

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors