Appearance
部署说明
WinWork 平台通过 Helm Chart 部署到 Kubernetes 集群,支持多环境差异化配置。
前置要求
- Kubernetes 1.24+
- Helm 3.x
- Docker Registry(用于存储镜像)
- MySQL 8.0+(Memory Hub 依赖)
- mem0 实例(记忆存储)
仓库结构
openclawhub/charts/openclaw/
├── Chart.yaml
├── values.yaml # 默认配置
├── values-test.yaml # 测试环境
├── templates/
│ ├── deployment.yaml
│ ├── configmap.yaml # openclaw.json
│ ├── env-configmap.yaml # 环境变量/令牌
│ ├── pvc.yaml
│ └── service.yaml
└── examples/
├── dev-values.yaml
├── prod-values.yaml
├── test-values.yaml
└── feishu-values.yaml快速部署
1. 构建镜像
bash
# OpenClaw Core
cd openclawhub
docker build -t your-registry/openclaw:latest .
docker push your-registry/openclaw:latest
# Memory Hub
cd memory-hub
docker build -t your-registry/mem0-hub:latest .
docker push your-registry/mem0-hub:latest2. 配置 values
yaml
# values.yaml 关键配置
image:
repository: your-registry/openclaw
tag: latest
persistence:
enabled: true
mountPath: /root/.openclaw
size: 10Gi
config:
mode: merge # merge 模式:Helm 配置与运行时配置合并
agents:
list:
- id: pa
name: 个人助手
workspace: /root/.openclaw/runtime_agents/AIEmployee/pa/workspaces
model: qwen-max
- id: ta
name: 团队助手
workspace: /root/.openclaw/runtime_agents/AIEmployee/ta/workspaces
model: qwen-max3. 部署
以下名称用于新部署示例。升级已有环境时,请使用该环境实际的 Helm release 和命名空间。
bash
helm install winwork ./charts/openclaw \
-f values.yaml \
-n winwork --create-namespace4. 升级
bash
helm upgrade winwork ./charts/openclaw \
-f values.yaml \
-n winworkMemory Hub 部署
Memory Hub 提供独立的部署脚本:
bash
cd memory-hub
# 完整部署(构建 + 部署)
./deploy.sh
# 仅构建镜像
./deploy.sh --build-only
# 仅部署(指定版本)
./deploy.sh --deploy-only --tag v1.0.0环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
PORT | 否 | 监听端口,默认 8080 |
MYSQL_DSN | 是 | MySQL 连接串 |
JWT_SECRET | 是 | JWT 签名密钥 |
MEM0_BASE_URL | 是 | mem0 服务地址 |
MEM0_API_KEY | 是 | mem0 API Key |
IFLYTEK_SSO_URL | 否 | 讯飞 SSO CAS 地址 |
运行时路径约定
容器内路径:
| 路径 | 说明 |
|---|---|
/root/.openclaw | 持久化根目录 |
/root/.openclaw/runtime_agents/AIEmployee/<agent-id>/workspaces | Agent 工作空间 |
/root/.openclaw/openclaw.json | 运行时配置 |
WARNING
Agent 列表与 workspace 路径建议以 Helm values 为唯一真相源。使用 config.mode: merge 时,init 和 sidecar 会将 Helm 配置与已有配置合并,避免覆盖运行时修改。
多环境管理
bash
# 开发环境
helm install winwork-dev ./charts/openclaw -f examples/dev-values.yaml -n winwork-dev
# 测试环境
helm install winwork-test ./charts/openclaw -f examples/test-values.yaml -n winwork-test
# 生产环境
helm install winwork-prod ./charts/openclaw -f examples/prod-values.yaml -n winwork-prod桌面端构建
bash
cd fe-super-assistant
npm install
# macOS
npm run build:mac
# Windows
npm run electron:buildTIP
桌面端支持自动更新,构建后的安装包会自动检查新版本并提示用户升级。详见 docs/auto-update-guide.md。
