Ubuntu/Debian

本指南假设“OpenClaw”是一个基于容器化微服务（如使用Docker和Kubernetes）的AI服务平台，我们将从单节点扩展到多节点集群，并提供自动化批量部署的方案。

---

AI小龙虾 OpenClaw 服务器批量安装指南

文档版本： 1.0

目标读者： 系统管理员、运维工程师

部署模式：

• 方案A： 单服务器All-in-One部署（适用于PoC或小型环境）
• 方案B： 多节点高可用集群部署（适用于生产环境）

---

第一阶段：准备工作

硬件与网络要求

• 管理节点（1台）： 用于执行部署命令，配置不低于 2核4GB。
• 服务器节点（N台）： 运行OpenClaw工作负载。
  • 推荐配置：
    • CPU： 8核+ (支持AVX指令集，利于AI推理)
    • 内存： 32GB+
    • GPU（可选）： 根据AI模型需求配备（如NVIDIA Tesla T4/V100等，需安装驱动）
    • 存储： 系统盘 100GB+，数据盘（SSD推荐）500GB+，建议做RAID
    • 网络： 千兆/万兆以太网，所有节点在同一局域网内，确保网络低延迟、无防火墙阻断。
• 外部依赖：
  • 对象存储（如MinIO，AWS S3兼容）： 用于存储模型、数据集。
  • 数据库（如MySQL/PostgreSQL）： 用于存储元数据、用户信息等。
  • Redis： 用于缓存和会话管理。

软件与环境统一

在所有目标服务器节点上,需预先统一以下环境：

• 操作系统： Ubuntu Server 20.04/22.04 LTS 或 CentOS 7.9/Rocky Linux 8.5+（推荐Ubuntu 22.04）。
• 系统更新：

  sudo apt update && sudo apt upgrade -y  # Ubuntu
  sudo yum update -y                      # CentOS/Rocky

• 主机名与Hosts解析： 为每台服务器设置唯一主机名（如 openclaw-master-01, openclaw-worker-01），并在/etc/hosts中配置所有节点的IP-主机名映射。
• 时间同步（NTP）：

  sudo timedatectl set-ntp true   # Ubuntu/CentOS 8+
  sudo ntpdate time.windows.com   # 或使用chrony

• 防火墙与SELinux：
  • 开放必要端口（如SSH 22， Kubernetes API 6443， 节点端口范围 30000-32767， 应用特定端口如8080， 9090等）。
  • 如无特殊要求,可暂时禁用SELinux（仅CentOS/Rocky）并配置防火墙规则。

安装基础工具

在所有节点安装：

# CentOS/Rocky
sudo yum install -y curl wget vim git net-tools lsof htop jq epel-release

---

第二阶段：核心运行时安装（批量自动化）

我们将使用 Ansible 作为自动化工具，在所有节点上批量安装Docker和Kubernetes。

配置管理节点（Ansible控制机）

在管理节点上安装Ansible，并配置免密SSH登录所有节点。

# 在管理节点上执行
sudo apt install -y ansible sshpass
# 生成SSH密钥对（如果还没有）
ssh-keygen -t rsa -b 4096
# 将公钥批量拷贝到所有目标节点（需输入一次密码）
# 编辑 hosts.txt，列出所有节点IP和密码（或提前手动配置好密钥）
ssh-copy-id -i ~/.ssh/id_rsa.pub user@server_ip
# 创建Ansible库存文件 `inventory.ini`
cat > inventory.ini <<EOF
[all]
openclaw-master-01 ansible_host=192.168.1.10
openclaw-worker-01 ansible_host=192.168.1.11
openclaw-worker-02 ansible_host=192.168.1.12
[masters]
openclaw-master-01
[workers]
openclaw-worker-01
openclaw-worker-02
EOF
# 测试连接
ansible all -i inventory.ini -m ping

编写Ansible Playbook批量安装

创建Playbook文件 setup-openclaw-infra.yml，用于批量安装Docker、Kubernetes（K3s或K8s）等。

示例（使用轻量级K3s）：

---
- name: 批量部署OpenClaw基础架构
  hosts: all
  become: yes
  tasks:
    - name: 安装Docker
      apt:
        name:
          - docker.io
          - docker-compose
        state: present
        update_cache: yes
      when: ansible_os_family == "Debian"
    - name: 启动并启用Docker服务
      systemd:
        name: docker
        state: started
        enabled: yes
    - name: 修改Docker配置（使用国内镜像、配置存储驱动）
      copy:
        content: |
          {
            "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"],
            "exec-opts": ["native.cgroupdriver=systemd"],
            "log-driver": "json-file",
            "log-opts": {
              "max-size": "100m"
            },
            "storage-driver": "overlay2"
          }
        dest: /etc/docker/daemon.json
      notify: 重启Docker服务
    - name: 将当前用户加入docker组
      user:
        name: "{{ ansible_user }}"
        groups: docker
        append: yes
  handlers:
    - name: 重启Docker服务
      systemd:
        name: docker
        state: restarted
- name: 部署K3s集群（Master节点）
  hosts: masters
  become: yes
  tasks:
    - name: 安装K3s Server
      shell: |
        curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=v1.26.5+k3s1 \
        INSTALL_K3S_EXEC="--docker --tls-san {{ ansible_host }}" sh -
      args:
        creates: /usr/local/bin/k3s
    - name: 获取K3s Token
      shell: cat /var/lib/rancher/k3s/server/node-token
      register: k3s_token
      no_log: true # 保护token不输出到日志
    - name: 保存Token到管理节点
      delegate_to: localhost
      copy:
        content: "{{ k3s_token.stdout }}"
        dest: "./k3s_token.txt"
