夜雨聆风
从零开始，手把手教你在 Windows 笔记本上通过 WSL2 安装开源 AI 助手框架 OpenClaw，配置国内订阅模型，并将其接入飞书机器人，实现用飞书直接和 AI 对话。
1.在Windows上安装WSL2（Linux子系统）
2.在WSL2中安装OpenClaw
3.配置国内模型到OpenClaw
3.在飞书开放平台创建应用并接入OpenClaw
一、认识 OpenClaw
多渠道收件箱：支持飞书、微信、Telegram、Slack、Discord、WhatsApp 等 20+ 消息渠道 多模型支持：支持 OpenAI GPT-4o、Claude、Gemini、DeepSeek 等主流大模型 本地优先：数据存储在你自己的设备上，隐私安全有保障 多 Agent 路由：可以将不同渠道/账号/对话路由到不同的 AI Agent 语音交互 + Canvas 可视化：支持语音唤醒和实时可视化工作区 GitHub 地址：https://github.com/openclaw/openclaw 官方文档：https://docs.openclaw.ai
二、安装 WSL2
2.1 什么是 WSL？
为什么选 WSL2 而不是 WSL1？WSL2 支持完整 Linux 内核、systemd、Docker，文件 I/O 性能比 WSL1 快约 20 倍，是 90% 场景的首选。
2.2 前置检查
在开始之前，请确认你的电脑满足以下条件：
Windows 10（版本 19041 或更高）或 Windows 11 BIOS 中已启用虚拟化（Intel VT-x 或 AMD-V） 不在 Windows S 模式下
检查虚拟化是否开启：按 `Ctrl + Shift + Esc` 打开任务管理器 → 点击"性能"选项卡 → 查看"虚拟化"是否显示"已启用"。如果未启用，需要重启电脑进入 BIOS 开启。
2.3 一键安装 WSL2
wsl --install |
这条命令会自动完成以下操作：
启用 WSL 功能 启用虚拟机平台 设置 WSL2 为默认版本 安装默认的 Ubuntu 发行版
2.4 指定安装 Ubuntu 24.04 LTS（推荐）
如果你想安装特定版本，可以指定发行版：
wsl --install -d Ubuntu-24.04 |
查看所有可用的 Linux 发行版：
wsl --list --online |
2.5 初始化 Ubuntu
重启后，系统会自动打开 Ubuntu 终端窗口，提示你设置用户名和密码：
Enter new UNIX username: 你的用户名 New password: 你的密码 Retype new password: 再次输入密码 |
注意：输入密码时屏幕不会显示任何字符，这是正常的，输入完按回车即可。
2.6 验证 WSL2 安装成功
打开 PowerShell，执行：
wsl --list --verbose |
输出示例：
NAME STATE VERSION * Ubuntu-22.04 Running 2 |
确认 `VERSION` 列显示为 `2`，说明 WSL2 安装成功。
三、配置 WSL2 环境
3.1 更新系统
打开 Ubuntu 终端（在 Windows 搜索栏输入 "Ubuntu" 即可打开），执行：
sudo apt update && sudo apt upgrade -y |
3.2 安装基础工具
sudo apt install -y build-essential git curl wget vim zsh unzip \ ca-certificates gnupg lsb-release python3-pip jq |
3.3 配置镜像源（国内用户推荐）
将 Ubuntu 默认的国外源替换为阿里云镜像源，大幅提升下载速度：
sudo sed -i 's|https://archive.ubuntu.com|https://mirrors.aliyun.com|g' /etc/apt/sources.list sudo apt update |
注意：Ubuntu 24.04+ 使用 DEB822 格式，源文件路径为 /etc/apt/sources.list.d/ubuntu.sources，需要用不同的方式替换，具体可参考阿里云镜像站文档。
四、安装 Node.js
4.1 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash |
安装完成后，重新加载 shell 配置：
source ~/.bashrc |
验证 nvm 安装：
nvm --version |
4.2 安装 Node.js
nvm install 24 |
验证安装：
node --version npm --version |
输出应类似：
v24.x.x 10.x.x |
4.3 配置 npm 镜像（国内用户推荐）
npm config set registry https://registry.npmmirror.com/ |
五、安装 OpenClaw
npm 全局安装（推荐）
这是最简单的安装方式，一条命令搞定：
npm install -g openclaw@latest |
安装完成后，运行引导配置：
openclaw onboard --install-daemon |
`openclaw onboard` 会引导你逐步配置 Gateway、工作空间、渠道和技能，并安装守护进程。按照终端中的提示一步步操作即可。
六、配置 AI 模型
OpenClaw 安装完成后，需要配置 AI 模型才能工作。编辑配置文件：
nano ~/.openclaw/openclaw.json |
写入以下内容（以 DeepSeek 为例）：
{ agent: { model: "deepseek/deepseek-chat", }, models: { providers: { deepseek: { apiKey: "你的DeepSeek API Key", baseURL: "https://api.deepseek.com/v1", }, }, }, } |
提示：你也可以使用 OpenAI、Claude、Gemini 等模型，只需修改 model 和 providers 配置即可。API Key 可以在对应模型平台的官网申请。
七、在飞书开放平台创建应用
现在进入最关键的环节—— 将 OpenClaw 接入飞书。
7.1 访问飞书开放平台
打开浏览器，访问飞书开放平台开发者后台：
https://open.feishu.cn/app |
使用你的飞书账号登录。
7.2 创建企业自建应用
应用名称：例如 "我的AI助手" 应用描述：例如 "基于 OpenClaw 的个人 AI 助手" 应用图标：上传一个你喜欢的图标
7.3 添加机器人能力
7.4 获取 App ID 和 App Secret
重要：请妥善保管 App Secret，不要泄露给他人。后续配置 OpenClaw 时需要用到这两个值。
7.5 配置应用权限
权限标识 | 权限名称 | 用途 |
im:message | 获取与发送单聊、群组消息 | 机器人收发消息的基本权限 |
im:message.p2p_msg:readonly | 读取用户发给机器人的单聊消息 | 允许机器人接收用户私聊消息 |
im:message:group_at_msg:readonly | 接收群聊中@机器人的消息 | 群聊场景下接收消息 |
contact:user:read | 获取用户基本信息 | 读取用户身份信息 |
{ "scopes": { "tenant": [ "im:message", "im:message.p2p_msg:readonly", "im:message:group_at_msg:readonly", "contact:user:read" ] } } |
7.6 配置事件订阅
7.7 创建测试企业（推荐）
为了快速测试而不影响企业内的其他用户，建议创建一个测试企业：
说明：测试版本中涉及的权限和配置变更都会直接生效，无需管理员审核，大大加速开发效率。
7.8 发布应用
如果使用测试企业，配置变更会直接生效，无需发布审核。
八、将飞书应用接入 OpenClaw
8.1 运行渠道设置向导
回到 WSL 的 Ubuntu 终端，执行以下命令：
如果你使用 npm 安装方式：
openclaw channels login --channel feishu |
8.2 配置飞书凭证
向导会提示你选择配置方式：
手动设置（推荐）：粘贴你在飞书开放平台获取的 App ID 和 App Secret 二维码设置：扫描二维码自动创建机器人（国内版飞书移动端可能无反应，建议选手动）
选择手动设置后，依次输入：
App ID: cli_xxxxxxxxxxxxxxxx App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
8.3 重启 Gateway
配置完成后，重启 Gateway 使配置生效：
npm 安装方式：
openclaw gateway restart |
8.4 验证连接
重启后，在飞书中搜索你的机器人名称，发送一条消息测试：
你好，请介绍一下你自己 |
如果机器人能正常回复，恭喜你，接入成功了！��
九、进阶配置
9.1 允许所有群组（无需 @提及）
默认情况下，在群聊中需要 @机器人 才会回复。如果你想机器人在群聊中自动回复所有消息，可以修改配置：
nano ~/.openclaw/openclaw.json |
添加或修改以下内容：
{ channels: { feishu: { groupPolicy: "open", requireMention: false, }, }, } |
修改后重启 Gateway：
openclaw gateway restart |
9.2 仅允许特定群组
{ channels: { feishu: { groupPolicy: "allowlist", groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } |
9.3 配置私信策略
{ channels: { feishu: { dmPolicy: "open", }, }, } |
`dmPolicy` 可选值：
pairing：需要配对码才能私聊（默认） allowlist：仅允许白名单用户 open：允许所有人私聊 disabled：禁止私聊
9.4 启用流式卡片输出
OpenClaw 支持在飞书中以卡片形式流式输出 AI 回复（类似 ChatGPT 的打字效果），默认已开启：
{ channels: { feishu: { streaming: true, }, }, } |
9.5 多飞书账户配置
如果你需要接入多个飞书应用：
{ channels: { feishu: { defaultAccount: "main", accounts: { main: { appId: "cli_xxx", appSecret: "xxx", name: "主机器人", }, backup: { appId: "cli_yyy", appSecret: "yyy", name: "备用机器人", enabled: false, }, }, }, }, } |
——— ★ ———
十、常见问题排查
Q1：安装 WSL 时报错 0x80070003
Q2：WSL 内无法上网
Q3：npm install 速度很慢
npm config set registry https://registry.npmmirror.com/ |
Q4：飞书机器人无法接收消息
Q5：Gateway 启动失败
# 查看日志 openclaw gateway logs # 或设置调试级别 export OPENCLAW_LOG_LEVEL=debug openclaw gateway restart |
Q6：/mnt/c/ 下文件操作极慢
Q7：WSL 占用内存过大
[wsl2] memory=4GB |
或手动释放：
# 在 PowerShell 中执行 wsl --shutdown |
十一、日常使用命令速查
WSL 常用命令（在 PowerShell 中）
wsl --shutdown # 关闭所有 WSL 实例 wsl --status # 查看 WSL 状态 wsl --version # 查看 WSL 版本 wsl --update # 更新 WSL wsl -l -v # 查看已安装的发行版 |
OpenClaw 常用命令（在 Ubuntu 终端中）
openclaw onboard # 引导配置 openclaw gateway start # 启动 Gateway openclaw gateway restart # 重启 Gateway openclaw gateway stop # 停止 Gateway openclaw gateway logs # 查看日志 openclaw channels login --channel feishu # 配置飞书渠道 openclaw update # 更新 OpenClaw |
十二、总结
到这里，你已经完成了从零开始的全流程：
现在你可以在飞书中随时和你的 AI 助手对话了！如果后续想要接入更多渠道（微信等），或者配置更多 AI 模型，可以参考 OpenClaw 的官方文档：https://docs.openclaw.ai
