Windows 10 安装 OpenClaw-CN（龙虾）超详细教程：不是“又一个机器人”，而是你的AI工作流中枢

问题：你写完一段Python代码，还要手动复制粘贴到飞书群里问同事？

你调试API时，得反复切窗口、开Postman、查文档、再改代码？你搭了个Dify流程，但客户消息一来，还得人工转发、等回复、再复制回聊天窗口？——这不是AI时代该有的节奏。

OpenClaw-CN（龙虾）解决的不是“怎么发一条机器人消息”，而是把AI能力像USB接口一样，插进你每天用的办公软件里。它不是独立聊天窗口，而是一个运行在本地的“AI中转站”：飞书消息进来 → 龙虾自动识别意图 → 调用本地Ollama模型/远程Claude/你的Python脚本 → 生成结果 → 原路返回飞书。全程零手动操作，响应延迟<1.2秒（实测i5-10210U + 16GB内存）。

方案：用 openclaw-cn 把飞书变成你的AI编程助手

它不替代你写代码，而是帮你省掉重复劳动环节：自动解释报错、生成单元测试、翻译日志、甚至根据飞书里的需求截图，直接生成前端HTML代码。

✅ 关键技术价值：

• 真本地化：所有敏感数据（如代码片段、内部API密钥）不出你电脑；
• 协议级集成：不是网页爬虫，而是通过飞书官方Bot API通信，权限可控、稳定不封号；
• 可编程扩展：每个消息触发后，你能用Python写任意逻辑（比如收到“查数据库”就自动执行SQL并截图发回）。

步骤：从零安装，5分钟跑通第一条机器人回复

1. 安装前提（为什么必须做？）

Windows 10需启用WSL2（Linux子系统），因为龙虾核心服务基于Go+Python，原生Windows支持弱，WSL2提供稳定POSIX环境，避免权限崩溃和路径错误。

# 以管理员身份打开PowerShell，逐行执行：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重启电脑

2. 安装WSL2并设为默认

下载WSL2内核更新包，安装后执行：

wsl --update
wsl --set-default-version 2
wsl --install -d Ubuntu-22.04

⚠️ 为什么不用Docker Desktop？龙虾依赖systemd服务管理，WSL2原生支持，Docker Desktop在Win10上常因Hyper-V冲突失败。

3. 安装OpenClaw-CN

在Ubuntu终端中执行（自动处理Go环境、依赖、服务注册）：

curl -fsSL https://raw.githubusercontent.com/yitb/openclaw-cn/main/install.sh | bash

4. 配置飞书机器人（关键一步）

登录飞书开放平台 → 创建企业自建应用 → 复制 App ID 和 App Secret → 粘贴到配置文件：

nano ~/.openclaw/config.yaml

填入：

feishu:
  app_id: "cli_xxx"      # 替换为你的真实App ID
  app_secret: "xxx"      # 替换为你的真实App Secret
  encrypt_key: ""        # 留空（开发模式不加密）
  verification_token: "" # 留空

🔑 为什么留空加密字段？新手阶段先关掉签名验证，避免401错误卡死；上线前再按龙虾安全指南补全。

5. 启动并测试

openclaw-cn start
# 查看实时日志（重点看最后一行是否出现 "Bot started"）
openclaw-cn logs -f

然后在飞书群中@你的机器人，发送 /help —— 如果秒回菜单，说明通了。

验证：真实场景效果

• 场景1：你在飞书发 @龙虾 解释这段报错：requests.exceptions.ConnectionError: Max retries exceeded
  → 龙虾调用本地Qwen2.5-7B（Ollama），3秒内返回：

  “这是网络连接超时。检查：① 代理是否开启（echo $HTTP_PROXY）；② 目标URL能否curl通；③ requests代码里是否漏了timeout=(3, 7)参数。”

• 场景2：发 /test python print('hello')
  → 龙虾直接执行代码，返回 hello（沙箱隔离，安全无害）。

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

常见问题

Q：启动后日志卡在 waiting for feishu webhook...？
A：飞书后台没开启「事件订阅」。进入应用后台 →「机器人」→「事件订阅」→ 开启「消息事件」→ 填写请求URL为 http://localhost:8080/api/v1/feishu/webhook（注意是localhost，不是127.0.0.1）。

Q：中文乱码或表情显示为？
A：WSL2默认UTF-8编码未生效。在Ubuntu中执行：

echo 'export LANG=C.UTF-8' >> ~/.bashrc && source ~/.bashrc

Q：想让机器人只响应某几个群？
A：编辑 config.yaml，加一行：

feishu:
  allow_chat_ids: ["oc_xxx", "oc_yyy"]  # 群ID在飞书群右上角「群设置」→「群管理」里找

下一步建议

✅ 先用龙虾自动回复高频问题（如部署步骤、环境变量说明），每天省下15分钟；
✅ 接着接入本地Ollama：ollama run qwen2.5:7b，让机器人回答更专业；
✅ 进阶：用Python写一个 /sql <查询语句> 指令，连接公司MySQL只读库（示例代码见《龙虾+数据库实战》）。

💡 提醒：龙虾不是玩具。我们见过团队用它把飞书客服响应时间从47分钟压到22秒——关键不在模型多大，而在让AI活在你最常用的工具里。

点击查看：如何用龙虾自动解析飞书表格并生成Python分析脚本 →