Metadata-Version: 2.4
Name: kangclaw
Version: 0.1.2
Summary: 本地个人AI助手
Author: lvkangk
License-Expression: MIT
Project-URL: Homepage, https://github.com/lvkangk/KangClaw
Project-URL: Repository, https://github.com/lvkangk/KangClaw
Project-URL: Issues, https://github.com/lvkangk/KangClaw/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.24
Requires-Dist: fastapi>=0.135
Requires-Dist: uvicorn[standard]>=0.42
Requires-Dist: websockets>=16.0
Requires-Dist: langchain-core>=1.2
Requires-Dist: langchain-openai>=1.1
Requires-Dist: langchain-anthropic>=1.4
Requires-Dist: langchain-google-genai>=4.2
Requires-Dist: langchain-community>=0.4
Requires-Dist: apscheduler<4,>=3.11
Requires-Dist: ddgs>=9.12
Requires-Dist: qq-botpy>=1.2.1
Requires-Dist: lark-oapi>=1.5
Requires-Dist: dingtalk-stream>=0.24
Requires-Dist: aiohttp>=3.9
Requires-Dist: pdfplumber>=0.11
Requires-Dist: Pillow>=10.0
Requires-Dist: tiktoken>=0.7
Requires-Dist: rich>=14.3
Requires-Dist: prompt-toolkit>=3.0
Requires-Dist: tomli_w>=1.0

<p align="center">
  <img src="images/logo.png" width="280" alt="KangClaw Logo" />
</p>

<h1 align="center">KangClaw</h1>

<p align="center">
  <b>个人AI智能助手</b><br/>
  一个 Gateway，多端接入
</p>

<p align="center">
  <img src="https://img.shields.io/badge/python-≥3.11-blue" alt="Python" />
  <img src="https://img.shields.io/badge/license-MIT-green" alt="License" />
  <img src="https://img.shields.io/badge/version-0.1.0-orange" alt="Version" />
</p>

---

## 特性

- **多模型支持** — OpenAI / Anthropic / Google Gemini / DeepSeek / Ollama 等 LLM 供应商
- **多渠道接入** — 终端 CLI、Web UI、QQ 机器人、飞书机器人、钉钉机器人等
- **内置工具** — 文件读写编辑、Shell 执行、Web 搜索与抓取、定时任务等
- **智能记忆** — 短期记忆 + 长期记忆 + 历史时间线，让智能体记住更多重要信息
- **技能系统** — 通过Skills扩展智能体功能，实现更复杂的任务

## 快速开始

### 安装

```bash
# 方式一：uv
uv tool install kangclaw

# 方式二：pip
pip install kangclaw

# 方式三：从源码安装
git clone https://github.com/lvkangk/KangClaw.git
cd KangClaw
pip install -e .
```

### 初始化

```bash
kangclaw init
```

这会在 `~/.kangclaw/` 下创建配置文件和工作区：

```
~/.kangclaw/
├── config.toml          # 全局配置（模型、渠道、参数等）
└── workspace/
    ├── AGENTS.md        # 智能体行为指令
    ├── SOUL.md          # 助手人格
    ├── USER.md          # 用户画像
    ├── HEARTBEAT.md     # 心跳任务表
    ├── memory/
    │   ├── MEMORY.md    # 长期记忆
    │   └── sessions/    # 会话历史 (JSONL)
    ├── skills/          # 自定义技能
    └── cron/            # 定时任务
```

### 启动网关

```bash
# 前台启动 gateway
kangclaw gateway
```

### 打开 Web UI
```bash
kangclaw web
```
或者直接在浏览器访问 [http://127.0.0.1:12255/](http://127.0.0.1:12255/)

## Web UI 功能

打开 Web UI 后，左侧导航栏提供以下功能：

### 聊天
与 AI 助手实时对话。(需先完成模型配置)

<img src="images/chat.png" width="800" />

### 模型配置
选择和配置 LLM 供应商，设置 API Key、模型名称、上下文长度等参数。

<img src="images/model.png" width="800" />

### 消息频道
配置多端接入渠道（QQ 机器人、飞书机器人、钉钉机器人），填写对应的凭证信息即可启用。

<img src="images/channel.png" width="800" />

### 技能管理
查看和管理已安装的技能，扩展 AI 助手的能力。

<img src="images/skills.png" width="800" />

### 定时任务
查看AI 助手创建的 Cron 定时任务。

<img src="images/cron.png" width="800" />

### 心跳巡检
查看心跳任务，AI 助手会定期检查任务列表并自动执行。

<img src="images/heartbeat.png" width="800" />

### 其他配置

<img src="images/other.png" width="800" />

## CLI 命令速查表

| 命令 | 说明 |
|------|------|
| `kangclaw init` | 初始化配置和工作区 |
| `kangclaw gateway` | 启动 gateway 服务（前台） |
| `kangclaw gateway -d` | 后台启动 gateway |
| `kangclaw gateway status` | 查看 gateway 状态 |
| `kangclaw gateway stop` | 停止 gateway |
| `kangclaw gateway restart` | 重启 gateway |
| `kangclaw chat` | 终端对话客户端 |
| `kangclaw web` | 打开 Web UI |
| `kangclaw status` | 查看整体状态 |
| `kangclaw skills list` | 列出已安装技能 |
| `kangclaw cron list` | 查看定时任务 |
| `kangclaw cron remove <id>` | 删除定时任务 |


## 更新

```bash
# 方式一：uv
uv tool upgrade kangclaw

# 方式二：pip
pip install --upgrade kangclaw
```
