Win10一键部署龙虾AI（OpenClaw-CN）全避坑指南

双击 install.bat 弹红框？飞书机器人不回消息？日志里全是 Access is denied 或 Failed to bind port 8000？别删重装——90% 的问题卡在三处：飞书凭证填错、Windows 默认禁用脚本、端口被微信/QQ 占了。这篇指南只讲实操，30 分钟内让你的本地 AI 机器人在飞书群里真·开口说话。

❓为什么装完打不开？

龙虾AI 是个中间人：你发消息 → 飞书服务器转发到你的电脑 → OpenClaw-CN 接收 → 调用本地大模型 → 生成回复 → 发回飞书。任一环节断开，机器人就静音。

Win10 用户注意两个硬性前提：

• PowerShell 远程策略默认关闭（微软从 2025 年 10 月起强制），必须手动放开；
• 飞书开放平台已要求 App 开启「事件订阅」，但龙虾支持 HTTP 本地调试，我们跳过 HTTPS 强制校验，直接用 http://127.0.0.1:8000 完成验证。

✅三步闭环验证法

不装模型、不配 GPU、不碰 Docker。只做三件事：拿到飞书凭证 → 放行系统权限 → 看日志确认连通。每步自带失败自检点。

步骤1：飞书 App ID / Secret —— 普通账号也能配

⚠️必须用「自建应用」，不是「小程序」或「机器人应用」。

1. 登录 飞书开放平台 → 右上角头像 →「开发者后台」→「创建应用」
2. 类型选「自建应用」→ 填名称（如“我的龙虾”）→ 提交
3. 进入新应用 → 左侧「凭证与基础信息」→ 复制 App ID 和 App Secret（32 位小写字母+数字）

4. 打开 C:\openclaw-cn\config.yaml（记事本即可），修改：

   feishu:
     app_id: "cli_xxxxxxxx"     # 粘贴你的 App ID（带 cli_ 前缀）
     app_secret: "xxxxxxxxxxxx" # 粘贴你的 App Secret

   ✅验证：保存后运行 openclaw-cn config show，应输出脱敏 ID（末 4 位可见），无报错。

步骤2：修复 Windows 10 权限 —— 绕过 PowerShell 执行策略

Win10 默认禁止运行本地脚本，包括龙虾的 start.bat。这是最常被跳过的一步。

1. 右键「开始」→「Windows PowerShell（管理员）」

2. 粘贴并执行（整行，含空格）：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

   💡说明：RemoteSigned 允许运行本地脚本，仅要求网络下载的脚本有签名；龙虾安装包是本地文件，完全合规。-Force 跳过确认。

3. 关闭 PowerShell，再以管理员身份运行 C:\openclaw-cn\start.bat
   ✅验证：窗口不再闪退，底部出现 INFO: Uvicorn running on http://0.0.0.0:8000

步骤3：实测响应 + 日志排障 —— 报错要看得懂

启动服务后，机器人还不会动。需要手动触发一次飞书的「事件订阅」验证。

1. 回到飞书开放平台 → 应用 → 「事件订阅」→ 开启开关 → 在「验证URL」栏填：

   http://127.0.0.1:8000/api/v1/feishu/event

2. 点「验证」→ 切回 start.bat 窗口，应立刻刷出绿色日志：

   INFO:     127.0.0.1:xxxxx - "POST /api/v1/feishu/event HTTP/1.1" 200 OK

3. 排障命令（任意 CMD 窗口运行）：

   openclaw-cn logs -f

   📌典型报错及对策：

4. OSError: [WinError 10013] 以一种访问权限不允许的方式做了一个访问套接字的尝试 → 端口被占：运行 netstat -ano | findstr :8000，记下 PID，再执行 taskkill /F /PID XXXX（常见占用者：腾讯会议、网易云音乐、迅雷）
5. Connection refused → start.bat 窗口已关闭或崩溃，重新运行它
6. Invalid signature → config.yaml 中 app_secret 多粘了一个空格，删掉重填

✅验证：在飞书群 @ 机器人发 /help，10 秒内收到文字回复（不是飞书默认的“正在处理”）

👉 Binance · OKX · Gate.io · HTX · Bitget

❓常见问题直答

Q：装了 CUDA，但日志显示 “no GPU found”？
A：龙虾默认走 CPU 推理，无需 GPU。想加速？等下一篇《Ollama+OpenClaw-CN 本地模型热替换》。

Q：飞书提示 “回调地址不可达”，但 http://127.0.0.1:8000 本地能打开？
A：正常。飞书服务器确实无法访问你本地地址——验证 URL 仅用于首次握手，后续所有消息由飞书主动推送到你的 8000 端口，不依赖公网。

Q：openclaw-cn logs -f 报 “command not found”？
A：C:\openclaw-cn\bin 没加进系统 PATH。临时解法：在 start.bat 同目录按住 Shift + 右键 →「在此处打开 PowerShell 窗口」→ 再运行该命令。

下一步

机器人能回话只是起点。推荐继续：
→ 《让龙虾读你本地 PDF：3 步接入 RAG 知识库》
→ 《零代码对接 Ollama：在飞书里直接问“总结上周会议纪要”》
→ 《Windows 防火墙放行指南：让公司内网同事也能 @ 你的 AI》

所有教程基于 2026 年 5 月真实环境测试。点击官网导航栏「实战教程」直达。遇到报错？截图发龙虾官方 QQ 群（群号见首页），附上 openclaw-cn logs --tail 50 输出，我们人工盯到你跑通。