OpenAvatar LAM数字人使用教程：单图生成专属3D形象并实现实时对话【保姆级教程】

OpenAvatar LAM数字人使用教程：生成专属3D形象并实现实时对话

OpenAvatarChat 是一款模块化的交互数字人对话工具，支持在单台PC上运行完整的数字人对话功能，其中LAM（Large Avatar Model）数字人模块尤为亮眼——依托SIGGRAPH 2025收录的技术，可通过单张照片秒级生成超写实3D高斯数字人，并支持实时语音对话交互。本文将详细讲解如何部署OpenAvatar项目、生成自己形象的LAM数字人，并完成配置与实时对话，全程步骤清晰，新手也能快速上手。

一、前置说明与环境准备

在开始操作前，先明确核心依赖和项目特性，避免后续踩坑：

• 项目核心特性：OpenAvatarChat 采用模块化设计，支持多数字人模型切换，其中LAM数字人支持端侧渲染，仅VAD（语音活动检测）和ASR（语音识别）运行在本地GPU，对机器性能要求较低，可支持一机多路对话，平均响应延迟约2.2秒。
• 环境要求：Python版本 ≥3.11.❤️.12；需配备支持CUDA的GPU（推荐CUDA版本≥12.4）；提前安装git-lfs（用于拉取模型资源），避免因缺少依赖导致项目无法正常运行。
• 关键依赖：项目通过uv进行包管理，需提前安装uv；LAM数字人驱动依赖wav2vec2-base-960h和LAM_audio2exp模型，后续会自动关联下载，无需手动提前部署。

二、下载OpenAvatar项目并完成基础配置

首先获取OpenAvatarChat项目源码，完成基础的环境初始化，为后续LAM数字人配置做好准备。

2.1 下载项目源码

OpenAvatarChat 官方GitHub地址：https://github.com/HumanAIGC-Engineering/OpenAvatarChat

建议通过git克隆方式下载（国内用户可解决GitHub访问问题），避免直接下载zip包导致后续子模块加载失败，命令如下：

# 安装git-lfs（若未安装）sudoaptinstallgit-lfsgitlfsinstall# 克隆项目并更新子模块gitclone https://github.com/HumanAIGC-Engineering/OpenAvatarChat.gitcdOpenAvatarChatgitsubmodule update--init--recursive

2.2 安装uv与项目依赖

项目使用uv进行环境管理，需先安装uv，再根据配置文件安装对应依赖（优先安装LAM数字人所需依赖）：

# 安装uv（Linux/macOS）curl-LsSfhttps://astral.sh/uv/install.sh|sh# Windows系统（PowerShell）powershell-ExecutionPolicyByPass-c"irm https://astral.sh/uv/install.ps1 | iex"# 安装LAM数字人所需依赖（指定配置文件，仅安装必要依赖，避免冗余）uv venv--python3.11.11 ./scripts/pre_config_install.sh--configconfig/chat_with_lam.yaml uv run install.py--uv--configconfig/chat_with_lam.yaml ./scripts/post_config_install.sh--configconfig/chat_with_lam.yaml

注意：若运行中出现“No module named ‘mmcv._ext’”错误，可执行以下命令修复：

uv pip uninstall mmcv uv pipinstallmmcv==2.2.0-fhttps://download.openmmlab.com/mmcv/dist/cu121/torch2.4/index.html

三、生成专属3D高斯数字人资产（借助魔搭平台LAM项目）

LAM（Large Avatar Model）是一款能够通过单张照片秒级生成超写实3D高斯数字人的开源项目，支持视频驱动表情和语音交互，我们无需本地部署LAM模型，直接通过魔搭平台在线生成专属数字人资产包，操作简单高效。

3.1 LAM项目简介

• 核心功能：单张照片生成3D高斯数字人，支持表情驱动、实时渲染，可直接导出适配OpenAvatarChat的资产包。
• Paper地址：https://arxiv.org/pdf/2502.17796
• GitHub地址：https://github.com/aigc3d/LAM/tree/master
• 魔搭在线演示（无需部署，直接使用）：https://www.modelscope.cn/studios/Damo_XR_Lab/LAM_Large_Avatar_Model

3.2 在线生成数字人资产包（步骤详解）

