龍蝦熱過(guò)去一段時(shí)間了，我今天在我的老古董電腦上，開始折騰。

以下操作全程均是codex的cli完成的，包括以下的經(jīng)驗(yàn)總結(jié)也是codex整理的。

1. 背景

我的目標(biāo)是：

• 在 Windows 電腦上安裝 OpenClaw
• 使用 Qwen / 阿里云百煉 作為模型
• 接入 飛書機(jī)器人
• 實(shí)現(xiàn)通過(guò)飛書和 OpenClaw 正常對(duì)話

最終方案不是在 Windows 原生環(huán)境里跑，而是采用：

Windows + WSL2 + Ubuntu + OpenClaw

這是因?yàn)?OpenClaw 在 Windows 上雖然也能裝，但實(shí)際穩(wěn)定性上，WSL2 更合適。

2. 什么是 WSL

WSL 全稱是：Windows Subsystem for Linux

它的作用是：

• 在 Windows 里運(yùn)行一個(gè) Linux 環(huán)境
• 可以裝 Ubuntu、Debian 等發(fā)行版
• 可以直接訪問(wèn) Windows 文件系統(tǒng)

比如：

• Windows 的 C:\Users\Lenovo\Desktop
• 在 WSL 里對(duì)應(yīng) /mnt/c/Users/Lenovo/Desktop

所以：

• OpenClaw 運(yùn)行在 Ubuntu 里
• 但仍然可以訪問(wèn) Windows 文件

這一點(diǎn)很重要。

3. 為什么用 WSL 安裝 OpenClaw

原因主要有三個(gè)：

1. OpenClaw 官方對(duì) Linux / WSL2 支持更穩(wěn)
2. Node、npm、依賴工具鏈在 Ubuntu 里更容易處理
3. 方便后續(xù)接 AI 工具、命令行、網(wǎng)關(guān)服務(wù)

但也要注意：

• OpenClaw 在 WSL 里運(yùn)行時(shí)，默認(rèn)更擅長(zhǎng)處理“文件”
• 如果你想操作 Windows 進(jìn)程，比如關(guān)閉 Chrome，需要額外通過(guò) powershell.exe、taskkill.exe 之類橋接

4. Windows 上安裝 WSL2

先在管理員 PowerShell 執(zhí)行：

wsl --install

執(zhí)行完成后重啟電腦。

然后確認(rèn) Ubuntu 是否已經(jīng)安裝好：

wsl -l -v

如果看到類似：

  NAME      STATE           VERSION
* Ubuntu    Running         2

說(shuō)明：

• Ubuntu 已裝好
• 而且是 WSL2

這里必須是 VERSION 2。如果是 1，OpenClaw 和 npm 相關(guān)能力會(huì)出問(wèn)題。

5. 打開 Ubuntu

可以用兩種方式：

開始菜單搜索 Ubuntu

PowerShell 執(zhí)行：

wsl -d Ubuntu

第一次打開 Ubuntu 會(huì)要求你設(shè)置：

• Linux 用戶名
• Linux 密碼

6. 安裝 Node.js 和 npm

在 Ubuntu 里執(zhí)行：

sudo apt update
sudo apt install -y curl ca-certificates gnupg
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

驗(yàn)證：

node -v
npm -v

這里踩過(guò)一個(gè)坑：

早期如果 Ubuntu 實(shí)際運(yùn)行在 WSL1

npm -v 會(huì)直接報(bào)：WSL 1 is not supported

所以再次強(qiáng)調(diào)：一定要確認(rèn)是 WSL2

7. 安裝 OpenClaw

最開始嘗試直接裝最新版時(shí)，遇到過(guò)問(wèn)題版本。

7.1 錯(cuò)誤包名

一開始誤用了：

npm install -g @openclaw/cli

這是錯(cuò)的。

正確包名是：

npm install -g openclaw@latest

7.2 全局安裝權(quán)限問(wèn)題

普通用戶直接執(zhí)行會(huì)報(bào)：EACCES: permission denied, mkdir '/usr/lib/node_modules/openclaw'

解決方式：

sudo npm install -g openclaw@latest

7.3 最新版包缺依賴

裝 latest 后，openclaw --version 能跑，但 openclaw doctor 報(bào)錯(cuò)：Cannot find module '@buape/carbon'

最后回退到穩(wěn)定版本：

sudo npm uninstall -g openclaw
sudo npm cache clean --force
sudo npm install -g openclaw@2026.4.2

