1. OpenClaw本地部署前的准备工作
在开始安装OpenClaw之前,我们需要做好以下准备工作。作为一个长期从事AI工具部署的技术人员,我强烈建议不要跳过这个环节,否则可能会在后续安装过程中遇到各种奇怪的问题。
1.1 系统环境检查
首先确认你的Windows系统版本。OpenClaw需要Windows 10版本2004及更高版本(Build 19041及以上)或Windows 11。可以通过Win+R运行winver命令查看具体版本号。我遇到过不少案例,用户因为系统版本过低导致WSL无法正常运行。
重要提示:如果你的系统版本低于要求,建议先进行系统升级。我曾尝试在旧版本上强行安装,结果出现了各种依赖问题,最终花费的时间比直接升级系统还要多。
1.2 启用WSL功能
OpenClaw需要通过Windows Subsystem for Linux(WSL)运行。在管理员权限的PowerShell中执行以下命令:
powershell复制dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
执行完成后需要重启系统。这里有个小技巧:重启后建议再次打开PowerShell,运行wsl --set-default-version 2将WSL2设为默认版本。我在早期部署时忽略了这一步,结果安装的WSL1性能明显较差。
1.3 安装Linux发行版
微软商店提供了多个Linux发行版,对于OpenClaw我推荐使用Ubuntu 20.04 LTS。安装完成后,首次启动会要求创建用户名和密码。这里要特别注意:
- 用户名建议全小写且不带特殊字符
- 密码要记住,后续sudo操作需要频繁使用
- 这个账户将成为OpenClaw服务的运行账户
2. OpenClaw核心安装流程
2.1 获取安装脚本
打开PowerShell(管理员)并输入wsl进入Linux环境。不要直接在Windows的PowerShell中运行安装命令,这会导致权限问题。我见过不少用户因此导致安装失败。
官方提供的安装命令是:
bash复制curl -fsSL https://openclaw.ai/install.sh | bash
这个命令有几个关键点需要注意:
- curl的-fsSL参数组合:
- -f:静默失败
- -s:静默模式
- -S:显示错误
- -L:跟随重定向
- 管道直接传递给bash执行,这是一种常见的安装方式
安全提示:在运行任何从网络下载的脚本前,建议先检查其内容。可以先用
curl -fsSL https://openclaw.ai/install.sh -o install.sh下载脚本,检查无误后再bash install.sh执行。
2.2 安全确认环节
安装过程中会遇到一个重要提示:
code复制I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
[Yes/No]
这个安全警告非常重要,它意味着:
- 默认配置仅适合个人开发使用
- 如果要在团队或多用户环境中使用,必须进行额外的安全加固
- 不要将默认配置的服务暴露在公网
根据我的经验,个人开发选择Yes即可,但如果是在公司内网使用,建议先阅读官方安全文档进行加固。
2.3 安装模式选择
接下来会提示选择安装模式:
- QuickStart(快速启动)
- Manual(手动配置)
对于大多数用户,我推荐选择QuickStart。手动配置适合有特殊需求的场景,比如:
- 需要自定义安装路径
- 要使用特定版本的依赖项
- 需要调整默认资源配置
我曾经为一个客户做过手动配置,因为他们的服务器资源有限,需要调整内存分配。但对个人用户来说,快速启动是最省心的选择。
3. 模型选择与配置
3.1 国内模型推荐
OpenClaw支持多种大语言模型,考虑到国内用户的网络环境,我强烈建议选择Qwen(通义千问)系列模型。原因如下:
- 服务器位于国内,访问速度快
- 中文理解能力强
- API稳定性较好
- 注册流程简单
相比之下,一些国外模型如GPT系列经常遇到连接超时的问题,特别是在晚高峰时段。
3.2 Qwen账号授权流程
选择Qwen模型后,系统会提供一个授权链接。这个过程有几个关键点:
- 需要在浏览器中打开链接
- 使用阿里云账号登录(如果没有需要先注册)
- 同意API访问权限
- 获取并保存API密钥
我建议在这个过程中:
- 使用Chrome或Edge浏览器
- 确保网络连接稳定
- 记录下API密钥以备后用
3.3 模型版本选择
Qwen提供了多个模型版本,对于大多数场景,选择默认的第一个选项(通常是qwen-max)即可。这个版本:
- 综合能力强
- 响应速度快
- 性价比高
如果是特定领域的专业需求,可以考虑其他专用版本。我曾经测试过各个版本,qwen-max在大多数基准测试中表现最为均衡。
4. 可选配置项处理
4.1 应用模板选择
安装过程中会提示选择预置应用模板,建议选择"跳过"。原因是:
- 这些模板可以在安装后随时添加
- 初始安装保持简洁更易维护
- 避免不必要的资源占用
我见过一些用户一开始安装了所有模板,结果发现大部分都用不上,反而增加了系统负担。
4.2 搜索提供商配置
这个选项是为AI工具添加联网搜索能力,同样建议选择"跳过"。因为:
- 需要额外的API密钥
- 可能产生额外费用
- 基础功能通常不需要联网搜索
如果需要,可以在使用过程中随时添加。我的经验是先体验核心功能,再根据需要逐步扩展。
4.3 Hooks配置
Hooks是执行Agent命令时自动触发的脚本,初学者完全可以跳过。等熟悉了基本操作后,再研究Hooks的高级用法会更有效率。
5. 界面选择与安装完成
5.1 可视化界面选项
OpenClaw提供两种界面:
- Web UI:基于浏览器的图形界面
- CLI:命令行界面
我强烈推荐选择Web UI,因为:
- 操作直观
- 功能展示全面
- 适合大多数用户
CLI更适合自动化脚本和高级用户。记得去年我给一个客户部署时,他坚持要用CLI,结果培训成本高了很多。
5.2 安装完成验证
安装完成后,系统会显示访问地址,通常是http://localhost:8000。在浏览器中打开这个地址,你应该能看到OpenClaw的登录界面。
如果无法访问,可以检查:
- 服务是否正常运行:
sudo systemctl status openclaw - 端口是否被占用
- 防火墙设置
我建议首次登录后:
- 修改默认密码
- 查看系统状态
- 测试基本功能
6. 常见问题与解决方案
6.1 安装失败排查
如果安装过程中出现错误,可以尝试以下步骤:
- 检查网络连接:
bash复制ping openclaw.ai
curl -v https://openclaw.ai/install.sh
- 查看安装日志:
bash复制cat /var/log/openclaw_install.log
- 清理后重试:
bash复制sudo rm -rf /opt/openclaw
sudo apt purge openclaw
6.2 性能优化建议
根据我的部署经验,OpenClaw运行一段时间后可能会变慢,可以尝试:
- 增加WSL内存限制:
在Windows用户目录下创建或修改.wslconfig文件:
code复制[wsl2]
memory=4GB
swap=2GB
- 定期清理缓存:
bash复制sudo openclaw-cli cache --clean
- 禁用不必要的插件
6.3 安全加固措施
即使是个人使用,也建议做基本安全加固:
- 修改默认端口:
bash复制sudo openclaw-cli config set port 8080
- 启用基础认证:
bash复制sudo openclaw-cli security --enable-basic-auth
- 定期更新:
bash复制sudo openclaw-cli update
7. 进阶配置技巧
7.1 多模型切换配置
OpenClaw支持同时配置多个模型,可以在~/.openclaw/models.yaml中添加:
yaml复制models:
- name: qwen-max
type: qwen
api_key: your_api_key
- name: qwen-turbo
type: qwen
api_key: your_api_key
使用时通过/use qwen-turbo切换。我发现这个功能在对比不同模型表现时特别有用。
7.2 自定义插件开发
OpenClaw允许开发自定义插件,基本结构如下:
code复制my_plugin/
├── __init__.py
├── manifest.yaml
└── main.py
开发完成后,通过以下命令安装:
bash复制sudo openclaw-cli plugin install ./my_plugin
我曾经为客户开发过一个行业术语翻译插件,大大提升了他们的工作效率。
7.3 备份与迁移
定期备份配置很重要:
bash复制sudo openclaw-cli backup --output ~/openclaw_backup.tar.gz
迁移到新机器时:
bash复制sudo openclaw-cli restore --input ~/openclaw_backup.tar.gz
这个功能在我升级服务器时帮了大忙,所有配置和插件都能完整迁移。
