OpenClaw-Linux 部署教程
1. 核心认知:为什么选择 OpenClaw
OpenClaw 是运行在本地服务器上的高权限 AI 智能体。相比云端 SaaS 服务,它的核心优势在于数据隐私完全本地化、支持 Shell 命令及文件读写等高权限操作,并能原生集成飞书、Telegram 等主流平台。
2. 部署前准备:环境与工具
2.1 硬性环境要求
| 项目 | 要求 | 备注 |
|---|---|---|
| 操作系统 | Linux (推荐) / macOS / Windows (WSL2) | 本文以 Linux 为例 |
| Node.js | ≥ 22.x | 必须,低版本会安装失败 |
| 内存 | ≥ 2GB (建议 4GB) | 2GB 内存必须配置虚拟内存 |
| 网络 | 可访问 GitHub, npm | 国内服务器建议配置镜像源或代理 |
| AI 模型 | 通义千问 (Qwen) / OpenAI 等 API Key | 推荐通义千问,有免费额度 |
2.2 必备凭证
- 通义千问 API Key:登录阿里云百炼控制台创建。
- 飞书开放平台账号:用于创建自建应用。
- 服务器信息:公网 IP、SSH 账号密码。
3. 方案 A:阿里云一键部署(适合新手)
若你使用的是阿里云轻量应用服务器,此方案几分钟即可完成。
- 购买实例:
- 访问 OpenClaw 一键部署页面。
- 选择 OpenClaw 镜像。
- 配置建议:2 核 2GB 及以上,地域推荐美国弗吉尼亚或中国香港(网络更通畅)。
- 配置 API Key:
- 在服务器控制台'应用详情'页,点击 一键放通 端口
18789。 - 输入之前创建的 百炼 API Key 并执行配置命令。
- 在服务器控制台'应用详情'页,点击 一键放通 端口
- 访问面板:
- 生成 Token 后,点击'打开网站页面'或通过
http://公网 IP:18789访问。 - 输入 Token 即可开始使用。
- 生成 Token 后,点击'打开网站页面'或通过
4. 方案 B:Linux 手动部署全流程
适合所有 Linux 环境,步骤稍多但灵活性更高。
4.1 安装基础依赖
1. 安装 Git
sudo apt update
sudo apt install git -y
git --version
2. 安装 Node.js (v22+) 推荐使用 NVM 管理版本:


