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


