OpenClaw搭建实录：一台电脑就能拥有的AI中台

qq_315375761

18人浏览 · 2026-06-20 10:51:38

qq_315375761 · 2026-06-20 10:51:38 发布

前阵子有朋友问我，有没有什么方案能在家里一台电脑上搭建一个私有化的AI中台，把各种AI能力统一管理起来。说实话，市面上能做的方案不少，但真正让我觉得"行，这个我可以推荐给别人"的，OpenClaw是其中一个。今天就把我在Windows机器上搭建OpenClaw的整个过程记录下来，踩过的坑也一并说清楚，方便大家参考。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

先说一下我的硬件环境：一台普通的Windows 10电脑，16GB内存，i7处理器，没有独立显卡。这配置不算好，但跑OpenClaw完全够用，因为它本身只是一个调度框架，真正吃资源的AI推理是在云端API完成的。如果你有大模型本地部署的需求，那硬件要求就另说了，但那不是今天的重点。

安装之前需要确认几个前置条件。首先你的电脑得联网，因为OpenClaw需要调用各种在线API。其次建议把Windows更新到最新版本，有些PowerShell命令在旧版本上有兼容问题。最后就是需要一个支持HTTPS的API Key，不管是OpenAI的还是国内的模型服务都行，OpenClaw对模型提供商是解耦的。

检查系统环境是否满足要求

1. 查看PowerShell版本（需要5.1以上）

$PSVersionTable.PSVersion

2. 查看内存大小

Get-CimInstance Win32_ComputerSystem | Select-Object TotalPhysicalMemory

3. 检查网络连通性

Test-NetConnection -ComputerName api.openai.com -Port 443

4. 查看磁盘空间

Get-PSDrive C | Select-Object Used,Free

这四条命令跑完，基本就能确认你的机器能不能跑OpenClaw了。PowerShell版本太低的话需要升级，一般来说Windows 10自带的都够用。网络连通性这里，如果你用的是国内模型API，换成对应的地址测就行。磁盘空间至少预留2GB给OpenClaw本身和缓存数据。

准备工作做完就可以开始安装了。推荐直接用一键部署包，省去了手动配置环境的麻烦。下载好之后解压到一个你喜欢的目录，注意路径里不要有中文，否则可能会出幺蛾子。我自己的习惯是放在D盘根目录下，简单粗暴。

解压并进入安装目录

Expand-Archive -Path “D:\Downloads\openclaw-setup.zip” -DestinationPath “D:\openclaw”
cd D:\openclaw

运行安装脚本

.\install.ps1

安装完成后检查服务状态

openclaw gateway status

安装脚本会自动帮你配置好Node.js运行时、安装依赖包、创建必要的数据目录。整个过程大概两三分钟，中间不需要你做任何操作。安装完之后用status命令确认一下Gateway服务是否正常启动，如果显示running就说明没问题了。

服务跑起来之后，下一步就是配置你的API Key。OpenClaw的配置文件是YAML格式，放在conf目录下。你需要把你的模型API Key填进去，同时指定默认使用的模型。如果你有多个API Key，比如一个OpenAI的一个国内的，也可以都配上，然后在不同的Agent里指定不同的模型。

conf/config.yaml 的关键配置项

server:
host: 0.0.0.0
port: 8080

models:
default: gpt-4o
providers:
openai:
api_key: sk-your-key-here
base_url: https://api.openai.com/v1
zhipu:
api_key: your-zhipu-key
base_url: https://open.bigmodel.cn/api/paas/v4

gateway:
enabled: true
max_concurrent: 5
timeout: 120

配置文件写好之后，重启一下Gateway服务让配置生效。到这里，OpenClaw的基本搭建就完成了。你现在可以通过浏览器访问localhost:8080来打开管理界面，或者通过命令行工具来操作。

重启Gateway服务

openclaw gateway restart

验证配置是否生效

openclaw config show

测试模型连通性

openclaw model test --provider openai

创建第一个Agent

openclaw agent create --name my-first-agent
–model gpt-4o
–prompt “你是一个通用助手，帮助用户回答各种问题。”

test命令会发一个简单的请求给模型API，确认你的Key是有效的。如果这里报错了，先检查API Key是否正确、网络是否通畅、余额是否充足。创建Agent的时候，–model参数可以换成你配置的任何模型，不一定要用gpt-4o，选一个你觉得性价比高的就行。

Agent创建好了，接下来就可以跟它交互了。OpenClaw支持好几种交互方式，命令行、Web界面、甚至可以通过API对接到你自己的应用里。对于日常使用来说，命令行和Web界面是最方便的。

命令行跟Agent对话

openclaw chat --agent my-first-agent “你好，介绍一下你自己”

查看Agent的历史对话

openclaw chat --agent my-first-agent --history

给Agent安装一个技能

skillhub_install install_skill web-search

在Web界面中使用

浏览器打开 http://localhost:8080

技能（Skill）是OpenClaw的一个核心概念，可以理解为给Agent安装"插件"。每个技能都封装了特定领域的能力，比如网页搜索、邮件处理、文件操作等。安装技能之后，Agent在对话中就能自动调用这些能力了。这个生态做得挺完善，常用的功能基本都有现成的技能可以直接装。

搭建过程中我遇到过几个坑，这里跟大家分享一下。第一个是端口冲突，如果8080端口被别的程序占了，在配置文件里改成其他端口就行。第二个是Node.js版本问题，OpenClaw要求Node 18以上，如果系统自带的是旧版本，安装脚本会自动帮你处理，但如果处理失败了，你需要手动升级。第三个是Windows防火墙，安装完之后如果局域网其他设备访问不了，需要放行对应的端口。