使用OpenClaw“龙虾”“六要六不要”！

#
OpenClaw Windows 部署完整指南 环境准备与前置条件 系统要求与软件依赖 在开始部署
OpenClaw 之前，需要确保 Windows 系统满足以下基本要求： | 组件 | 最低要求 | 推荐版本 | 作用说明 | |——|———-|———-|———-| | 操作系统 | Windows 10 | Windows 10/11 | 支持现代 PowerShell 和 Node.js | | Node.js | v18.0.0+ | v22.13.1+ |
OpenClaw 运行环境 [ref_4] | | npm | v8.0.0+ | v10.9.4+ | 包管理工具 [ref_4] | | Git | 2.30.0+ | 最新版本 | 代码版本控制 [ref_2] | | PowerShell | 5.1+ | 7.0+ | 脚本执行环境 [ref_2] | Node.js 环境配置 推荐
使用 nvm-windows 管理 Node.js 版本，避免权限问题和版本冲突： “`powershell #
使用 nvm 安装指定版本的 Node.js nvm install 22.13.1 nvm use 22.13.1 # 验证安装 node –version # 应该输出 v22.13.1 npm –version # 应该输出 v10.9.4+ “` 如果选择直接安装 Node.js，请从官网下载 v22.x 以上的 LTS 版本 [ref_1]。 部署步骤详解 1. PowerShell 执行策略配置 首先需要调整 PowerShell 执行策略以允许脚本运行： “`powershell # 以管理员身份运行 PowerShell，然后执行： Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # 验证策略设置 Get-ExecutionPolicy -List “` 这个步骤解决了脚本执行权限问题，是后续安装的基础 [ref_5]。 2.
OpenClaw 安装 根据不同的
使用场景，可以选择以下安装方式之一： 方式一：全局安装（推荐） “`powershell # 安装
OpenClaw 中文版 npm install -g
openclaw-cn –ignore-scripts # 验证安装
openclaw –version “` `–ignore-scripts` 参数用于规避潜在的编译问题 [ref_4]。 方式二：从源码安装 “`powershell # 克隆项目 git clone https://github.com/
openclaw/
openclaw.git cd
openclaw #
使用 pnpm 安装依赖 npm install -g pnpm pnpm install # 配置镜像源（国内用户） pnpm config set registry https://registry.npmmirror.com/ “` pnpm 提供了更快的依赖安装速度和磁盘空间优化 [ref_3]。 3. 启动网关服务 安装完成后启动
OpenClaw 网关： “`powershell # 启动网关服务
openclaw gateway start # 或者
使用开发模式 npm run dev “` 服务启动后，可以通过 `http://localhost:18789` 访问
OpenClaw 的可视化界面 [ref_2]。 配置与集成 AI 服务配置
OpenClaw 支持多种 AI 服务提供商，以下以 DeepSeek 为例： “`yaml # 在
OpenClaw 配置文件中添加 ai_providers: deepseek: api_key: “your_deepseek_api_key_here” base_url: “https://api.deepseek.com” model: “deepseek-chat” “` 获取 API 密钥后，需要在
OpenClaw 的 Web 界面中完成配置 [ref_5]。 飞书集成配置 创建飞书应用 1. 访问[飞书开放平台](https://open.feishu.cn/) 2. 创建企业自建应用 3. 配置以下权限： – `im:message` – `im:message.group_at_msg` – `im:message.p2p_msg` 事件订阅配置 “`yaml event_subscription: – im.message.receive_v1 verification_token: “your_verification_token” encrypt_key: “your_encrypt_key” “` 事件订阅确保
OpenClaw 能够接收和处理飞书消息 [ref_6]。 应用凭证配置 在
OpenClaw 配置中填入飞书应用的凭证： “`javascript // config/feishu.js module.exports = ; “` 完成配置后，
使用配对码将
OpenClaw 与飞书应用绑定 [ref_2]。 常见问题解决方案 安装问题排查 问题：npm 安装失败 “`powershell # 清理缓存并重新安装 npm cache clean –force npm install -g
openclaw-cn –ignore-scripts # 如果网络问题，配置淘宝镜像 npm config set registry https://registry.npmmirror.com/ “` 问题：PowerShell 脚本执行被阻止 “`powershell # openclaw 龙虾 检查当前用户执行策略 Get-ExecutionPolicy # 如果受限，
使用管理员权限设置 Set-ExecutionPolicy Bypass -Scope Process “` 服务启动问题 问题：端口 18789 被占用 “`powershell # 查找占用端口的进程 netstat -ano | findstr :18789 # 终止相关进程或修改
OpenClaw 端口配置
openclaw gateway start –port 18790 “` 问题：网关服务无法启动 检查 Node.js 版本是否符合要求，确保所有依赖正确安装 [ref_1]。 飞书集成问题 问题：消息无法接收 1. 验证飞书应用权限配置 2. 检查事件订阅 URL 可访问性 3. 确认 verification token 匹配 问题：AI 工具调用识别失败 在向 AI 发送指令时，需要明确声明技能名称以触发自动检测机制。例如：”请
使用邮箱技能发送邮件” [ref_1]。 验证部署成功 基础功能验证 1. 服务访问：浏览器打开 `http://localhost:18789` 应该显示
OpenClaw 仪表盘 2. API 测试：
使用以下命令测试基础 API： “`bash curl -X GET “http://localhost:18789/api/health” “` 应该返回服务状态信息。 飞书集成验证 1. 在飞书中向绑定的应用发送消息 2. 查看
OpenClaw 日志确认消息接收 3. 测试 AI 功能响应 技能配置验证 通过 ClawHub 平台下载并配置技能，测试具体功能如邮箱发送、数据查询等 [ref_1]。 进阶配置与优化 性能优化建议 “`yaml # 生产环境配置优化 performance: max_workers: 4 cache_ttl: 3600 request_timeout: 30000 “` 安全配置 “`yaml security: ssl_enabled: true cors_origins: – https://your-domain.com rate_limiting: enabled: true max_requests: 100 window_ms: “` 通过以上完整的部署流程，可以在 Windows 系统上成功搭建
OpenClaw 环境，并实现与飞书等平台的无缝集成，为后续的 AI 应用开发奠定坚实基础。