# myOpenClaw

**Repository Path**: AllenXu2020/my-open-claw

## Basic Information

- **Project Name**: myOpenClaw
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能机器人接入系统

基于 Groq API 的免费 AI 对话系统，实现类似 OpenClaw 的功能。

## 功能特性

- 🤖 智能对话：基于 Llama3 模型的 AI 助手
- 💰 完全免费：使用 Groq 的免费 API
- 🌐 Web 界面：简洁美观的对话界面
- ⚡ 快速响应：Groq 提供极快的推理速度
- 🔒 安全可靠：前后端分离架构

## 技术栈

### 后端
- Node.js + Express
- Groq API (免费)
- axios (HTTP 客户端)

### 前端
- Vite + Vue 3
- 原生 JavaScript（无需构建）
- 渐变设计风格

## 快速开始

### 1. 获取免费 API Key

访问 [Groq Console](https://console.groq.com/) 注册并获取免费 API Key：
- Groq 提供免费的开发者访问权限
- 使用 Llama3-8b-8192 模型（完全免费）
- 支持每秒数百个 token 的推理速度

### 2. 配置环境变量

在后端目录创建 `.env` 文件：

```bash
cd backend
cp .env.example .env
```

编辑 `.env` 文件，填入你的 API Key：

```
PORT=3001
GROQ_API_KEY=your_api_key_here
GROQ_MODEL=Llama3-8b-8192
```

### 3. 安装依赖

```bash
# 后端
cd backend
npm install

# 前端
cd ../frontend
npm install
```

### 4. 启动服务

```bash
# 后端（终端 1）
cd backend
npm run dev

# 前端（终端 2）
cd frontend
npm run dev
```

访问 http://localhost:3000 即可使用。

## 项目结构

```
smart-robot/
├── backend/
│   ├── src/
│   │   └── server.js          # 后端服务
│   ├── package.json
│   └── .env.example           # 环境变量模板
└── frontend/
    ├── index.html             # 前端页面
    ├── vite.config.js         # Vite 配置
    └── package.json
```

## API 接口

### POST /api/chat

发送消息给 AI 助手。

**请求体：**
```json
{
  "message": "你好，请介绍一下自己"
}
```

**响应：**
```json
{
  "success": true,
  "response": "你好！我是智能机器人助手..."
}
```

### GET /api/health

健康检查接口。

## 免费资源

### Groq API
- 免费开发者访问
- 支持 Llama3 系列模型
- 极快的推理速度
- 每月充足的免费额度

### 其他免费 AI API（备用方案）

如果 Groq 额度用完，可尝试：

1. **Hugging Face Inference API**
   - 免费开源模型
   - https://huggingface.co/docs/api-inference/index

2. **Ollama 本地部署**
   - 完全免费，无需 API Key
   - https://ollama.com/
   - 支持多种开源模型

3. **Together AI**
   - 提供免费试用额度
   - https://together.ai/

## 未来扩展

- [ ] 语音输入/输出（Web Speech API）
- [ ] 多轮对话上下文管理
- [ ] 知识库集成（RAG）
- [ ] 多模型支持切换
- [ ] 对话历史保存
- [ ] 移动端适配

## 许可证

MIT License

## 致谢

- Groq - 提供快速免费的 AI 推理服务
- Llama3 - Meta 开源的大语言模型