OpenClaw部署指南：从云服务器到本地环境的完整搭建教程

一、部署前的准备：理解OpenClaw运行所需的核心组件

在开始搭建OpenClaw之前，需要先梳理清楚它的运行依赖。OpenClaw本质上是一个需要持续在后台运行的服务进程，通常绑定某个固定端口对外提供HTTP或WebSocket接口。因此，部署工作主要围绕三个核心问题展开：

1. 运行环境：操作系统是否具备必要的运行时依赖，如Node.js、Python或容器环境；
2. 网络暴露：服务监听的端口是否能够被目标客户端访问；
3. 鉴权配置：通过API密钥或访问令牌控制谁能调用服务。

无论选择云端服务器还是本地主机，这三项都是部署成功的关键。下面将分别针对不同环境给出具体步骤，并补充安全加固建议。

二、云端服务器部署流程

云端部署适合需要公网访问或团队协作的场景。以下以通用云服务器为例，说明完整流程。

2.1 创建并初始化云服务器实例

选择一台配置不低于2核4GB的云服务器，操作系统建议使用主流的Linux发行版，例如Ubuntu 22.04 LTS或Debian 12。创建实例时，需要注意两点：

• 网络类型：如果希望从公网访问OpenClaw，需要分配公网IP地址；
• 安全组初始规则：默认通常只开放22端口用于SSH登录，后续需要手动添加OpenClaw的监听端口。

实例创建完成后，通过SSH登录服务器，先更新系统软件包：

sudo apt update && sudo apt upgrade -y

2.2 安装OpenClaw及其运行时

根据你获取的OpenClaw安装包格式，选择对应的安装方式。常见的安装路径包括：

• 使用官方脚本一键安装：curl -fsSL <安装脚本地址> | bash
• 下载预编译二进制文件后解压到/usr/local/bin；
• 通过容器镜像部署，适用于希望隔离环境的场景。

无论采用哪种方式，安装完成后都应验证可执行文件是否可用：

openclaw --version

如果命令正常返回版本号，说明安装成功。

2.3 放行服务端口

OpenClaw默认监听的端口可能因版本不同而有所差异，常见的是18789端口。在云服务器控制台的防火墙或安全组设置中，需要为该端口添加入站规则。

操作要点：

• 协议选择TCP；
• 源地址可根据需要设为0.0.0.0/0（允许所有来源）或指定IP段；
• 如果云平台提供“一键放通”功能，可以直接使用，但仍建议确认规则生效范围。

在服务器本机也可以检查端口监听状态：

sudo ss -tlnp | grep 18789

如果没有任何输出，说明OpenClaw尚未成功启动或监听在其他端口。

2.4 配置大模型API密钥

OpenClaw的核心能力依赖大模型推理接口，因此需要为其配置有效的API密钥。在云服务商的大模型控制台中创建API-Key后，将其安全地写入OpenClaw的配置文件中。

推荐做法是使用环境变量或独立配置文件，而非直接硬编码在启动命令中：

export LLM_API_KEY="你的密钥内容"

之后启动OpenClaw时，服务会读取该环境变量。部分云平台提供了“一键配置”功能，可以自动将密钥注入实例环境，但手动配置更透明、可控。

2.5 生成访问令牌并启动服务

完成密钥配置后，执行OpenClaw的初始化命令，生成用于客户端访问的Token：

openclaw init --generate-token

命令执行后会输出一串Token，请妥善保存。该Token用于后续API调用或Web控制台登录时的身份验证。

最后启动服务：

nohup openclaw serve --host 0.0.0.0 --port 18789 > /var/log/openclaw.log 2>&1 &

建议使用systemd管理服务进程，以实现开机自启和异常退出后自动拉起。以下是一个简单的systemd单元文件示例：

[Unit]
Description=OpenClaw Service
After=network.target
[Service]
Type=simple
User=ubuntu
Environment=LLM_API_KEY=你的密钥内容
ExecStart=/usr/local/bin/openclaw serve --host 0.0.0.0 --port 18789
Restart=on-failure
[Install]
WantedBy=multi-user.target

