Windows部署OpenClaw教程
OpenClaw是一个开源AI助手框架,能够将大模型无缝集成到Telegram、Discord、微信等即时通讯平台,实现持久记忆、跨平台消息传递、工具调用和自动化任务处理。Windows用户可通过原生环境直接部署,无需任何额外虚拟层,性能稳定且操作简洁。硬件要求内存8GB以上,CPU普通级别即可运行,网络建议准备代理工具加速GitHub和npm下载。全程使用PowerShell命令行操作,大约35分钟完成部署。以下是完整步骤,所有命令可直接复制粘贴执行。
第一步安装Node.js环境。打开PowerShell,以管理员身份运行,执行命令winget install OpenJS.NodeJS.LTS -e --source winget。安装完成后关闭并重新打开PowerShell,输入node -v和npm -v检查版本,确保Node为24.x系列。国内用户若下载慢,可提前执行npm config set registry registry.npmmirror.com切换淘宝镜像源加速后续安装。
第二步安装PM2进程管理工具,用于实现后台持久运行。执行npm install -g pm2。安装完毕输入pm2 -v确认版本。
第三步安装OpenClaw本体。直接运行npm install -g openclaw@latest,全局安装最新稳定版,耗时取决于网络,通常2-5分钟。安装完成后输入openclaw -v查看版本号,如果输出版本信息则安装成功。若提示权限错误,可执行sudo npm install -g openclaw@latest重试一次。
安装完成后进入初始化配置。执行openclaw onboard --install-daemon启动交互向导。首先确认安全提示选择Yes,然后选择QuickStart快速启动模式。向导会询问是否安装守护进程相关配置,选择yes以实现后台运行。整个过程使用箭头键选择和回车确认,5分钟内即可完成基础配置。
第四步接入LLM模型。个人推荐使用API(不用自己部署ai),注册并登录账号,进入API Key管理页面,新建一个Key并复制保存。回到PowerShell终端,执行openclaw config进入配置界面。选择Gateway运行位置为Local,选择模型提供商,粘贴刚才的API Key。保存退出后运行openclaw gateway restart重启网关服务。
如需手动精细调整配置,可使用记事本或notepad ~/.openclaw/openclaw.json打开文件。在providers节点下添加以下内容: "AI厂商": { "baseUrl": "open.bigmodel.cn/api/paas/v4", "apiKey": "你的key" },然后将agents.defaults.model.primary的值改为"zai/glm-4.7-flash"。编辑保存后再次执行openclaw gateway restart生效。配置完成后,AI响应通常在1-2秒内完成,中文处理特别流畅。
第五步使用PM2实现后台持久运行与测试。执行pm2 start "openclaw gateway --port 18789 --verbose" --name openclaw-gateway启动网关服务。然后输入pm2 save保存当前进程列表,再执行pm2 startup生成开机自启脚本,按照提示复制并运行该脚本即可实现重启后自动启动。测试消息发送:openclaw message send --to 你的测试账号 --message "测试OpenClaw是否正常"。若已接入Telegram,在Telegram搜索你的bot发送任意消息,AI应立即回复。添加其他平台时执行openclaw configure,根据提示输入Telegram Bot Token或Discord Webhook等信息。
日常操作示例:openclaw agent --message "帮我写一个Python爬虫脚本" 即可让AI直接生成并执行任务;若需更深思考,添加参数--thinking high。支持扩展工具包括浏览器搜索、文件读写、邮件发送等,在配置文件中开启后AI能力大幅提升。
常见问题排查。网络慢时在Windows设置中开启全局代理,或执行set http_proxy=http://你的代理IP:端口。网关启动失败通常是端口占用,换成--port 18888重试,或运行openclaw doctor自动诊断修复。内存不足可关闭其他程序,或在任务管理器中提升Node进程优先级。GitHub下载卡顿时始终使用npm镜像源。所有问题基本可在5分钟内解决。
Windows原生部署完成后,OpenClaw即可作为你的24小时个人AI助手,手机随时发指令,电脑后台自动响应。
服务器部署OpenClaw教程
如果需要在云端服务器实现7x24小时稳定运行,可部署在Linux服务器上,性能更强、资源更充足。以下是纯Linux服务器(以Ubuntu 22.04为例)的完整部署教程,步骤更简洁,约25分钟完成。服务器最低配置1核2GB内存即可,建议2核4GB起步以获得更好响应速度。
第一步准备服务器环境。登录云控制台购买并启动Ubuntu 22.04服务器,获取公网IP和root密码。可选云服务提供商(也可以本地部署)。使用SSH工具(如Xshell或终端)连接服务器:ssh root@你的服务器IP,输入密码登录。登录后先更新系统:sudo apt update && sudo apt upgrade -y。安装必要工具:sudo apt install -y curl wget git。
第二步安装Node.js。OpenClaw同样依赖Node 24版本。执行curl -fsSL deb.nodesource.com/setup_24.x | sudo -E bash -,然后sudo apt install -y nodejs。安装后输入node -v确认版本。建议国内用户先设置镜像:npm config set registry registry.npmmirror.com。
第三步安装OpenClaw。直接运行npm install -g openclaw@latest,全局安装。完成后输入openclaw -v验证版本。
第四步初始化配置。执行openclaw onboard --install-daemon启动向导,选择Yes同意提示,然后QuickStart模式,守护进程选yes。向导结束后服务已自动注册为systemd服务。
第五步接入GLM模型。注册取API Key后,执行openclaw config,选择Local模式,输入提供商和Key。保存后openclaw gateway restart重启。手动配置方法相同:nano ~/.openclaw/openclaw.json添加节点和baseUrl保存重启服务。
第六步设置开机自启与防火墙。由于服务器环境,需确保服务持久运行。openclaw已自动创建systemd服务,执行sudo systemctl enable openclaw-gateway && sudo systemctl start openclaw-gateway。防火墙开放端口:sudo ufw allow 18789/tcp,然后sudo ufw enable。测试启动:openclaw gateway --port 18789 --verbose,后台运行可直接通过systemd管理。
第七步测试与优化。发送测试消息:openclaw message send --to 测试账号 --message "服务器部署测试"。接入Telegram等平台方式与Windows完全相同。服务器优势在于可配置更高并发,编辑配置文件增加max-concurrent-agents参数即可。监控命令:openclaw status查看实时状态,openclaw logs查看日志。常见问题处理:端口冲突用netstat检查,内存不足时升级服务器规格,网络问题可在云后台优化。
服务器部署完成后,OpenClaw可在云端全天候运行,适合团队共享或需要公网访问的场景(不建议个人用服务器)。