1. 项目概述
OpenClaw是一款基于大语言模型的智能助手工具,能够通过自然语言交互完成各种自动化任务。在Windows 11系统中安装配置OpenClaw并与飞书集成,可以实现在移动端通过飞书机器人控制电脑执行操作的功能。本文将详细介绍从安装到配置再到卸载的完整流程,包含大量实际操作中的经验技巧。
作为一名长期使用各类AI工具的技术博主,我发现OpenClaw相比其他同类工具最大的优势在于其强大的扩展性和灵活的配置选项。它支持多种大语言模型接入,可以通过简单的命令行或配置文件进行定制,特别适合需要深度定制的技术用户。
2. 安装OpenClaw
2.1 安装前准备
在Windows 11上安装OpenClaw前,需要确保系统满足以下条件:
- PowerShell执行策略设置为RemoteSigned:
powershell复制Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
这个设置允许执行本地创建的脚本,但会阻止运行从互联网下载的未签名脚本,在安全性和便利性之间取得了平衡。
- 安装Git版本控制工具(如果尚未安装):
powershell复制winget install --id Git.Git -e --source winget
Git是后续安装过程中必需的依赖项,winget是Windows自带的包管理器,比手动下载安装更方便。
注意:如果系统提示"winget不是可识别的命令",说明需要先通过Microsoft Store安装App Installer。
2.2 下载并安装OpenClaw
安装过程通过官方提供的PowerShell脚本完成:
powershell复制iwr -useb https://openclaw.ai/install.ps1 | iex
这个命令会下载并立即执行安装脚本。在实际操作中,我发现以下几点值得注意:
-
安装过程可能需要10-15分钟,具体取决于网络速度。如果长时间卡住,可以尝试使用代理或更换网络环境。
-
安装过程中会提示选择多个配置选项:
- 协议同意:必须选择"Yes"才能继续
- 启动模式:建议选择"QuickStart"快速开始
- 模型配置:初次安装可以先跳过,后续再配置
- 渠道配置:同样可以先跳过飞书配置
-
安装完成后会自动打开Web UI界面,这是OpenClaw的主要操作界面。
-
建议将工具模式设置为full,以获得全部功能:
powershell复制openclaw config set tools.profile full
3. 配置大语言模型
3.1 模型选择与准备
OpenClaw支持多种大语言模型接入方式:
- 第三方API调用:如OpenAI、Anthropic等商业API
- 本地部署模型:如使用vLLM、Ollama等框架本地部署的模型
我选择使用vLLM本地部署Qwen3-32B模型,主要考虑因素包括:
- 数据隐私:本地部署确保数据不外流
- 成本控制:长期使用比API调用更经济
- 定制能力:可以针对特定需求微调模型
3.2 配置文件修改
OpenClaw的配置文件通常位于:
code复制C:\Users\[用户名]\.openclaw\openclaw.json
需要修改的主要是models和agents两个部分:
json复制"models": {
"mode": "merge",
"providers": {
"vllm": {
"baseUrl": "http://localhost:30000/v1",
"apiKey": "EMPTY",
"api": "openai-completions",
"models": [
{
"id": "Qwen3-32B",
"name": "Qwen3-32B",
"reasoning": false,
"input": ["text"],
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "vllm/Qwen3-32B"
}
}
}
关键参数说明:
- baseUrl:vLLM服务地址,默认端口30000
- apiKey:本地部署通常不需要,但必须填写非空值
- contextWindow:模型支持的上下文长度
- maxTokens:单次生成的最大token数
3.3 配置验证
修改完成后,可以通过以下方式验证配置是否生效:
- 重启OpenClaw服务:
powershell复制openclaw gateway restart
-
在Web UI中发送测试消息,观察是否得到合理响应
-
检查日志文件(位于%LOCALAPPDATA%\openclaw-logs)是否有错误信息
4. 飞书集成配置
4.1 创建飞书应用
- 登录飞书开放平台(https://open.feishu.cn/)
- 进入"开发者后台"->"创建企业自建应用"
- 填写应用基本信息后创建应用
4.2 获取凭证信息
在应用"凭证与基础信息"页面可以找到:
- App ID
- App Secret
这两个凭证是OpenClaw与飞书通信的关键,需要妥善保管。
4.3 配置必要权限
飞书应用需要以下核心权限才能正常工作:
json复制{
"scopes": {
"tenant": [
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot"
],
"user": [
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user"
]
}
}
实际配置时,可以使用批量导入功能快速添加这些权限。
4.4 安装飞书插件
OpenClaw通过插件系统支持飞书集成:
powershell复制openclaw plugins install @m1heng-clawd/feishu
如果安装失败,可以尝试手动安装依赖:
powershell复制cd "C:\Users\[用户名]\.openclaw\extensions\feishu"
npm install @larksuiteoapi/node-sdk
4.5 配置飞书凭证
将飞书应用的App ID和App Secret配置到OpenClaw:
powershell复制openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw gateway restart
4.6 事件回调配置
在飞书开发者后台配置以下事件订阅:
- im.message.receive_v1
- im.message.reaction.deleted_v1
- im.message.reaction.created_v1
订阅方式选择"使用长连接接收事件"。
4.7 发布与验证
- 创建并发布应用版本
- 在手机飞书中打开应用
- 首次使用时需要授权配对:
powershell复制openclaw pairing approve feishu [配对码]
- 发送测试消息验证功能是否正常
5. 彻底卸载OpenClaw
5.1 停止并删除计划任务
powershell复制schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
5.2 卸载npm全局包
powershell复制npm uninstall -g openclaw
npm uninstall -g openclaw-cn
5.3 删除相关目录
powershell复制Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\openclaw-logs"
5.4 验证卸载结果
powershell复制openclaw --version
schtasks /Query /TN "OpenClaw*" 2>$null
netstat -ano | findstr :18789
Test-Path "$env:USERPROFILE\.openclaw"
6. 常见问题与解决方案
6.1 安装问题
问题1:PowerShell脚本执行被阻止
- 解决方案:以管理员身份运行PowerShell,执行:
powershell复制Set-ExecutionPolicy RemoteSigned
问题2:安装过程中网络超时
- 解决方案:使用稳定的网络环境,或设置临时代理:
powershell复制$env:HTTP_PROXY="http://127.0.0.1:1080"
$env:HTTPS_PROXY="http://127.0.0.1:1080"
6.2 模型配置问题
问题1:模型响应超时
- 检查vLLM服务是否正常运行
- 确认baseUrl中的IP和端口正确
- 测试从OpenClaw服务器能否访问模型服务
问题2:返回结果质量差
- 检查contextWindow和maxTokens设置是否合适
- 确认模型文件完整且加载正确
- 考虑使用更高性能的模型
6.3 飞书集成问题
问题1:收不到飞书消息
- 检查事件订阅配置是否正确
- 确认OpenClaw服务正常运行
- 查看日志文件排查具体错误
问题2:权限不足错误
- 确认已添加所有必要权限
- 重新发布应用版本
- 检查App ID和App Secret是否正确
7. 性能优化建议
- 模型选择:根据硬件配置选择合适的模型,显存不足时可考虑量化版本
- 批处理设置:在openclaw.json中调整maxConcurrent参数优化并发处理能力
- 日志管理:定期清理日志文件,避免占用过多磁盘空间
- 网络优化:确保OpenClaw服务器与飞书API之间的网络延迟较低
- 缓存利用:合理配置session-memory插件参数,提高对话连续性
我在实际使用中发现,OpenClaw的性能很大程度上取决于所使用的大语言模型。对于中文场景,Qwen系列模型表现优异,而如果主要处理英文内容,可以考虑Llama 3等国际开源模型。硬件配置方面,建议至少16GB内存和8GB显存,才能流畅运行7B以上参数的模型。