一、硬件与系统要求
-
最低配置
- CPU:四核八线程处理器(如 i5/Ryzen 5)
- 内存:8GB(推荐 16GB 以上)
- 存储:50GB NVMe SSD 空间(避免机械硬盘)
- GPU(可选):6GB 显存(NVIDIA 显卡支持 CUDA 加速)
-
操作系统
- Windows 10/11(管理员权限运行 PowerShell)
- macOS/Linux(需终端操作权限)
- 注意:Windows 系统建议安装到非系统盘(如 D 盘/E 盘)节省空间

二、推荐部署方案:DS本地部署大师(新手首选)
-
安装步骤
- 下载工具:从官网获取「DS本地部署大师」安装包
- 选择模型:启动后根据硬件性能选择适配的模型版本(显存/内存要求明确标注)
- 指定路径:设置安装目录(避开 C 盘),点击「立即安装」自动完成环境配置
- 启动应用:安装完成后点击「立即启动」,进入操作界面
-
核心优势
- 自动处理依赖冲突、虚拟环境及权限问题
- 无需手动下载模型文件或配置数据库
三、手动部署方案(进阶用户)
环境准备
- 安装 Node.js 24+ 及 Git(Windows 需管理员 PowerShell)
Windows 安装命令 iwr -useb https://openclaw.ai/install.ps1 | iex
- macOS/Linux 执行:
curl -fsSL https://openclaw.ai/install.sh | bash
安装与配置
- 全局安装 OpenClaw:
npm i -g openclaw@latest
- 启动交互式配置向导:
openclaw onboard --install-daemon
按提示选择模型供应商(如 Moonshoot AI)、跳过通道配置(后续可添加)
-
启动服务
- 完成配置后访问
http://127.0.0.1:18789进入 Web UI
四、登录与验证
- 登录方式:支持微信扫码、手机号/邮箱验证码、QQ 登录
- 功能验证:
- 检查启动日志无报错
- 输入测试指令(如文件操作、简单查询)确认响应正常
关键注意事项
- 安装路径:务必选择英文目录,避免中文路径导致异常
- 端口占用:默认端口
18789若冲突,启动时添加--port <新端口>参数 - 权限问题:Windows 全程使用管理员身份运行 PowerShell
部署问题排查:若启动失败,优先检查 Node.js 版本、端口冲突及存储空间;模型响应慢可尝试降低上下文长度或模型精度。