声明：本文所有操作均为原创实测，代码块均可在生产环境或个人服务器直接复制运行，不搞模糊概念，只讲干货。

引言：OpenClaw 是什么？为什么现在全网都在聊它？

如果你还以为 AI 智能体只是网页版里的 ChatGPT，那你就 Out 了。

OpenClaw（曾用名 Clawdbot / Moltbot）是目前 GitHub 上最火爆的开源 AI 自动化框架，短短几周内狂揽超 18 万颗星 。它的核心定位不是聊天框，而是一个 “数字员工” 。你可以把它部署在服务器或你的电脑上，它就能直接操作你的文件系统、执行 Shell 命令、浏览器自动化，甚至通过微信、飞书、钉钉与你交互 。

简单来说，OpenClaw = 大模型 + 双手 + 眼睛。它不仅能“思考”，还能“干活”。

本文将从零开始，带你分别使用 阿里云服务器（云端部署） 和 Windows/Mac（本地部署） 两种方案，手把手搭建属于你自己的 OpenClaw 服务，并配置免费的国产大模型 API。

---

第一部分：部署前的核心准备

不管你是用云服务器还是自己的电脑，OpenClaw 对硬件和依赖有硬性要求，请务必核对：

• 操作系统：Windows 10/11、macOS 12+、Ubuntu 20.04+。

• 运行环境：Node.js 必须为 22.x 或更高版本（重中之重）。

• 硬件规格：内存不低于 2GB（推荐 4GB），硬盘可用空间大于 5GB 。

• 网络访问：服务器或本地网络需能顺畅访问外网（用于下载依赖和调用 API）。

---

第二部分：方案一 阿里云一键部署（新手推荐，7x24h 在线）

如果你不想让助手断网，希望它在云端全天候运行，阿里云轻量应用服务器是最佳选择。

1. 购买服务器（镜像选择是关键）

登录阿里云控制台，购买轻量应用服务器：

• 镜像：不要选公共镜像，直接在应用镜像里搜索并选择 OpenClaw (Moltbot) 2026.4.5 官方版（该镜像预装了 Node.js 22 和 Git，省去大量折腾时间）。

• 地域：推荐选择 美国（弗吉尼亚） 或 中国香港。实测国内地域（除香港外）的轻量服务器由于网络限制，会导致联网搜索功能受限 。

• 配置：2核2G内存起步，带宽按量付费或选择 3-5Mbps 固定带宽。

• 购买后：记下服务器的公网 IP 和 root 密码。

2. 放通防火墙（必做，否则无法访问）

在实例详情页，点击 防火墙 标签页，添加一条规则：

• 协议：TCP

• 端口范围：18789 （这是 OpenClaw 网关的核心端口）

• 授权对象：0.0.0.0/0 （允许所有 IP 访问，方便测试）

3. SSH 连接与初始化

使用 FinalShell 或 Xshell 连接你的服务器：

# 1. 进入 OpenClaw 安装目录（官方镜像默认路径）
cd /opt/openclaw

# 2. 切换国内 npm 镜像源（解决国内服务器下载慢的问题）
npm config set registry https://registry.npmmirror.com/

# 3. 非交互式初始化，一键配置环境
openclaw init --non-interactive --accept-risk --enable-skill-market

# 4. 后台启动 Gateway 守护进程
openclaw gateway start --daemon

# 5. 生成管理员 Token（这个 Token 一定要保存下来！）
openclaw token generate --admin --allow-ip 0.0.0.0/0

执行完第 5 步，终端会输出一串很长的字符，例如 eyJhbGciOiJIUzI1... ，请务必完整复制保存，这就是你登录后台的钥匙。

4. 验证部署

打开浏览器，访问 http://你的服务器公网IP:18789?token=刚才生成的Token 。如果能成功打开 Web 管理界面，说明云端部署大功告成！

---

第三部分：方案二 本地电脑部署（Mac / Win / Linux）

如果你更注重隐私，或者只是想本地测试，可以使用官方一键安装脚本，非常方便 。

1. Windows 11 部署（管理员模式）

1. 以 管理员身份 打开 PowerShell。

2. 执行一键安装命令：

   # 解锁执行权限
   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
   
   # 官方一键安装脚本
   iwr -useb https://openclaw.ai/install.ps1 | iex

3. 安装脚本会自动检测并安装 Node.js，耐心等待即可。

2. macOS / Linux 部署

打开终端，执行：

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

3. 运行 Onboarding 向导

安装完成后，无论是 Win 还是 Mac，都需要进行初始化配置：

# 启动配置向导（推荐带上 --install-daemon 安装开机自启服务）
openclaw onboard --install-daemon

向导选项建议：

• Understand risk? 选择 Yes。

