# xclaw

**Repository Path**: uesoft/xclaw

## Basic Information

- **Project Name**: xclaw
- **Description**: 使用 C 语言开发的龙虾客户端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xclaw

轻量级 AI Agent 平台，基于 C 语言和 xrt 运行时库开发。

## 项目简介

xclaw 是一个参考 OpenClaw 设计的本地 AI Agent 平台，支持多种控制方式（CLI、HTTP API、Telegram）、多种 AI Provider（OpenAI、Claude、Ollama）以及丰富的工具调用能力。

## 功能特性

- 🤖 **Agent 核心循环** - Plan → Act → Observe 智能执行
- 🔌 **多 Provider 支持** - OpenAI、Claude、Ollama
- 🛠️ **Tool Calling** - 文件操作、命令执行、网络请求
- 💬 **多控制方式** - CLI、HTTP API、Telegram Bot
- 💾 **会话持久化** - SQLite 存储
- 🧠 **长期记忆** - Markdown 文件记忆
- ⏰ **定时任务** - Cron 调度

## 快速开始

### 编译

```bash
# Windows (TCC)
build_TCC.bat

# Windows (GCC)
build_GCC.bat

# Linux
bash build.sh
```

### 运行

```bash
# CLI 模式
xclaw

# 指定配置文件
xclaw -c config/xclaw.json
```

## 配置

编辑 `config/xclaw.json` 配置 Provider 和 Channel：

```json
{
	"providers": [
		{
			"id": "openai",
			"api_key": "${OPENAI_API_KEY}",
			"model": "gpt-4o"
		}
	]
}
```

## 目录结构

```
xclaw/
├── src/           # 源代码
│   ├── core/      # 核心模块
│   ├── provider/  # Provider 层
│   ├── channel/   # Channel 层
│   ├── tool/      # Tool 层
│   ├── memory/    # Memory 层
│   └── cron/      # 定时任务
├── include/       # 头文件
├── lib/xrt/       # xrt 依赖
├── config/        # 配置文件
├── data/          # 数据目录
└── docs/          # 文档
```

## 文档

- [产品设计](产品设计.md) - 完整设计方案

## 依赖

- [xrt](https://gitee.com/xywhsoft/xrt) - C 语言运行时库
- [xserver](https://gitee.com/xywhsoft/xserver) - HTTP 服务器 (可选)

## 许可证

MIT License