安装¶
本指南将引导您在本地搭建 InnoClaw，用于开发或自托管。
前置要求¶
在开始之前，请确保已安装以下软件：
要求 |
版本 |
备注 |
|---|---|---|
Node.js |
18+（推荐 20+） |
运行时环境 |
npm |
随 Node.js 一同安装 |
包管理器 |
Git |
任意较新版本 |
GitHub 克隆/拉取功能所需 |
可选：
要求 |
备注 |
|---|---|
AI API 密钥 |
At least one (OpenAI, Anthropic, or Gemini) for AI chat and note generation |
GitHub Token |
用于克隆/拉取私有仓库 |
步骤 1：克隆仓库¶
git clone https://github.com/zjowowen/InnoClaw.git
cd InnoClaw
步骤 2：安装依赖¶
npm install
这将安装所有必需的 Node.js 包，包括 Next.js、AI SDK、数据库驱动程序和 UI 组件。
步骤 3：配置环境变量¶
复制示例环境文件并进行编辑：
cp .env.example .env.local
使用您的配置编辑 .env.local：
# [Required] Workspace root paths (comma-separated absolute paths)
WORKSPACE_ROOTS=/data/research,/data/projects
# [Optional] OpenAI API Key
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
# [Optional] Anthropic API Key
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx
# [Optional] Gemini API Key
GEMINI_API_KEY=your-gemini-key
请参阅环境变量获取所有可用选项的完整参考。
步骤 4：创建工作空间目录¶
确保系统中存在 WORKSPACE_ROOTS 指定的目录：
# Linux / macOS
mkdir -p /data/research /data/projects
# Windows (PowerShell)
mkdir D:/Data/research
mkdir D:/Data/projects
重要
应用程序不会自动创建这些目录。在启动服务器之前，这些目录必须已经存在。
步骤 5：初始化数据库¶
运行数据库迁移以创建 SQLite 数据库：
npx drizzle-kit migrate
这将在 ./data/innoclaw.db 创建包含所有必需表的数据库文件。
步骤 6：启动开发服务器¶
npm run dev
打开浏览器并访问 http://localhost:3000 即可开始使用 InnoClaw。
验证安装¶
启动服务器后，您应该能够：
在首页看到工作空间列表
从已配置的根目录之一创建新的工作空间
在工作空间中浏览和管理文件
如果已配置 API 密钥，可以就您的文件与 AI 进行对话（点击"同步"后）
小技巧
如果您未配置任何 API 密钥，工作空间管理、文件浏览、上传、编辑和 GitHub 克隆功能仍然可用。只有 AI 对话和笔记生成功能会被禁用。