# micro-claw

**Repository Path**: nachao/micro-claw

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-05-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Micro Claw (Go)

本地个人 AI 助手，支持 CLI 和 Web 两种交互模式。基于 Go 实现，使用纯 Go SQLite 驱动（无需 CGO）。

## 功能特性

- **双模式运行**：CLI 终端交互 / Web 界面访问
- **记忆系统**：短期记忆（episodic）和长期记忆（semantic）
- **技能管理**：自动学习和保存用户定义的技能
- **人格配置**：可自定义 AI 助手的行为风格
- **深度反思**：支持手动/自动触发反思优化
- **工具调用**：支持 Shell 命令执行、网页搜索等
- **心跳监控**：定期后台任务调度

## 环境要求

- Go 1.21 或更高版本
- 有效的 LLM API Key（默认使用 DeepSeek）

## 编译

```powershell
# 设置 GOROOT（如未正确配置）
$env:GOROOT = "C:\Program Files\Go"

# 编译
go build -o micro-claw-go.exe .
```

## 配置

编辑 `config.json` 设置 LLM 参数：

```json
{
  "llm": {
    "provider": "deepseek",
    "base_url": "https://api.deepseek.com",
    "api_key": "YOUR_API_KEY",
    "model": "deepseek-v4-flash",
    "temperature": 0.7,
    "max_tokens": 2048
  },
  "memory": {
    "db_path": "data/memory.db",
    "episodic_limit": 10,
    "semantic_limit": 20
  },
  "web_server": {
    "host": "127.0.0.1",
    "port": 8088
  }
}
```

## 使用方法

### CLI 模式

```powershell
.\micro-claw-go.exe
```

可用命令：
- `/exit` 或 `/quit` - 退出程序
- `/reflect` - 手动触发深度反思
- `/memory` - 查看用户画像和技能数

### Web 模式

```powershell
.\micro-claw-go.exe --web
```

启动后访问：`http://127.0.0.1:8088`

## 人格配置

`persona.md` 用于定义 AI 助手的行为风格。首次启动时会自动迁移到数据库。

默认人格：
```markdown
# Micro Claw 人格配置
你是 Micro Claw，用户的本地个人助手。
- 风格：简洁、实用、主动但不过度打扰
- 当用户要求操作文件或系统时，先确认再执行（除非明显安全）
- 记住用户的偏好，并在后续对话中应用
```

## 数据存储

- `data/memory.db` - SQLite 数据库（记忆、技能、配置）
- 使用 modernc.org/sqlite（纯 Go 实现，跨平台无依赖）

## 项目结构

```
micro-claw-go/
├── main.go              # 程序入口
├── config.json          # 配置文件
├── persona.md           # 人格配置
├── internal/
│   ├── core/           # 核心 Agent 逻辑
│   ├── llm/            # LLM 接口
│   ├── memory/         # 记忆系统
│   ├── tools/          # 工具调用
│   ├── evolve/         # 进化/反思
│   └── webserver/      # Web 服务
└── web/
    └── index.html      # Web 界面
```