wsl安装OpenClaw

参考指南与学习资料

若您希望在本地快速搭建并部署一个个人智能助手，OpenClaw 框架是一个理想的入门选择。为了帮助开发者更高效地上手，社区中已有丰富的学习资源与讨论可供参考，主要包括：OpenClaw 新手入门教程、核心命令行工具使用指南（openclaw -h 查看帮助）、配置文件的参数详解，以及针对 Longcat、阿里百炼等不同模型平台的专项配置实例。这些经过整理的资料能够显著降低学习门槛，帮助您避免常见的配置误区。

可选模型服务后端

为 OpenClaw 接入一个可靠的大语言模型服务，是其获得智能对话能力的关键。当前可供选择的模型服务提供商众多，各有其优势：例如白山智算、智谱AI、MiniMax、阿里百炼、字节跳动的火山引擎方舟平台，以及谷歌的 AI Studio。此外，国内如美团Longcat、PackyAPI 等厂商也提供了相应服务。建议您根据实际需求与预算对比测试，选择最合适的服务。详细的接入方式、性能对比与最新定价信息，可以参考技术社区网友维护的在线共享文档，这些文档通常更新及时且包含一手评测。

安装 WSL (Windows 子系统)

对于使用 Windows 系统的开发者，首先需要启用 Windows 的 Linux 子系统功能。操作非常简便：请以管理员身份启动 PowerShell 或命令提示符，然后执行以下命令，系统将自动完成 WSL 的安装与初始设置。

wsl --install

安装 NVM (Node 版本管理器)

完成基础系统准备后，需要安装 Node.js 运行环境。为避免多项目间的 Node 版本冲突，推荐使用 NVM 来管理和切换 Node 版本。在已安装的 WSL 终端中，运行以下指令即可安装 NVM。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm -v

安装最新的 Node LTS 版本

成功安装 NVM 后，即可便捷地安装 Node.js 的长期支持版本。LTS 版本具备更好的稳定性与广泛的兼容性，适合生产及开发环境使用。

nvm install --lts

安装最新版 OpenClaw 框架

核心框架的安装步骤非常简单。通过 npm 包管理器全局安装最新版本的 OpenClaw，仅需一条命令。

npm install -g openclaw@latest

安装 Python 及必要依赖库

请注意，OpenClaw 在执行部分功能时可能依赖 Python 环境。提前安装好相关依赖库，可以有效预防后续运行中可能出现的报错。

在 WSL 的 Ubuntu 发行版中，可以通过以下命令安装 Python 3、pip 包管理工具以及一个常用的文档处理库。

sudo apt update
apt list | grep python3.1
sudo apt install python3
sudo apt install python3-pip
pip3 install python-docx

配置 OpenClaw 项目

安装完成后，核心步骤是根据您的需求进行个性化配置。使用文本编辑器打开配置文件，填入从所选模型服务商处获取的 API Key 等凭据信息。

# 编辑配置文件
code ~/.openclaw/openclaw.json

# 查看服务状态
openclaw status

# 获取网关访问令牌（用于启动 Web 控制台）
openclaw dashboard --no-open

# 管理网关服务（停止、启动或强制重启）
openclaw gateway stop
openclaw gateway start
openclaw gateway restart --force

# 发送测试消息，验证模型是否配置正确、能否正常响应
openclaw agent --to main --message “你好”

# 配置无误后，在浏览器中打开本地控制台页面
http://127.0.0.1:18789/

# 若需深度排查，可检查相关后台进程是否正常运行
ps aux | grep openclaw

集成飞书平台

是否希望将您的智能助手接入飞书，实现团队协同办公？OpenClaw 支持与飞书平台进行深度集成。整个流程涉及在飞书开放平台创建自建应用、配置 API 权限，并在您的服务器或云函数（例如阿里云函数计算 FC）中部署并设置事件回调 URL。务必仔细阅读飞书官方开放平台的开发文档，同时，阿里云等云厂商也常提供与飞书集成的场景化教程。按步骤操作，即可将 OpenClaw 的智能对话能力成功对接到飞书群聊或工作台中。