国内东南大学学生安装OpenClaw（小龙虾）在 Windows WSL2 环境下的完整安装与配置教程

适用人群想在 Windows 电脑上通过 WSL2Windows Subsystem for Linux部署并使用 OpenClaw 的用户。前置知识基本的电脑操作能跟着教程复制粘贴命令即可。涉及内容WSL2 环境配置、OpenClaw 安装、DeepSeek API 接入、Gateway 启动与使用、常见网络问题排查。一、什么是 OpenClaw为什么选择 WSL2 方案OpenClaw俗称“小龙虾”或“大龙虾”是一款开源、本地优先的个人 AI 助手系统。与普通聊天机器人不同它的核心优势在于强执行能力——能通过自然语言指令自动拆解任务帮你处理邮件、管理文件甚至调用系统工具官方推荐在 Windows 上通过WSL2Windows Subsystem for Linux运行 OpenClaw原因如下环境隔离WSL2 提供完整的 Linux 内核避免 Node.js 等依赖与 Windows 产生冲突。生态兼容既能享受 Linux 生态又能方便地访问 Windows 文件系统位于/mnt/c/。官方推荐OpenClaw 的 CLI 和 Gateway 在 Linux 环境下兼容性最好二、环境准备安装 WSL2 与 Ubuntu2.1 系统要求操作系统Windows 10 版本 2004 及以上或 Windows 11内存建议 8GB 以上虚拟化确保 BIOS 中已开启 Intel VT-x 或 AMD-V2.2 启用 WSL 相关功能按Win S搜索“Windows 功能”打开“启用或关闭 Windows 功能”。勾选以下三项✅ 虚拟机平台✅ Windows 虚拟机监控程序平台✅ 适用于 Linux 的 Windows 子系统点击“确定”重启电脑。2.3 安装 WSL2 与 Ubuntu重启后以管理员身份打开 PowerShell 或 Windows 终端执行wsl --install此命令会自动启用 WSL2 并默认安装 Ubuntu 最新 LTS 版。如果遇到网络问题可以指定安装 Ubuntu 22.04 或 24.04wsl --install -d Ubuntu-24.04安装完成后再次重启电脑。2.4 首次启动 Ubuntu 配置在开始菜单中找到并启动Ubuntu。等待初始化完成根据提示创建UNIX 用户名和密码不要使用中文建议记住你的账号密码。验证安装是否成功wsl -l -v如果 VERSION 列为2说明安装成功2.5 启用 systemd关键步骤OpenClaw 的 Gateway 服务需要 systemd 支持。在Ubuntu 终端中执行sudo tee /etc/wsl.conf /dev/null EOF[boot]systemdtrueEOF然后回到Windows PowerShell执行以下命令重启 WSLwsl --shutdown重新打开 Ubuntu 终端验证 systemd 是否正常systemctl --user status如果看到服务列表输出说明配置成功。2.6 配置国内镜像源加快下载速度在 Ubuntu 终端中执行# 备份原始源sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak# 替换为清华镜像源Ubuntu 22.04 适用sudo tee /etc/apt/sources.list EOFdeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiversedeb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverseEOF# 更新软件包sudo apt update sudo apt upgrade -y注意如果你安装的是 Ubuntu 24.04请将上面的jammy替换为noble。三、安装 OpenClawOpenClaw 基于 Node.js 构建官方推荐使用 Node.js 22 LTS 或更高版本。在 Ubuntu 终端中执行# 安装 Node.js 22.xcurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt install -y nodejs# 验证安装node --version # 应显示 v22.x.xnpm --version # 应显示 10.x.x3.2 安装 OpenClawOpenClaw 官方提供了便捷的一键安装脚本。在 Ubuntu 终端中执行curl -fsSL https://openclaw.ai/install.sh | bash安装脚本会自动检测并安装所需依赖。3.3 验证安装安装完成后验证 OpenClaw 是否安装成功openclaw --version如果显示版本号说明安装成功。四、配置 DeepSeek API或其他大模型OpenClaw 本身不提供大模型能力需要配置 API 才能工作。4.1 获取 DeepSeek API Key访问 DeepSeek 开放平台。注册账号并登录。进入“API Keys”页面创建新的密钥。复制并保存生成的 API Key以sk-开头。4.2 配置 OpenClaw 使用 DeepSeek有两种方式可以配置方式一通过 openclaw onboard 向导推荐openclaw onboard --auth-choice deepseek-api-key按照提示输入你的 DeepSeek API Key 即可。方式二手动修改配置文件编辑~/.openclaw/openclaw.json文件{models: {mode: merge,providers: {deepseek: {baseUrl: https://api.deepseek.com,apiKey: 你的DeepSeek API Key,api: openai-completions,models: [{ id: deepseek-chat, name: DeepSeek Chat },{ id: deepseek-reasoner, name: DeepSeek Reasoner },{ id: deepseek-v4-pro, name: DeepSeek V4 Pro }]}}},agents: {defaults: {models: {deepseek/deepseek-chat: {},deepseek/deepseek-reasoner: {},deepseek/deepseek-v4-pro: {}}}}}4.3 验证模型配置openclaw models list | grep deepseek如果能看到 DeepSeek 相关模型说明配置成功。五、启动 Gateway 服务Gateway 是 OpenClaw 的核心后台服务。5.1 运行配置向导并安装服务openclaw onboard --install-daemon按照交互式提示完成配置。关键选项建议Gateway mode选择local本地模式Memory search如果未配置 OpenAI API Key选择NoSkills选择Yes禁用不可用的技能Hooks建议至少选择session-memory5.2 启动 Gatewayopenclaw gateway start5.3 检查 Gateway 状态openclaw gateway status如果显示Runtime: running和Connectivity probe: ok说明 Gateway 正常运行六、使用 OpenClaw6.1 启动 TUI在Ubuntu终端交互界面openclaw tui进入 TUI 后你可以像聊天一样输入指令OpenClaw 会执行相应的任务。6.2 启动 Web 控制台Dashboardopenclaw dashboard浏览器会自动打开http://127.0.0.1:18789/提供图形化操作界面。6.3 常用命令命令作用openclaw gateway status查看 Gateway 运行状态openclaw gateway restart重启 Gatewayopenclaw gateway stop停止 Gatewayopenclaw tui打开终端交互界面openclaw dashboard打开 Web 控制台openclaw models list查看已配置的模型列表openclaw config set key value修改配置七、常见问题与解决方案7.1 网络问题WSL2 无法访问外网现象curl命令超时无法访问百度或 DeepSeek API。原因WSL2 网络栈卡死或 VPN/代理与 WSL2 冲突。解决方案关闭所有 VPN 和代理软件。以管理员身份打开 PowerShell依次执行wsl --shutdownnetsh winsock resetnetsh int ip reset allipconfig /flushdns重启电脑。如果问题依旧创建C:\Users\你的用户名\.wslconfig文件内容如下[wsl2]networkingModemirroreddnsTunnelingtruefirewalltrueautoProxytrue保存后在 PowerShell 中执行wsl --shutdown重启 WSL2。7.2 Gateway 无法启动端口被占用现象Gateway 启动失败提示端口 18789 被占用。解决方案# 查找占用端口的进程sudo lsof -i :18789# 或netstat -ano | findstr 18789终止占用进程后重新启动 Gateway。7.3 TUI 显示connected | error现象TUI 能连接 Gateway但发送消息后报错。可能原因DeepSeek API Key 无效或余额不足网络无法访问 DeepSeek API模型配置错误排查步骤检查 DeepSeek 账户余额。测试网络连通性curl -I https://api.deepseek.com检查模型配置openclaw models list查看日志openclaw logs 507.4 命令找不到openclaw: command not found原因环境变量 PATH 未正确配置。解决方案# 查找 openclaw 安装位置which openclaw# 或重新安装npm install -g openclaw7.5 配置文件缺失现象Gateway 启动失败提示Config (cli): ~/.openclaw/openclaw.json (missing)。解决方案重新运行配置向导openclaw onboard八、补充说明8.1 关于 VPN 的影响使用 VPN 时WSL2 的网络可能无法自动继承 Windows 的代理设置。如果需要通过代理访问外网可以在 WSL2 中手动设置export http_proxyhttp://宿主机IP:代理端口export https_proxyhttp://宿主机IP:代理端口宿主机 IP 可通过cat /etc/resolv.conf中的nameserver获取。8.2 关于“小龙虾”名称的由来OpenClaw 的社区昵称“小龙虾”或“大龙虾”源于其图标和项目名称的谐音。8.3 进一步学习资源OpenClaw 官方文档OpenClaw 中文安装与使用手册OpenClaw 入门指南以上是 OpenClaw 在 Windows WSL2 环境下的完整安装与配置教程。如果你在使用过程中遇到教程中未覆盖的问题欢迎随时交流。第二篇关于Claude Code (CC)的教程将单独整理涵盖安装、DeepSeek API 接入、代理配置以及禁令相关的注意事项。