1.更新软件包列表

openclaw 中文openclaw 2026-04-09 2

本教程会像“手把手”一样，带你从零开始,直到成功运行OpenClaw。

1.更新软件包列表-第1张图片-OpenClaw下载中文-AI中文智能体

核心思路

我们不会直接在复杂的电脑环境里安装，而是用一个叫 Docker 的“集装箱”技术，想象一下，我们把整个OpenClaw软件和它需要的所有环境，都打包好放在一个标准的集装箱里，你只需要在电脑上安装一个“吊车”（Docker），就能轻松把这个集装箱拉下来并运行起来,完全不用担心环境冲突。

第一步：准备工作（安装Docker）

这是最关键的一步,请根据你的操作系统选择：

A. 如果你使用的是 Windows 系统

下载 Docker Desktop：
- 访问 Docker 官网下载页面：https://www.docker.com/products/docker-desktop/
- 下载适用于 Windows 的 Docker Desktop Installer.exe。
安装：
- 双击安装文件，一路点击“Next”即可，安装过程中可能会要求你启用 WSL 2 或 Hyper-V,请务必同意并按照提示操作。
- 安装完成后，重启电脑。
验证：
重启后，在开始菜单找到 “Docker Desktop” 并运行，看到右下角系统托盘出现 Docker 的鲸鱼图标，并且状态显示为 “Docker Desktop is running” 就成功了。

B. 如果你使用的是 macOS 系统

下载 Docker Desktop：
- 访问同样的 Docker 官网下载页面。
- 根据你的芯片（Intel 或 Apple Silicon）下载对应的 Docker.dmg 文件。
安装：
- 打开下载的 .dmg 文件，将 Docker 图标拖拽到 “应用程序” 文件夹。
- 在“应用程序”文件夹中打开 Docker。
- 首次运行会要求进行一些权限设置,请全部同意。
验证：顶部菜单栏出现 Docker 的鲸鱼图标即表示运行成功。

C. 如果你使用的是 Linux 系统（如 Ubuntu）

打开终端,依次执行以下命令：

# 2. 安装必要的依赖
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
# 3. 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 4. 添加Docker仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 5. 再次更新并安装Docker引擎
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
# 6. 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
# 7. （可选但推荐）将当前用户加入docker组，避免每次都输sudo
sudo usermod -aG docker $USER
# **注意：执行此命令后，你需要完全注销并重新登录，或者重启电脑，才能生效。**

验证：在终端输入 docker --version，如果显示版本号,说明安装成功。

第二步：拉取并运行OpenClaw镜像

吊车”（Docker）准备好了，我们可以去搬运“集装箱”（OpenClaw）了，全程在命令行中操作。

打开命令行工具：
- Windows：按 Win + R，输入 cmd 或 powershell，回车，或者在开始菜单搜索 “命令提示符” 或 “PowerShell”。
- macOS：打开 “访达” -> “应用程序” -> “实用工具” -> “终端”。
- Linux：你已经知道怎么打开终端了。
拉取Docker镜像（下载集装箱）：在命令行中输入以下命令，并回车，这会从网上下载预先打包好的OpenClaw环境，可能需要几分钟,取决于你的网速。
```
docker pull yangzai/openclaw:latest
```
运行OpenClaw容器（启动集装箱）：下载完成后,输入以下命令来启动它：
```
docker run -d --name openclaw -p 7860:7860 yangzai/openclaw:latest
```
- -d：表示在“后台”运行。
- --name openclaw：给你运行的容器起个名字,方便管理。
- -p 7860:7860：将容器内部的端口（7860）映射到你电脑的端口（7860）,这样你才能通过浏览器访问。
- yangzai/openclaw:latest：指定你要运行的镜像名称。

第三步：访问和使用OpenClaw

等待启动：运行命令后，Docker容器会在后台启动，等待10-20秒,让里面的服务完全初始化。
打开浏览器：打开你常用的浏览器（Chrome， Edge， Firefox等）。
访问地址：在浏览器地址栏输入：http://localhost:7860 然后回车。
开始对话：如果一切顺利，你将看到OpenClaw的Web聊天界面！现在你可以像使用ChatGPT一样,在底部的输入框里向它提问了。

常见问题与故障排除 (新手必看！)

问：访问 localhost:7860 打不开网页？
- 检查容器是否运行：在命令行输入 docker ps，查看是否有名为 openclaw 的容器在列表里，并且状态是 “Up”。
- 如果没运行：试试 docker start openclaw 来启动它。
- 端口冲突：你电脑上可能有其他软件也占用了7860端口，可以换一个端口运行，例如换成 -p 8080:7860，然后访问 http://localhost:8080。
问：如何关闭OpenClaw？
- 在命令行输入：docker stop openclaw,这会让容器停止运行。
- 如果想再次启动，输入：docker start openclaw。
问：如何完全删除容器？
- 如果你想从头再来，可以先停止容器 docker stop openclaw，然后删除它 docker rm openclaw。
问：命令报错 “docker: command not found”？
- 这说明Docker没有安装成功，或者命令行找不到它，请回到第一步，确保Docker Desktop（Windows/macOS）正在运行,或者Linux下你已重新登录。
问：运行时提示显存不足或CUDA错误？
- 默认的Docker镜像可能没有启用GPU支持，对于有NVIDIA显卡的进阶用户，可以搜索 nvidia-docker 的安装方法，并在 docker run 命令中加入 --gpus all 参数。对于新手，先使用CPU模式即可，大部分对话功能不受影响。