English | 简体中文
OpenClaw 开发工具箱是为 OpenClaw 量身定制的容器化开发环境。一键启动，秒级进入 AI 辅助编程与自动化工作状态。
- 📦 一键就绪：基于 Docker Compose，屏蔽繁琐依赖
- 🧩 1+3 阶梯架构：采用高效的「1个基座 + 3类堆栈」设计，极致 DRY
- 🧠 AI 原生集成：内置 Claude Code、OpenCode、Pi-Mono
- 🔧 开箱即用：预配置开发环境，无需手动搭建
- 🚀 快速启动：一键部署，分秒间启动完整开发栈
- 🔒 安全隔离：容器化运行，环境隔离安全可控
- 💾 数据持久化：会话、配置自动保存，重启不丢失
- Docker: V2 (Docker Desktop for macOS/Windows, Docker Engine for Linux)
- Docker Compose: V2 (内置于 Docker Desktop)
- Make: macOS/Linux 自带，Windows 用户强烈推荐安装并使用 Git Bash（Windows 原生命令行存在兼容性问题）
| 组件 | 要求 | 说明 |
|---|---|---|
| 操作系统 | Windows 10 21H2+ 或 Windows 11 | |
| 后端引擎 | WSL2 (推荐) 或 Hyper-V | 安装指南 |
| 内存 | 推荐 8GB+ | Docker Desktop 最低 4GB |
| 虚拟化 | 需在 BIOS/UEFI 中启用 | Intel VT-x / AMD-V |
Tip
Windows 推荐使用 Docker Desktop 基于 WSL2 后端运行（性能更佳）。若使用 WSL2，需在 PowerShell 中执行以下命令启用：
wsl --install(注：Windows 10/11 专业版及更高版本用户也可选择使用传统的 Hyper-V 后端，此时无需安装 WSL2。)
适用于大多数用户，直接从 GitHub 注册表拉取经过优化的预构建镜像，无需本地编译。
# 1. 克隆项目
git clone https://github.com/hrygo/openclaw-devkit.git
cd openclaw-devkit
# 2. 一键安装并初始化 (极速模式)
make install
# 3. 首次配置（必做）
make onboard
# 4. 访问 Web UI
# 浏览器打开 http://127.0.0.1:18789Note
make install 会自动完成：创建数据目录、生成 .env 配置、拉取最新镜像以及修复宿主机权限。
如果您需要特定环境，可以在安装时指定（或修改 .env 中的 OPENCLAW_IMAGE）：
| 版本 | 安装命令 | 说明 |
|---|---|---|
| 标准版 | make install |
默认版本 (Node + Python + Playwright) |
| Go 增强版 | make install go |
在标准版基础上集成 Go 1.26 + 常用工具 |
| Java 增强版 | make install java |
含 JDK 21 + Gradle + Maven |
| Office 旗舰版 | make install office |
专注 RAG 预处理：pandoc + LaTeX + OCR |
| 步骤 | 命令 | 说明 |
|---|---|---|
| 1️⃣ 启动 | make up |
启动容器服务 |
| 2️⃣ 配置 | make onboard |
交互式配置 LLM、飞书、频道等 |
| 3️⃣ 访问 | http://127.0.0.1:18789 | Web 控制台 |
| 指令 | 描述 |
|---|---|
make up / down |
启动 / 停止服务 |
make onboard |
交互式配置向导 |
make status |
查看运行状态 |
make logs |
查看实时日志 |
make shell |
进入容器 Shell |
make update |
更新 OpenClaw 源码 |
📖 更完整的命令说明 → 详细参考手册
Q: 启动后显示"无法连接"？
确保代理开启「允许局域网」连接，运行 make test-proxy 诊断网络。
Q: 如何切换版本？
# Go 开发版
make rebuild go
# Java 增强版
make rebuild java
# Office 办公版
make rebuild officeQ: 配置文件在哪？
容器内 ~/.openclaw/，宿主机通过 openclaw-state 卷持久化。
基于 OpenClaw 原始许可。