最近，OpenClaw（大龙虾）在开发者圈中迅速走红，许多开发者都在探索如何在Windows环境下本地部署、如何接入飞书机器人、如何添加Skill技能以及如何解决运行中遇到的各种问题。本文将从零开始，为大家提供一个详细的教程，帮助新手顺利搭建并运行OpenClaw。
一、OpenClaw简介
OpenClaw是一个可扩展技能的AI Agent框架，具有以下特点：
-
支持插件化Skill，实现工具使用和自我进化
-
可接入移动端，支持飞书、Discord、Telegram等平台发布指令
-
记忆可插拔，支持本地部署运行
OpenClaw就像一个“分身”，可以在手机端发送任务后，24小时不间断地使用你的电脑进行工作，非常适合作为AI助手、企业机器人或自动化工具。
二、本地部署步骤（Windows系统）
系统环境要求：Windows 10或Windows 11
项目官方及开源地址：OpenClaw项目官网及开源仓库
-
安装Node.js
-
前往Node.js官网下载Node.js（推荐版本>=22）。
-
按照安装向导完成安装，务必使用管理员权限打开终端进行后续操作。
-
验证安装：在终端输入
node -v，看到版本号为v22开头即表示安装成功。
-
-
部署OpenClaw
-
在管理员终端执行以下命令：
iwr -useb https://openclaw.ai/install.ps1 | iex -
耐心等待安装过程，根据安装向导进行操作，选择QuickStart并跳过模型选择步骤。
-
安装完成后，浏览器访问
http://127.0.0.1:18789/， 确认本地服务已启动。
-
-
配置AI模型
-
以Kimi模型为例，注册Moonshot AI开放平台账号并获取API密钥。
-
在终端执行
openclaw onboard --auth-choice moonshot-api-key，输入API密钥。 -
修改
C:\Users\[用户名]\.openclaw\openclaw.json文件中的baseUrl为国内版地址（如https://api.moonshot.cn/v1） 。 -
重启服务后，即可在浏览器中与模型进行对话。
-
三、接入飞书
-
OpenClaw设置
- 在管理员终端执行
openclaw onboard命令，按照图片顺序操作。
- 在管理员终端执行
-
飞书设置
-
注册并登录飞书开放平台，创建企业自建应用。
-
获取app id和secret，在OpenClaw配置中选择websocket并重启服务。
-
在飞书后台配置应用权限和事件回调，确保包含必要的文件读写、消息发送等权限。
-
创建版本并发布应用。
-
-
使用测试
-
在飞书APP中创建群聊，添加群机器人并搜索之前创建的应用。
-
艾特机器人即可发布任务，验证接入是否成功。
-
四、添加Skill技能
安全风险：Skill本质上是可执行代码插件，存在潜在风险，如偷取API Key、注入恶意代码等。因此，宁可少装，也不要乱装。
Skill作用：大模型负责思考和决策，而Skill负责执行具体任务，如搜索、浏览网页、发送邮件等。
推荐Skill：
-
Skill Vetter：安全审查Skill，检查其他Skill的行为，阻止可疑操作。
-
Capability Evolver：允许Agent在使用过程中逐渐优化能力、调整策略。
-
Summarize：快速提取内容核心信息，适合阅读资料和信息整理。
-
Agent Browser：增加Agent的真实世界交互能力，如浏览网页、操作页面。
一键安装推荐Skill：
bash
npx clawhub@latest install skill-vetter
npx clawhub@latest install capability-evolver
npx clawhub@latest install summarize
npx clawhub@latest install agent-browser
五、常见问题及解决方案
-
安装完后无法启动
-
报错信息：Health check failed: gateway closed (1006 abnormal closure)
-
解决方法：使用管理员权限重新安装，并删除用户目录下的
.openclaw文件夹。
-
-
安装插件报错
-
报错信息：Rate limit exceeded
-
解决方法：登录ClawHub账号或等待几分钟后重试。
-
-
Windows安装时报Git错误
-
报错信息：npm error spawn git git not found
-
解决方法：安装Git并加入PATH环境变量。
-
-
Gateway已运行但CLI连接失败
-
报错信息：Runtime: running RPC probe: failed
-
解决方法：检查Gateway状态和WebSocket连接。
-
-
模型调用失败
-
报错信息：All models failed
-
解决方法：检查模型认证配置和API Key是否正确。
-
-
其他常见问题
- 包括端口被占用、控制台断线重连、配置丢失等，可根据具体报错信息参考教程中的解决方案。
通过本文的详细教程，相信大家已经能够顺利在Windows环境下部署OpenClaw、接入飞书机器人、添加推荐Skill并解决常见问题。