无需复杂配置，通过魔搭平台几步即可生成自己的3D数字人，全程在线操作，无需本地安装模型：

1. 进入魔搭演示页面：打开上述魔搭平台链接，登录账号（支持阿里云账号快速登录），进入LAM Large Avatar Model演示界面。
2. 上传个人形象照片：找到“Input Image”区域，拖动自己准备好的正面清晰照片（建议无遮挡、光线均匀，避免侧脸或模糊照片）上传，系统会自动识别面部特征。
   
3. 选择视频驱动示例：在“Input Video”区域，随便选择一个预置的视频示例（用于驱动数字人表情，后续可自定义，此处仅用于生成资产包）。
4. 勾选导出资产包：找到“Export ZIP”选项并勾选，该选项用于导出适配OpenAvatarChat的数字人资产包（关键步骤，不勾选则无法用于后续对话）。
   
5. 生成并下载资产包：点击“Generate”按钮，系统会在1-2秒内生成3D数字人，生成完成后，复制页面中“wget”后面的链接，粘贴到浏览器地址栏，即可下载生成的3D高斯数字人资产包（文件名格式为chatting_avatar_20260429******.zip）。
   
   提示：资产包体积不大（约几MB），下载速度较快，建议保存到容易找到的路径，后续需用到该文件。

四、数字人资产配置与OpenAvatar启动

将下载好的专属数字人资产包放入OpenAvatar项目指定目录，修改配置文件，即可启动LAM数字人并实现实时对话。

4.1 放置数字人资产包

进入OpenAvatarChat项目目录，找到以下路径：

OpenAvatarChat/src/handlers/client/ws_lam_client/lam_samples

将刚刚下载的chatting_avatar_20260429******.zip文件，直接放入上述lam_samples目录中（无需解压，项目会自动识别压缩包）。

补充说明：OpenAvatarChat项目预置了4个范例形象（位于该目录下），用户可通过配置文件切换，此处我们替换为自己生成的专属数字人。

4.2 修改config配置文件

找到OpenAvatarChat项目中的chat_with_lam.yaml配置文件，路径如下：

OpenAvatarChat/config/chat_with_lam.yaml

打开该文件，找到LamClient配置项，将默认的asset_path（范例形象）修改为自己下载的资产包文件名，具体修改如下：

默认配置：

handler_configs:LamClient:module:client/ws_lam_client/ws_lam_client_handlerasset_path:"lam_samples/barbara.zip"

修改后配置（替换为自己的资产包文件名）：

handler_configs:LamClient:module:client/ws_lam_client/ws_lam_client_handlerasset_path:"lam_samples/chatting_avatar_20260429******.zip"

注意：asset_path中的文件名需与lam_samples目录下的资产包文件名完全一致，包括后缀.zip，建议直接复制文件名粘贴，避免手动输入出错。

4.3 启动LAM数字人并实现对话

配置完成后，在OpenAvatarChat项目根目录下，执行以下命令启动LAM数字人：

uv run src/demo.py--config./config/chat_with_lam.yaml

启动成功后，系统会自动打开浏览器页面，进入数字人对话界面，此时你生成的专属3D数字人会显示在页面中，点击“开始对话”，即可通过语音或文本与数字人实时交互。

4.4 常见问题说明

• 启动后一直等待：可能是部署环境存在NAT穿透问题（如部署在云服务器），需架设TURN服务，可运行scripts/setup_coturn.sh脚本安装配置，具体参考OpenAvatarChat官方文档。
• 数字人无法显示：检查asset_path配置是否正确，资产包是否放入指定目录，若仍有问题，可重新下载资产包重试。
• 语音无响应：确认本地麦克风正常，检查ASR模块依赖是否安装完整，可重新执行依赖安装命令。

五、补充说明与进阶操作

• 资产包替换：若想更换数字人形象，只需重复第三步生成新的资产包，替换lam_samples目录下的旧文件，并修改config文件中的asset_path即可。
• 性能优化：若GPU性能不足，可降低数字人帧率，在config文件中添加fps参数（默认25，建议最低设为20）。
• API密钥配置：项目中LLM和TTS默认使用百炼API，若出现API调用失败，可在config文件中添加自己的api_key，或通过.env文件设置环境变量（系统默认读取项目根目录下的.env文件）。