- name: 部署K3s集群（Worker节点）
  hosts: workers
  become: yes
  vars:
    k3s_master_ip: "{{ hostvars['openclaw-master-01']['ansible_host'] }}"
    # 从文件读取token，安全做法
  tasks:
    - name: 读取K3s Token
      delegate_to: localhost
      slurp:
        src: "./k3s_token.txt"
      register: token_file
    - name: 安装K3s Agent
      shell: |
        curl -sfL https://get.k3s.io | \
        K3S_URL=https://{{ k3s_master_ip }}:6443 \
        K3S_TOKEN={{ token_file.content | b64decode }} \
        INSTALL_K3S_VERSION=v1.26.5+k3s1 \
        INSTALL_K3S_EXEC="--docker" sh -
      args:
        creates: /usr/local/bin/k3s

执行Playbook

# 在管理节点上执行
ansible-playbook -i inventory.ini setup-openclaw-infra.yml
# 在Master节点上验证集群
ssh openclaw-master-01 "sudo k3s kubectl get nodes -o wide"

---

第三阶段：部署OpenClaw应用

准备OpenClaw部署清单（Manifests）

假设OpenClaw应用由以下组件构成（需要从开发团队获取实际的镜像和配置）：

1. 前端（Web UI）
2. API网关/后端服务
3. AI模型推理服务（Model Serving）
4. 任务队列（如Celery + Redis）
5. 数据库迁移Job

创建一个目录 openclaw-manifests/ 存放所有K8s YAML文件。

示例：openclaw-namespace.yaml

apiVersion: v1
kind: Namespace
metadata:
  name: openclaw

示例：openclaw-configmap.yaml （配置文件） 示例：openclaw-secrets.yaml （敏感信息，需加密或使用K8s Secrets） 示例：openclaw-deployment.yaml （部署应用） 示例：openclaw-service.yaml （服务暴露） 示例：openclaw-ingress.yaml （入口，配合Traefik/Nginx）

部署存储类（StorageClass）

如果应用需要持久化存储（如数据库、模型缓存），需提前部署StorageClass。

# 使用本地存储或NFS
kubectl apply -f https://raw.githubusercontent.com/rancher/local-path-provisioner/master/deploy/local-path-storage.yaml -n openclaw

部署外部依赖

使用Helm或YAML部署MySQL、Redis、MinIO等。

# 使用Helm（需提前安装）
helm repo add bitnami https://charts.bitnami.com/bitnami
helm install openclaw-redis bitnami/redis -n openclaw \
  --set architecture=standalone \
  --set auth.enabled=false

部署OpenClaw核心应用

# 在Master节点或配置了kubeconfig的管理节点上执行
kubectl apply -f openclaw-manifests/ -n openclaw
# 监控部署状态
kubectl get pods,svc,ing -n openclaw -w

---

第四阶段：验证与初始化

1. 服务可达性： 通过kubectl get svc -n openclaw查看服务IP/端口，或通过Ingress域名访问。
2. 日志检查： kubectl logs -f <pod-name> -n openclaw
3. 数据库初始化： 确认数据库迁移Job成功完成。
4. 功能测试： 执行一个简单的AI推理任务，验证整个流程。
5. 监控集成： 部署Prometheus + Grafana监控集群和应用指标。

---

批量安装脚本（简化版单节点/多节点快速启动）

对于更简单的场景,可以编写一个Bash脚本，通过SSH并行执行命令。

batch_install.sh 示例：

#!/bin/bash
# 节点IP列表
NODES=("192.168.1.10" "192.168.1.11" "192.168.1.12")
USER="root"
SCRIPT="install_docker_k3s.sh" # 每个节点要执行的脚本
for NODE in "${NODES[@]}"; do
    echo "===== 部署节点: $NODE ====="
    # 将本地脚本拷贝到远程节点并执行
    scp ./$SCRIPT $USER@$NODE:/tmp/
    ssh $USER@$NODE "bash /tmp/$SCRIPT" &
done
wait
echo "所有节点部署完成。"

install_docker_k3s.sh 内容需包含安装Docker和加入集群的命令。

---

故障排查与注意事项

1. SSH免密失败： 检查网络、密码、sshd配置。
2. Docker拉取镜像慢： 配置国内镜像加速器。
3. K3s节点未就绪： 检查网络连通性（端口6443）、Token是否正确、防火墙。
4. Pod处于Pending状态： kubectl describe pod <name> 查看事件，通常是资源不足或PVC无法绑定。
5. 应用内部错误： 查看应用日志，检查环境变量、配置文件、数据库连接等。
6. 备份： 定期备份数据库（如使用mysqldump）和重要配置文件。
7. 安全：
   • 及时更新系统和软件包。
   • 为K8s配置RBAC权限。
   • 使用Secret管理敏感信息,而非明文写在YAML中。
   • 为Ingress配置TLS证书（如Let‘s Encrypt）。

---

通过以上步骤,您可以使用Ansible实现从基础设施（Docker， K3s）到应用（OpenClaw）的标准化、批量部署，对于生产环境，建议进一步考虑：

• CI/CD流水线： 将应用部署自动化集成到GitOps流程（如使用ArgoCD）。
• 配置管理： 使用Helm Charts对应用进行参数化管理。
• 高可用： 为Master节点配置多实例，使用外部数据库和存储。

请根据实际的“AI小龙虾OpenClaw”应用的具体架构和镜像信息，调整第三阶段的部署清单。