开源AI工作流

快速开始

TeamClaw 依赖 PostgreSQL、Redis、RAG service 和 Docker socket，不支持单独 docker run 启动。生产或试用请优先使用 setup.sh。

生产/试用部署

前置要求：

• Docker 与 Docker Compose v2
• git、openssl、curl
• Linux 上运行脚本的用户需要能访问 Docker daemon

git clone https://github.com/szsip239/teamclaw.git
cd teamclaw
bash setup.sh

setup.sh 会完成：

• 从 .env.example 创建 .env
• 只在空值或占位符时生成 JWT、加密密钥、数据库密码、RAG 内部密钥和初始管理员密码；复跑时保留已有值
• 自动设置 TEAMCLAW_DATA_DIR，Linux 下自动检测 DOCKER_GID
• 可选配置 Nginx HTTPS
• 启动 docker-compose.prod.yml，运行数据库迁移和 seed
• 检查 Web 服务是否可访问

访问 http://localhost:3100。初始管理员邮箱和密码会在 setup.sh 完成时打印，也会写入 .env：

• INITIAL_ADMIN_EMAIL
• INITIAL_ADMIN_PASSWORD

手动生产部署

仅当你不想使用交互式脚本时使用。请先准备好 .env 中的密钥、端口和数据目录：

```bash cp .env.example .env node scripts/generate-keys.mjs --write

Production / Trial Deployment

Requirements:

• Docker and Docker Compose v2
• git, openssl, curl
• On Linux, the current user must be able to access the Docker daemon

git clone https://github.com/szsip239/teamclaw.git
cd teamclaw
bash setup.sh

setup.sh will:

• Create .env from .env.example
• Generate JWT/encryption secrets, database password, RAG internal secret, and initial admin password only when values are missing or placeholders; reruns preserve existing values
• Set TEAMCLAW_DATA_DIR and auto-detect DOCKER_GID on Linux
• Optionally configure Nginx HTTPS
• Start docker-compose.prod.yml, run DB migrations, and seed the admin user
• Verify that the web app responds

Open http://localhost:3100. The initial admin email and password are printed by setup.sh and written to .env:

• INITIAL_ADMIN_EMAIL
• INITIAL_ADMIN_PASSWORD

Manual Production Deployment

Use this only if you do not want the interactive setup script:

```bash cp .env.example .env node scripts/generate-keys.mjs --write

首次使用流程

1. 进入 资源管理，创建模型资源并设置默认模型。
2. 进入 实例管理，创建 Docker 实例或接入外部 gateway。默认普通 runtime 镜像是 alpine/openclaw:2026.6.6-browser。
3. 实例上线后进入 AI 对话，选择 Agent 开始对话。
4. 需要知识库时，在 知识库 页面配置 RAG LLM、Embedding、Rerank 和 PaddleOCR。
5. 需要 Skills 时，在 Skills 管理 中搜索、安装或编辑。

Quick Start

TeamClaw requires PostgreSQL, Redis, the RAG service, and Docker socket access. Standalone docker run is not supported. Use setup.sh for production or trial deployments.

界面截图

仪表盘	AI 对话
Agent 管理	Skills 管理
实例管理	配置编辑器

Screenshots

Dashboard	AI Chat
Agent Management	Skills
Instance Management	Config Editor

编辑 .env：TEAMCLAW_DATA_DIR、可选 Nginx 证书配置

docker compose -f docker-compose.prod.yml up -d --build docker compose -f docker-compose.prod.yml logs -f app

启用 Nginx HTTPS 时，把证书放到 `nginx/cert/`，设置 `.env` 中的 `NGINX_*`，再启动：

如果目标主机已有其他反向代理占用 80/443，不要直接启用 TeamClaw 的 nginx profile。应改用现有反向代理转发到 TeamClaw app 端口，或设置不冲突的 NGINX_HTTP_PORT / NGINX_HTTPS_PORT。

用户必须关心的配置

更细的 RAG 并发、OCR、Embedding 维度和模型预算参数请看 .env.example；多数用户应该优先在后台 UI 配置。

Edit .env: TEAMCLAW_DATA_DIR, optional Nginx settings

docker compose -f docker-compose.prod.yml up -d --build docker compose -f docker-compose.prod.yml logs -f app

For Nginx HTTPS, place certificates under `nginx/cert/`, configure `NGINX_*` in `.env`, then run:

If another reverse proxy already owns 80/443 on the target host, do not enable TeamClaw's nginx profile with default ports. Route the existing proxy to the TeamClaw app port, or set non-conflicting NGINX_HTTP_PORT / NGINX_HTTPS_PORT.

Configuration You Actually Need

Detailed RAG concurrency, OCR, embedding dimension, and model-budget variables live in .env.example. Most users should configure RAG from the admin UI first.