InnoClaw

# InnoClaw

一个可自托管的 AI 研究助手，灵感来自 Google NotebookLM。将服务器文件夹作为工作空间，基于 RAG 与 AI 对话，内置 206 个科学技能。

A self-hostable AI research assistant inspired by Google NotebookLM. Turn server-side folders into workspaces, chat with AI grounded in your documents via RAG, and leverage 206 built-in scientific skills.

📖 **[完整文档 / Full Documentation](https://zjowowen.github.io/InnoClaw/)** (English & 简体中文)

---

## 概览 / Overview

**核心亮点 / Key Highlights:**
- 🗂️ **工作空间 + 文件管理** — 映射服务器文件夹，支持浏览、上传、编辑
- 🤖 **RAG 增强对话** — AI 基于文档内容回答问题，附带来源引用
- 📝 **智能笔记生成** — 自动生成摘要、FAQ、简报、时间线
- 🔀 **多模型 & 多语言** — OpenAI / Anthropic / Gemini，中英双语，暗色模式
- 💬 **飞书机器人** — WebSocket 长连接，Agent 工具调用，交互卡片实时更新
- 🧠 **上下文管理** — MAX 模式自动摘要防止上下文溢出
- 🔬 **206 个 SCP 科学技能** — 覆盖药物发现、基因组学、蛋白质工程等 8 大领域
- 🛠️ **Skills 系统** — 通过导入 Skills 快速配置飞书机器人、SCP 科学技能等高级功能
- 🗂️ **多 Agent 会话** — 标签式多会话管理，支持重命名、独立上下文
- 📚 **论文研读** — 跨 arXiv / HuggingFace / Semantic Scholar 搜索，AI 智能扩展查询，一键摘要
- 🎓 **论文讨论模式** — 5 角色多智能体结构化讨论（主持人/文献专家/质疑者/复现者/记录员），6 阶段确定性流程

**适用人群：** 研究人员 · 开发者 · 自托管爱好者 · 学生和教育工作者

---

## 快速开始 / Quick Start

> **前置要求：** Node.js >=20.9.0, npm, Git

### 方式一：手动安装（通用） / Manual Setup (Universal)

适用于所有用户，无额外依赖。

Works for all users with no extra dependencies.

#### 第 1 步：克隆并安装 / Clone & Install

```bash
git clone https://github.com/zjowowen/InnoClaw.git
cd InnoClaw
npm install
```

#### 第 2 步：最小配置 / Minimal Configuration

```bash
cp .env.example .env.local
```

编辑 `.env.local`，只需设置两项即可启动：

```env
# [必填] 工作空间根目录（逗号分隔的绝对路径，目录必须已存在）
WORKSPACE_ROOTS=/path/to/your/research,/path/to/your/projects

# [推荐] 至少配置一个 AI API Key（不配置也能启动，但 AI 功能不可用）
OPENAI_API_KEY=sk-xxx
# 或 ANTHROPIC_API_KEY=sk-ant-xxx
# 或 GEMINI_API_KEY=xxx
```

> 完整环境变量列表见 [环境变量参考](#环境变量参考--environment-variables)。

#### 第 3 步：初始化并启动 / Init & Start

```bash
# 创建数据目录 + 初始化数据库
mkdir -p ./data && npx drizzle-kit migrate

# 启动开发服务器
npm run dev
```

打开 **http://localhost:3000** 即可使用。如看到工作空间列表页面，说明安装成功。

---

### 方式二：Claude Code 自动安装（可选） / Auto Setup via Claude Code (Optional)

> **前提条件 / Prerequisites:**
> - 需要已安装 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 工具
> - Claude Code 目前有**地区限制**，部分地区无法安装或使用
> - 如果你无法安装或使用 Claude Code，请使用上面的**方式一手动安装**

如果你已安装 [Claude Code](https://docs.anthropic.com/en/docs/claude-code)，按照以下步骤操作：

If you have [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed, follow these steps:

**第 1 步：克隆仓库 / Step 1: Clone the Repository**

```bash
git clone https://github.com/zjowowen/InnoClaw.git
cd InnoClaw
```

**第 2 步：启动 Claude Code / Step 2: Launch Claude Code**

```bash
claude
```

**第 3 步：在 Claude Code 中运行安装向导 / Step 3: Run the Setup Wizard Inside Claude Code**

在 Claude Code 交互界面中输入：

Type the following in the Claude Code interactive prompt:

```
/setup
```

> **⚠️ 注意 / Note:**
> - 请勿直接在终端运行 `claude /setup`，这不会触发安装向导。
> - Do NOT run `claude /setup` directly in the terminal — this will not trigger the setup wizard.
> - 正确的做法是先用 `claude` 命令进入 Claude Code，再在其中输入 `/setup`。
> - The correct approach is to first enter Claude Code with the `claude` command, then type `/setup` inside it.

`/setup` 会交互式引导你完成：依赖安装 → 环境配置（工作空间路径、AI API Key 等）→ 数据库初始化 → 启动服务。

The `/setup` command interactively guides you through: dependency installation → environment configuration (workspace paths, AI API keys, etc.) → database initialization → server startup.

---

## 通过 Skills 配置高级功能 / Setup Advanced Features via Skills

InnoClaw 的 **Skills 系统**是配置和扩展高级功能的首选方式。启动应用后，访问 `/skills` 页面即可导入和管理技能。

The **Skills system** is the preferred way to configure and extend advanced features. After starting the app, visit `/skills` to import and manage skills.

### 导入方式 / How to Import Skills

**方式一：Web UI（推荐）**
1. 访问 `/skills` 页面 → 点击 **"导入技能"**
2. 输入 GitHub 仓库 URL 或 JSON URL → 确认导入
3. 系统自动发现并批量导入所有技能

**方式二：API**
```bash
curl -X POST http://localhost:3000/api/skills/import \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com/InternScience/scp/tree/main"}'
```

**方式三：本地脚本**
```bash
node scripts/import-local-skills.mjs
```

---

### 配置 SCP 科学技能 / SCP Scientific Skills

[SCP (Science Context Protocol)](https://github.com/InternScience/scp) 提供 **206 个预置科学技能**，通过 [Intern-Discovery 平台](https://scphub.intern-ai.org.cn/) 连接到真实的科学计算服务端点。

| 领域 | 技能数 | 代表性能力 |
|------|:------:|------|
| 💊 药物发现与药理学 | 71 | 靶点识别、ADMET 预测、虚拟筛选、分子对接 |
| 🧬 基因组学与遗传分析 | 41 | 变异致病性评估、癌症基因组学、群体遗传学 |
| 🧬 蛋白质科学与工程 | 38 | 结构预测（ESMFold/AlphaFold）、结合位点分析 |
| 🧪 化学与分子科学 | 24 | 结构分析、分子指纹、构效关系 |
| ⚙️ 物理与工程计算 | 18 | 电路分析、热力学、光学 |
| 🔬 实验自动化与文献挖掘 | 7 | 实验方案生成、PubMed 搜索 |
| 🌍 地球与环境科学 | 5 | 大气科学、海洋学 |

**配置步骤：**

1. 在 [SCP Platform](https://scphub.intern-ai.org.cn/) 注册并获取 API Key
2. 在 `.env.local` 中添加 `SCP_HUB_API_KEY=sk-your-key`，重启服务
3. 访问 `/skills` → 导入 `https://github.com/InternScience/scp/tree/main`

导入完成后，在 Agent 面板用自然语言描述研究目标即可自动调用对应技能：

```
> 识别肺癌的潜在药物靶点，找到 TOP 靶点后从 ChEMBL 获取详细信息
> 分析 p53 蛋白的结构（PDB: 1TUP），计算结构几何参数并评估质量指标
```

---

### 配置飞书机器人 / Feishu Bot Setup

飞书机器人通过 WebSocket 长连接实时接收消息，让用户在飞书中直接与 Agent 交

... (truncated)