将该文件保存为/etc/systemd/system/openclaw.service，然后执行：

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

三、macOS本机部署

macOS部署适合本地开发和测试场景。由于macOS自带Unix环境，安装过程与Linux类似，但需要注意文件权限和防火墙设置。

3.1 安装依赖与OpenClaw

如果使用Homebrew，可以通过以下方式安装：

brew install openclaw

也可以下载macOS专用的安装包手动安装。安装完成后，在终端中验证：

openclaw --version

3.2 配置密钥与生成令牌

macOS环境下建议将API密钥写入~/.openclaw/config.yaml或通过环境变量注入：

echo 'export LLM_API_KEY="你的密钥内容"' >> ~/.zshrc
source ~/.zshrc

然后初始化并生成Token：

openclaw init --generate-token

3.3 启动与防火墙设置

macOS的防火墙默认不拦截本地回环地址的访问，因此如果只在本机使用，无需额外放行。如果需要局域网内其他设备访问，则需在“系统设置—网络—防火墙”中允许OpenClaw接受传入连接。

启动服务：

openclaw serve --host 0.0.0.0 --port 18789

四、Linux本机部署

Linux桌面或服务器环境的部署流程与云端服务器基本一致，区别在于不需要配置云安全组，但需要管理本机防火墙。

以ufw为例：

sudo ufw allow 18789/tcp
sudo ufw enable

其余安装、配置、生成Token的步骤与云端部署相同，此处不再重复。

五、Windows本机部署

Windows环境下的部署相对特殊，主要体现在路径格式、环境变量设置和终端命令差异上。

5.1 安装OpenClaw

下载Windows版本的安装程序，双击运行并按照提示完成安装。安装完成后，打开PowerShell验证：

openclaw --version

5.2 配置环境变量

在PowerShell中临时设置：

$env:LLM_API_KEY = "你的密钥内容"

永久设置可以通过“系统属性—环境变量”界面添加，或使用以下命令：

[System.Environment]::SetEnvironmentVariable('LLM_API_KEY', '你的密钥内容', 'User')

5.3 生成Token并启动

openclaw init --generate-token
openclaw serve --host 0.0.0.0 --port 18789

5.4 防火墙放行

Windows Defender防火墙需要添加入站规则：

1. 打开“高级安全Windows Defender防火墙”；
2. 选择“入站规则—新建规则”；
3. 选择“端口”，协议TCP，端口18789；
4. 允许连接，完成创建。

六、常见问题排查

6.1 端口无法访问

排查顺序：

• 确认OpenClaw已启动且监听目标端口：ss -tlnp | grep 18789（Linux）或netstat -ano | findstr 18789（Windows）；
• 确认云安全组或本机防火墙已放行；
• 确认服务启动时--host参数为0.0.0.0而非127.0.0.1。

6.2 密钥认证失败

检查环境变量是否真正生效：echo $LLM_API_KEY（Linux/macOS）或echo $env:LLM_API_KEY（PowerShell）。部分OpenClaw版本会缓存首次读取的配置，修改后需要重启服务。

6.3 Token生成后无法登录

确认Token没有包含多余空格或换行符。在复制粘贴过程中，终端有时会引入不可见字符。建议将Token保存到密码管理器中，使用时通过环境变量传递。

七、安全最佳实践

1. 最小权限原则：API密钥仅授予必要的模型调用权限，定期轮换；
2. 访问控制：如果服务必须暴露在公网，建议使用反向代理并启用HTTPS；
3. 日志监控：定期检查OpenClaw访问日志，发现异常请求及时处理；
4. 更新策略：关注安全公告，及时升级到修复漏洞的版本。

通过以上步骤，你应该能够在云端或本地环境中顺利完成OpenClaw的部署。关键节点在于端口放行、密钥注入和Token生成，任何一环遗漏都会导致服务无法正常使用。建议严格按照顺序操作，并在每步之后进行验证，以降低排障成本。