OpenClaw 避坑指南：手把手教你从零搭建专属 AI 智能体

部署 OpenClaw 频频爆内存？2核2G服务器完全带不动？这篇硬核避坑指南带你绕过所有坑！使用 几十元一年的轻量应用服务器，从零搭建专属 AI Agent。详细手把手教程，从密钥绑定到 Web UI 配置，新手也能稳稳上手，激活 AI 智能体大脑！

关注同名公众号获取最新技术资讯！

前言：为什么你的服务器部署总是失败？

在开始之前，先聊聊背景。市面上的云服务器主要分为云服务器（CVM/ECS）和轻量应用服务器。

我最初尝试在现有的 2核2G CVM 上部署，结果惨遭“滑铁卢”：实际运行和安装时极易爆内存导致进程崩溃。为了让大家少走弯路，本文将选择轻量应用服务器进行实战演示。文中包含详尽的安装教程、参考文档及踩坑总结，非常适合新手。

❝

注： 本文仅涉及 OpenClaw 的基础部署，后续会分享更多进阶玩法。

---

第一章：为 OpenClaw 选择“生存小屋”

为什么我们极力推荐 “轻量应用服务器” 而非普通云服务器？

1. 核心优势对比

维度	普通云服务器 (CVM)	轻量应用服务器
带宽体验	1Mbps (下载约 100KB/s)	30Mbps+ (下载约 3MB/s+)
安装速度	npm 下载包可能需 30 分钟	几分钟搞定，体验天壤之别
流量成本	按量计费或固定小带宽，成本高	每月自带几百 GB 流量，物美价廉

2. 选购建议

我们最终选择了 4核4G 3M带宽 的轻量服务器，一年仅需 79元。对比某些预装好的商业镜像，自己动手部署不仅能掌握核心技术，成本也极低。

• 系统镜像： 推荐选择 Ubuntu 24.04 LTS（保持系统纯净，手动拉取最新版）。

• 登录方式： 购买后在控制台通过 SSH 登录。推荐使用 FinalShell 或网页端一键免密登录。

---

第二章：OpenClaw 环境搭建

1. 安装或更新 Node.js (需 v22.0+)

OpenClaw 依赖较新版本的运行环境。如果你的 Node 版本过低，请参考第六章的 NVM 安装法。

# 检查当前版本

node -v

2. 执行一键安装脚本

根据你的操作系统选择对应命令：

• macOS / Linux:

  curl -fsSL https://openclaw.ai/install.sh | bash
  

• Windows (PowerShell 管理员模式):

  iwr -useb https://openclaw.ai/install.ps1 | iex
  

3. 初始化引导配置（Onboarding）

安装完成后，会自动进入交互式配置界面。

建议参考以下选择：

• I understand this is powerful…: 选择 Yes

• Onboarding mode: 选择 QuickStart

• Model/auth provider: 选择 Skip for now (后续手动配)

• Filter models: 选择 All providers

• Configure skills?: 选择 No

• How do you want to hatch your bot?: 选择 Hatch in TUI

当看到 “Wake up, my friend!” 时，说明核心程序已就绪！

❝

⚠️ 警告： 此时若提示 No API key found 是正常的，它现在只是个“没有大脑”的躯壳，我们马上为它接入核心。

---

第三章：配置大模型 API (以通义千问为例)

我们使用引导命令重新配置 API Key。如果你有 Coding Plan 订阅，请注意选项区别。

执行命令：

openclaw onboard --install-daemon

关键配置步骤演示：

1. Provider: 选择 Qwen (Alibaba Cloud Model Studio)

2. Auth Method: 选择 Standard API Key for China (如果你是 Coding Plan 订阅用户，请选择第一项 Coding Plan API Key for China)

3. Enter API Key: 输入你的 Key（例如：sk-xxxxxx...）

4. Default Model: 建议设为 qwen3.5-plus 或 qwen3-coder-plus

设置完成后，OpenClaw 正式拥有了“大脑”。

---

第四章：开启 Web UI 远程交互

相比 SSH 终端，网页版（Web UI）操作更直观。我们需要完成以下三步配置：

1. 云服务器安全组配置

在云服务器控制台，放行以下端口：

• 18789 (OpenClaw 默认端口)

• 80 / 443 (基础 Web 端口)

2. 修改 OpenClaw 配置文件

编辑配置文件，允许公网 IP 访问：

nano ~/.openclaw/openclaw.json

找到 gateway 部分，修改如下：

保存并重启网关：

openclaw gateway restart

3. 浏览器安全设置 (Chrome 必备)

由于 OpenClaw 默认使用 HTTP，Chrome 可能会拦截部分功能。

1. 在地址栏输入：chrome://flags/#unsafely-treat-insecure-origin-as-secure

2. 找到 Insecure origins treated as secure。

3. 添加：http://<你的服务器公网IP>:18789

4. 改为 Enabled 并重启浏览器。

---

第五章：开始对话！

现在，在终端运行：

openclaw dashboard

在浏览器输入 http://<你的服务器公网IP>:18789 即可开启交互界面。

常用内置命令速查

命令	说明	示例
/status	查看当前模型、网关状态	/status
/model	快速切换模型	/model qwen3.5-plus
/think	设置推理深度 (off/low/high)	/think high
/skills	列出当前加载的技能	/skills

---

第六章：问题总结与处理 (FAQ)

Q1：如何通过 FinalShell 使用 SSH 密钥安全登录？

相比容易被暴力破解的密码登录，推荐使用 SSH 密钥对。以下是全流程：

1. 生成密钥： 登录你的云服务器控制台（以阿里云/腾讯云为例），在左侧菜单找到“密钥对”，点击“创建密钥对”。

2. 绑定服务器： 创建成功后，将该密钥对“绑定”到你购买的轻量应用服务器上。注意： 绑定密钥通常需要重启服务器才能生效。

3. 下载私钥： 密钥创建时，浏览器会自动下载一个后缀为 .pem（或 .qkey）的文件。请妥善保管，它只会出现这一次。

4. FinalShell 配置：

• 打开 FinalShell，点击左上角“连接管理器”图标 -> “SSH 连接”。

• 名称： 随便起（如：OpenClaw-Server）。

• 主机： 输入你的服务器公网 IP。

• 认证方式： 选择 “公钥” (Public Key)。

• 用户名： Ubuntu 系统通常填 ubuntu 或 root。

• 私钥： 点击“选择”，导入你刚才下载的 .pem 文件。

6. 点击连接： 成功后，你就能看到熟悉的终端界面了。

---

Q2：Node.js 版本太低或安装失败？

推荐使用 NVM (Node Version Manager) 来管理，避免系统权限冲突：

# 1. 安装 NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

source
 ~/.bashrc


# 2. 安装 Node v22 (OpenClaw 要求 v22+)

nvm install 22

node -v 
# 确认显示 v22.x.x

---

Q3：OpenClaw 网关配置修改（必看）

如果你想通过本地浏览器访问服务器上的 OpenClaw，必须修改 openclaw.json。

nano ~/.openclaw/openclaw.json

修改重点：

• 将 "bind": "127.0.0.1" 改为 "bind": "lan" (注意不要修改为 0.0.0.0，会报错)。

• 在 allowedOrigins 中加入你的 公网 IP 访问地址。

修改后的示例：

修改完成后，Ctrl + O 保存，Enter 确定，Ctrl + X 退出，最后重启网关：openclaw gateway restart。

---

Q4：访问报错 “Pairing required”？

这是 OpenClaw 的安全保护机制，防止陌生人连接。

1. 在服务器终端执行：openclaw device approve。

2. 你会看到一个等待批准的请求，输入 y 并回车。

3. 回到浏览器刷新页面，即可进入 Dashboard。

---

Q5：关键安全提示：一定要开启密码保护！

当服务器暴露在公网后，你的 API Key 就是金钱。

1. 不要关闭 Token 验证：确保配置文件里的 "auth": { "mode": "token" } 是开启的。

2. 定期更换 Token：

   openclaw doctor --generate-gateway-token
   

   执行后会生成一串复杂的字符串，将其填回配置文件中的 gateway.auth.token 字段。

---

安装教程参考：https://help.aliyun.com/zh/model-studio/openclaw-coding-plan?spm=a2c4g.11186623.0.0.38e4689dCrdaNr#aa0c9f2cd04s0

感谢阅读！如果你在部署过程中遇到其他问题，欢迎在后台留言讨论。下一期我们将带来 OpenClaw 的进阶技能 (Skills) 配置教程，让它真正能帮你写代码、改 Bug！

如果这篇文章对你有帮助，欢迎点赞、在看、转发，也欢迎在评论区分享你的OpenClaw安装问题或者分享经验。