Windows 10零基礎部署OpenClaw-CN（龍蝦）全流程指南

你剛下載了龍蝦（OpenClaw-CN），想讓它在飛書里自動回復“今天天氣怎么樣？”——但雙擊openclaw-cn.exe沒反應，命令行報錯Access is denied，或者機器人發(fā)消息后石沉大海？別折騰注冊表或Python環(huán)境了。這篇教程專為Windows 10新手設計，不裝Docker、不配Python、不改代碼，全程用官方預編譯包（v2.3.1，2026年3月最新版），從申請飛書憑證到收到第一條機器人回復，實測47分鐘完成。

問題：為什么龍蝦在Windows上總啟動失敗？

常見原因有三個：

• 飛書App沒開通「機器人」權限，ID/Secret無效；
• Windows默認阻止未簽名exe運行（尤其首次解壓后）；
• 服務后臺靜默崩潰，但沒人看日志——而openclaw-cn logs -f才是真正的“診斷儀”。

方案：三步走，開箱即用

1. 在飛書開放平臺申請帶機器人權限的App；
2. 解壓后一鍵修復系統(tǒng)安全策略；
3. 啟動服務 + 發(fā)送測試消息 → 看日志確認連通性。

步驟（全部可復制粘貼）

? 第一步：申請飛書App ID和App Secret

1. 打開 飛書開放平臺 → 登錄企業(yè)管理員賬號；
2. 進入「開發(fā)者后臺」→「應用管理」→「創(chuàng)建應用」；
3. 填寫名稱（如“龍蝦測試”），選擇「企業(yè)自建應用」；
4. 關鍵操作：在「功能」頁勾選「機器人」→ 點擊「配置機器人」→ 設置頭像、名稱（如“龍蝦小助手”）→ 保存；
5. 返回「憑證與基礎信息」頁，復制 App ID 和 App Secret —— 這兩個值將直接填進龍蝦配置文件。

?? 為什么必須勾選「機器人」？因為OpenClaw-CN靠飛書機器人API收發(fā)消息，沒這個權限，它連消息都收不到，更別說回復。

? 第二步：修復Windows安全權限（繞過SmartScreen攔截）

下載 openclaw-cn-v2.3.1-windows-amd64.zip（官網(wǎng)www.xmhny.cn/downloads），解壓到 D:\openclaw（不要放在C:\Users\XXX\Downloads這種路徑！）。

右鍵解壓后的文件夾 → 「屬性」→ 勾選「解除鎖定」→ 點擊「確定」。

然后以管理員身份運行PowerShell（開始菜單搜“PowerShell”，右鍵選“以管理員身份運行”），執(zhí)行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
cd D:\openclaw
.\openclaw-cn.exe config set --app-id "cli_xxx" --app-secret "xxx"

把上面 cli_xxx 和 xxx 換成你第一步拿到的ID和Secret（注意保留引號）。

?? 為什么必須“管理員運行”+“解除鎖定”？Windows 10默認阻止從未知來源下載的exe執(zhí)行，不解除鎖定會報Access is denied；不提權則無法寫入本地配置文件。

? 第三步：啟動服務并驗證機器人

繼續(xù)在同一個PowerShell窗口執(zhí)行：

.\openclaw-cn.exe service start
.\openclaw-cn.exe logs -f

你會看到滾動日志：

[INFO] Bot registered: lark://bot/xxx  
[INFO] Listening on port 8080  
[INFO] Webhook received → reply sent to user "張三"

此時打開飛書，搜索機器人名稱（如“龍蝦小助手”），點擊進入對話，發(fā)送 /help 或任意文字。
2秒內收到回復，說明部署成功 ?

?? logs -f 是實時日志流，比反復重啟服務快10倍。如果沒回復，立刻看這里：

• 出現(xiàn) invalid signature → App ID/Secret填錯了；
• 卡在 Starting webhook server... → 防火墻攔截了8080端口（臨時關閉防火墻再試）；
• 日志空白 → 服務根本沒啟動，重跑 service start。

常見問題（實測高頻）

Q：啟動后日志顯示 port 8080 already in use？
A：其他程序占用了8080（比如本地Web服務器）。改端口：

.\openclaw-cn.exe config set --port 8090
.\openclaw-cn.exe service restart

Q：飛書提示“該機器人暫不可用”？
A：檢查飛書App是否已「發(fā)布上線」——在「應用管理」頁，找到你的App，點「發(fā)布」→「發(fā)布到當前企業(yè)」。

Q：能收消息但不回復？
A：大概率模型沒加載。龍蝦默認用本地Ollama的qwen2:7b。先確保Ollama已安裝（官網(wǎng)ollama.com），再運行：

ollama run qwen2:7b

等它輸出 >>> 后，再重啟龍蝦服務。

下一步建議

你現(xiàn)在已打通“飛書 ? 本地大模型”鏈路。下一步可：

• 【進階】讓龍蝦調用你的私有知識庫：《用Dify+龍蝦搭建飛書智能客服》
• 【實戰(zhàn)】把龍蝦接入釘釘/企微：《多IM平臺統(tǒng)一接入MCP協(xié)議實戰(zhàn)》
• 【優(yōu)化】提升響應速度：《Windows下Ollama顯存優(yōu)化與量化部署指南》

所有教程均在 www.xmhny.cn/ai-tutorials，全部含視頻演示+可運行代碼包。
部署不是終點，而是你AI工程落地的第一步。