驗(yàn)證：

openclaw --version
openclaw doctor

8. 初始化 OpenClaw

執(zhí)行：

openclaw doctor --fix
openclaw config set gateway.mode local
openclaw doctor

這樣會(huì)完成：

• 基礎(chǔ)目錄初始化
• gateway 配置
• session 存儲(chǔ)目錄創(chuàng)建
• shell completion 安裝

9. 接入 Qwen / 阿里云百煉

9.1 API Key 獲取位置

Qwen 的 API Key 不是在 OpenClaw 里生成，而是在阿里云百煉控制臺(tái)生成。

正確入口類似：阿里云百煉 / Model Studio / DashScope 的 API Key 頁(yè)面

拿到的 key 類似：sk-xxxx

9.2 最大坑：OpenClaw 2026.4.2 的內(nèi)置modelstudioprovider 兼容問(wèn)題

今天最折騰的地方就在這。

現(xiàn)象是：

直接配置 qwen / modelstudio provider 后

OpenClaw 在飛書里回復(fù)時(shí)會(huì)報(bào)：

HTTP 401: invalid access token or token expired

但奇怪的是：

• 這把百煉 key 用 curl 直接請(qǐng)求阿里云兼容接口時(shí)是正常的
• /models 能列模型
• /chat/completions 也能正常返回 回答

也就是說(shuō)：

• key 本身沒(méi)問(wèn)題
• 問(wèn)題在 OpenClaw 這版對(duì)內(nèi)置 provider 的兼容實(shí)現(xiàn)

9.3 最終解決方案：改用阿里云百煉 OpenAI 兼容接口

這是今天真正打通的關(guān)鍵。

最終改成：

• 自定義 provider
• Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
• Model：qwen3.5-plus

也就是說(shuō)，不再依賴 OpenClaw 自帶的 modelstudio provider，而是把百煉當(dāng)成一個(gè) OpenAI 兼容模型服務(wù)來(lái)接。

最終默認(rèn)模型變成：custom-dashscope-aliyuncs-com/qwen3.5-plus

這個(gè)方式是最終穩(wěn)定跑通飛書回復(fù)的關(guān)鍵修復(fù)。

10. 接入飛書機(jī)器人

10.1 飛書應(yīng)用創(chuàng)建

在飛書開放平臺(tái)創(chuàng)建企業(yè)自建應(yīng)用。

拿到兩項(xiàng)：

• App ID
• App Secret

10.2 OpenClaw 側(cè)配置

把 Feishu 渠道寫進(jìn) OpenClaw 配置，關(guān)鍵字段包括：

• enabled = true
• connectionMode = websocket
• domain = feishu
• dmPolicy = pairing

并填入：

• appId
• appSecret

10.3 飛書后臺(tái)必須配置的內(nèi)容

機(jī)器人能力

需要開啟：機(jī)器人

事件訂閱

在 事件與回調(diào) 中：

• 訂閱方式選 使用長(zhǎng)連接接收事件
• 添加事件：im.message.receive_v1

權(quán)限管理

這里踩坑最多。

最開始機(jī)器人能連上，但不回復(fù)。最后看飛書日志才定位到，缺的是權(quán)限。

實(shí)際需要重點(diǎn)關(guān)注：

• im:message:send_as_bot
• im:message
• im:message:readonly
• im:message.p2p_msg:readonly
• im:message.group_at_msg:readonly
• contact:contact.base:readonly

飛書日志里會(huì)很明確地報(bào)：

• 缺聯(lián)系人權(quán)限
• 缺發(fā)送消息權(quán)限

所以排查飛書問(wèn)題時(shí)，一定要看飛書開放平臺(tái)日志搜索里的真實(shí)報(bào)錯(cuò)，不要只看頁(yè)面狀態(tài)。

11. 飛書打不通時(shí)遇到的幾個(gè)坑

11.1 機(jī)器人不回復(fù)，不一定是 OpenClaw 沒(méi)收到消息

有一段時(shí)間實(shí)際情況是：

• 飛書事件已經(jīng)推給 OpenClaw 了
• OpenClaw 日志里能看到：received message
• 但因?yàn)闄?quán)限不夠，拿不到聯(lián)系人信息，或者沒(méi)法發(fā)消息
• 所以用戶側(cè)看起來(lái)就是“機(jī)器人沒(méi)回復(fù)”

11.2 pairing 模式會(huì)攔住首次私聊

當(dāng)前 dmPolicy = pairing

這意味著：

• 第一次私聊不會(huì)立刻放行
• OpenClaw 會(huì)生成一個(gè) pairing request
• 需要手工審批

如果飛書權(quán)限當(dāng)時(shí)不完整，配對(duì)碼回復(fù)會(huì)失敗，于是就會(huì)卡住。

后來(lái)通過(guò)命令查看到待審批請(qǐng)求：

openclaw pairing list feishu

然后批準(zhǔn)：

openclaw pairing approve feishu <code>

批準(zhǔn)后才真正打通。

11.3 有時(shí)飛書后臺(tái)顯示“調(diào)用成功”，但機(jī)器人仍不回復(fù)

這種情況今天也遇到了。

最終定位后發(fā)現(xiàn)原因不是只有一個(gè)，而是可能疊加：

• pairing 未審批
• 飛書權(quán)限未完整生效
• 模型調(diào)用失敗
• OpenClaw provider 兼容問(wèn)題
• 臨時(shí) DNS 問(wèn)題

所以必須結(jié)合：

• 飛書開放平臺(tái)日志
• OpenClaw channels logs
• OpenClaw pairing list

一起看。

12. 最終打通鏈路

最后真正穩(wěn)定工作時(shí)，鏈路是：

• 用戶在飛書里私聊機(jī)器人
• 飛書通過(guò)長(zhǎng)連接把消息投遞給 OpenClaw
• OpenClaw 網(wǎng)關(guān)收到消息
• OpenClaw 調(diào)用阿里云百煉 OpenAI 兼容接口
• Qwen 返回結(jié)果
• OpenClaw 再把結(jié)果發(fā)回飛書

最終現(xiàn)象就是：飛書里機(jī)器人可以正常回復(fù)

13. 為什么 OpenClaw 能改 Windows 文件，但不擅長(zhǎng)直接控制 Windows 進(jìn)程

這是 WSL 架構(gòu)決定的。

可以直接處理 Windows 文件

因?yàn)?WSL 掛載了 Windows 磁盤：

• C:\ -> /mnt/c/
• D:\ -> /mnt/d/
• E:\ -> /mnt/e/

所以 OpenClaw 運(yùn)行在 Ubuntu 里，仍然可以讀寫 Windows 文件。

但不能像原生 Windows 程序那樣直接控制進(jìn)程

比如關(guān)閉 Chrome，這不是文件操作，而是操作 Windows 進(jìn)程。

WSL 下如果要做這種事，要通過(guò)橋接命令，例如：

powershell.exe -Command "Stop-Process -Name chrome -Force"

或者：

taskkill.exe /IM chrome.exe /F

所以：

• 文件操作：天然支持
• Windows 進(jìn)程操作：需要額外橋接

14. 最終結(jié)論

如果你想在 Windows 上長(zhǎng)期穩(wěn)定使用 OpenClaw，并接入飛書，建議采用：

• Windows + WSL2 + Ubuntu + OpenClaw

并注意下面幾個(gè)關(guān)鍵點(diǎn)：

1. 必須確認(rèn) Ubuntu 運(yùn)行在 WSL2
2. OpenClaw 不要盲目追 latest，有問(wèn)題時(shí)要回退穩(wěn)定版本
3. Qwen / 阿里云百煉在這次環(huán)境里，內(nèi)置 modelstudio provider 存在兼容坑
4. 最終穩(wěn)定方案是改用：
   • 阿里云百煉 OpenAI 兼容接口
5. 飛書接入時(shí)，真正的排障重點(diǎn)是：
   • 事件與回調(diào)
   • 權(quán)限管理
   • pairing
   • OpenClaw channels logs
   • 飛書后臺(tái)日志

15. 建議的后續(xù)優(yōu)化

后續(xù)還可以繼續(xù)做這些優(yōu)化：

• 把 OpenClaw 的 workspace 指到常用 Windows 目錄
• 調(diào)整 timeoutSeconds
• 切換到更快的 Qwen 模型
• 配置系統(tǒng)命令橋接，讓機(jī)器人能間接操作 Windows 進(jìn)程
• 旋轉(zhuǎn)已經(jīng)暴露過(guò)的：
  • 阿里云百煉 API Key
  • 飛書 App Secret

到此這篇關(guān)于Windows下通過(guò)WSL安裝OpenClaw并接入飛書的完整踩坑記錄的文章就介紹到這了,更多相關(guān)Windows安裝OpenClaw并接入飛書內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論