• Onboarding mode：选择 QuickStart。

• Model provider：如果你暂时没有 Claude/OpenAI 的 Key，可以选择 Skip for now（我们稍后手动配置免费的国产 API）。

• Channels & Skills：新手建议先选 Skip，先跑通再慢慢研究。

配置完成后，访问 http：//localhost：18789 即可看到本地 Web 界面。

---

第四部分：配置模型核心（接入阿里云百炼 / 免费 API）

OpenClaw 本身没有脑子，它需要接入大模型 API 才能对话和思考。这里以阿里云百炼平台为例（国内访问快，新用户通常有免费额度）。

1. 获取 API Key

1. 访问阿里云百炼控制台，点击「模型广场」->「API-KEY 管理」。

2. 点击「创建 API-KEY」，复制生成的密钥（SK- 开头）。

2. 配置到 OpenClaw

OpenClaw 的配置文件在 ~/.openclaw/openclaw.json （Windows 路径通常在 C：\Users\你的用户名\.openclaw\）。

我们可以通过命令行直接写入环境变量和配置，比手改 JSON 更稳：

# 1. 配置环境变量（临时生效，建议直接写入 bashrc/zshrc 或 .env 文件）
export DASHSCOPE_API_KEY="sk-这里填写你复制的一长串Key"

# 2. 设置模型提供商（使用 DashScope 兼容模式）
openclaw config set models.providers.bailian.baseUrl https：//dashscope.aliyuncs.com/compatible-mode/v1
openclaw config set models.providers.bailian.apiKey ${DASHSCOPE_API_KEY}
openclaw config set models.providers.bailian.api openai-completions

# 3. 设置默认模型（推荐 qwen-plus，性价比高，qwen-max 智商更高）
openclaw config set agents.defaults.model.primary bailian/qwen-plus

# 4. 重启网关使配置生效
openclaw gateway restart

第五部分：进阶玩法 Skill 技能扩展

OpenClaw 最强的就是它的 Skill（技能） 系统。安装后，你可以直接对 AI 说：“帮我把桌面上的图片压缩一下”或者“分析一下这个日志文件”。

1. 安装 ClawHub 客户端（推荐）

ClawHub 是 OpenClaw 的公共技能市场，提供了海量现成插件 。

npm install -g clawhub-cli

2. 搜索并安装实用技能

# 查看所有可安装的技能
openclaw skills list

# 安装网页搜索技能（让 AI 具备联网能力）
openclaw skill install web-search

# 安装代码解释器（让 AI 能在本地运行代码）
openclaw skill install code-interpreter

# 启用特定技能
openclaw skills enable web-search

3. 接入钉钉 / 飞书（让全公司用上 AI）

OpenClaw 官方支持 Channels 概念。以钉钉为例：

1. 在钉钉开发者后台创建机器人，获取 Client ID 和 Client Secret 。

2. 在 OpenClaw 配置文件中追加：

   {
     "channels": {
       "dingtalk": {
         "enabled": true,
         "clientId": "你的钉钉AppKey",
         "clientSecret": "你的钉钉AppSecret"
       }
     }
   }

3. 重启服务后，你就可以在钉钉群里 @ 机器人 让它干活了。

第六部分：避坑指南 & 常见问题

1. Command Not Found：

   • 现象：明明安装了，却提示 openclaw： command not found。

   • 解决：这是因为全局 Node 模块没有加入环境变量。执行 export PATH=“$(npm prefix -g)/bin：$PATH” 。

2. 国内服务器无法联网搜索：

   • 原因：阿里云内地节点的轻量服务器网络策略限制。

   • 解决：请务必选择 美国（弗吉尼亚） 或 中国香港 地域的服务器 。

3. 端口 18789 无法访问：

   • 原因：防火墙没开。

   • 解决：不仅要在阿里云/腾讯云控制台的“防火墙”放行，如果你的服务器有自己的 iptables 或 firewalld，也需要放行：firewall-cmd --add-port=18789/tcp --permanent && firewall-cmd --reload 。

4. Gateway 启动后闪退：

   • 原因：配置文件 openclaw.json 格式错误（比如多了一个逗号）。

   • 解决：使用 openclaw doctor 命令自动诊断配置问题 。

结语

至此，你已经完成了 OpenClaw 从部署到配置再到扩展的全流程。现在，你拥有了一位专属的、能够 24 小时工作、可以操作电脑和浏览器的 AI 程序员助理。

接下来，你可以尝试让它去阅读你的 RSS 订阅并生成日报，或者让它监听你的邮箱并自动回复。AI 的世界才刚刚开始，快去探索这只“小龙虾”的无限可能吧！

如果觉得本文对你有帮助，欢迎点赞、收藏、关注，有任何部署问题欢迎在评论区留言交流！