Skip to content
已上线受限管理员管理

部署说明 ​

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:latest

2. 配置 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-max

3. 部署 ​

以下名称用于新部署示例。升级已有环境时,请使用该环境实际的 Helm release 和命名空间。

bash
helm install winwork ./charts/openclaw \
  -f values.yaml \
  -n winwork --create-namespace

4. 升级 ​

bash
helm upgrade winwork ./charts/openclaw \
  -f values.yaml \
  -n winwork

Memory 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>/workspacesAgent 工作空间
/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:build

TIP

桌面端支持自动更新,构建后的安装包会自动检查新版本并提示用户升级。详见 docs/auto-update-guide.md。

最后更新: