Windows 10零基础部署OpenClaw-CN（龙虾）全流程指南

你刚下载了龙虾（OpenClaw-CN），想让它在飞书里自动回复“今天天气怎么样？”——但双击openclaw-cn.exe没反应，命令行报错Access is denied，或者机器人发消息后石沉大海？别折腾注册表或Python环境了。这篇教程专为Windows 10新手设计，不装Docker、不配Python、不改代码，全程用官方预编译包（v2.3.1，2026年3月最新版），从申请飞书凭证到收到第一条机器人回复，实测47分钟完成。

问题：为什么龙虾在Windows上总启动失败？

常见原因有三个：

• 飞书App没开通「机器人」权限，ID/Secret无效；
• Windows默认阻止未签名exe运行（尤其首次解压后）；
• 服务后台静默崩溃，但没人看日志——而openclaw-cn logs -f才是真正的“诊断仪”。

方案：三步走，开箱即用

1. 在飞书开放平台申请带机器人权限的App；
2. 解压后一键修复系统安全策略；
3. 启动服务 + 发送测试消息 → 看日志确认连通性。

步骤（全部可复制粘贴）

✅ 第一步：申请飞书App ID和App Secret

1. 打开 飞书开放平台 → 登录企业管理员账号；
2. 进入「开发者后台」→「应用管理」→「创建应用」；
3. 填写名称（如“龙虾测试”），选择「企业自建应用」；
4. 关键操作：在「功能」页勾选「机器人」→ 点击「配置机器人」→ 设置头像、名称（如“龙虾小助手”）→ 保存；
5. 返回「凭证与基础信息」页，复制 App ID 和 App Secret —— 这两个值将直接填进龙虾配置文件。

💡 为什么必须勾选「机器人」？因为OpenClaw-CN靠飞书机器人API收发消息，没这个权限，它连消息都收不到，更别说回复。

✅ 第二步：修复Windows安全权限（绕过SmartScreen拦截）

下载 openclaw-cn-v2.3.1-windows-amd64.zip（官网yitb.com/downloads），解压到 D:\openclaw（不要放在C:\Users\XXX\Downloads这种路径！）。

右键解压后的文件夹 → 「属性」→ 勾选「解除锁定」→ 点击「确定」。

然后以管理员身份运行PowerShell（开始菜单搜“PowerShell”，右键选“以管理员身份运行”），执行：

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执行，不解除锁定会报Access is denied；不提权则无法写入本地配置文件。

✅ 第三步：启动服务并验证机器人

继续在同一个PowerShell窗口执行：

.\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 "张三"

此时打开飞书，搜索机器人名称（如“龙虾小助手”），点击进入对话，发送 /help 或任意文字。
2秒内收到回复，说明部署成功 ✅

💡 logs -f 是实时日志流，比反复重启服务快10倍。如果没回复，立刻看这里：

• 出现 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是否已「发布上线」——在「应用管理」页，找到你的App，点「发布」→「发布到当前企业」。

Q：能收消息但不回复？
A：大概率模型没加载。龙虾默认用本地Ollama的qwen2:7b。先确保Ollama已安装（官网ollama.com），再运行：

ollama run qwen2:7b

等它输出 >>> 后，再重启龙虾服务。

下一步建议

你现在已打通“飞书 ↔ 本地大模型”链路。下一步可：

• 【进阶】让龙虾调用你的私有知识库：《用Dify+龙虾搭建飞书智能客服》
• 【实战】把龙虾接入钉钉/企微：《多IM平台统一接入MCP协议实战》
• 【优化】提升响应速度：《Windows下Ollama显存优化与量化部署指南》

所有教程均在 yitb.com/ai-tutorials，全部含视频演示+可运行代码包。
部署不是终点，而是你AI工程落地的第一步。