🦞 家用 Linux 系统 OpenClaw 部署保姆级教程
从零开始配置5个智能体 · 图文并茂 · 终端命令详解
📖 字数:5000+👶 适合新手📦 包含完整部署流程📑 目录导航
1. 什么是OpenClaw?
OpenClaw是一个开源的多渠道AI网关系统,它能够让你的AI助手同时在多个平台(如企业微信、QQ、飞书、钉钉、Telegram等)上运行,并且支持自定义智能体(Agents)来处理不同类型的任务。
当前最新版本为 2026.4.22,采用MIT开源许可证,完全免费使用。项目地址:GitHub,官方文档:docs.openclaw.ai。
💡 核心理念:"一个AI,多平台运行"。通过统一的后端管理系统,你可以在不同平台上部署相同的AI能力,同时根据每个平台的特点进行个性化定制。
2. OpenClaw能做什么
✅ 多渠道集成
支持20+种消息渠道,包括:飞书、钉钉、企业微信、QQ 等。
✅ 智能体系统
支持创建和管理多个专业智能体,每个智能体可以有不同的角色、模型和工作空间。智能体之间可以相互调用和协作。
✅ 强大的工具集成
内置文件操作、网络请求、浏览器控制、系统命令执行、图片生成、语音合成、视频生成等工具。
✅ 安全与权限管理
提供基于令牌的访问控制、权限分级、API密钥自动脱敏、完整的操作日志记录等安全机制。
3. 部署硬件条件
💻 操作系统要求
- Ubuntu(推荐)— 用户友好,社区支持强大
- Debian — 稳定可靠,适合长期运行
- Fedora — 较新软件包,适合技术爱好者
- CentOS Stream — 企业级稳定性
⚙️ 硬件要求
📝 说明:以下硬件要求为经验估算值,实际需求取决于使用场景和并发量。
- CPU:2核以上(推荐 4核)
- 内存:4GB RAM(推荐 8GB 或更多,运行多个智能体时需要)
- 存储:至少 10GB 可用磁盘空间
- 网络:稳定的互联网连接
📦 软件依赖
- Node.js:v22 LTS 或更高版本(OpenClaw 使用了 Node.js 22 的新特性)
- npm:v8.x 或更高版本
- Git:用于版本控制和更新
- 编译工具:build-essential(Debian/Ubuntu)或 Development Tools(RHEL/CentOS/Fedora),某些 npm 包需要编译
4. Linux系统详细部署步骤
1系统更新
BASH# Ubuntu/Debiansudo apt update &&sudo apt upgrade -y# Fedorasudo dnf update -y# CentOS/RHELsudo yum update -y
2安装基础开发工具
BASH# Ubuntu/Debiansudo apt install -y build-essential git curl# Fedorasudo dnf groupinstall -y "Development Tools"sudo dnf install -y git curl# CentOS/RHELsudo yum groupinstall -y "Development Tools"sudo yum install -y git curl
3安装 Node.js v22 LTS
方法A:使用 NodeSource 官方仓库(推荐)
BASH# Ubuntu/Debian — 添加 NodeSource 仓库并安装 Node.js 22curl -fsSL https://deb.nodesource.com/setup_22.x |sudo -E bash -sudo apt-get install -y nodejs# Fedora/RHEL — 添加 NodeSource 仓库并安装 Node.js 22curl -fsSL https://rpm.nodesource.com/setup_22.x |sudo bash -sudo yum install -y nodejs# 验证安装node --versionnpm --version
方法B:使用 nvm(Node Version Manager)
BASH# 1. 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh # 建议使用最新稳定版本,访问 https://github.com/nvm-sh/nvm/releases 查看|bash# 2. 重新加载 shell 配置source ~/.bashrc# 3. 安装 Node.js 22 LTSnvm install 22nvm use 22nvm alias default 22# 4. 验证安装node --versionnpm --version
4全局安装 OpenClaw
BASH# 全局安装 OpenClawnpm install -g openclaw# 国内用户如遇网络问题,可配置镜像源npm install -g openclaw --registry https://registry.npmmirror.com# 验证安装openclaw --version
💡 推荐:配置 npm 全局目录(避免权限问题)
mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'echo'export PATH=~/.npm-global/bin:$PATH'>> ~/.bashrcsource ~/.bashrc
5安装系统依赖(可选,浏览器功能需要)
BASH# Ubuntu/Debian — 安装浏览器和多媒体依赖sudo apt-get install -y \ libx11-dev libx11-xcb-dev libsecret-1-dev \ libgtk-3-dev libnotify-dev libglib2.0-dev \ libnss3-dev libasound2-dev libxtst-dev \ xauth xvfb ffmpeg
6启动 OpenClaw
BASH# 启动 Gateway 服务openclaw gateway start# 检查服务状态openclaw gateway status
启动成功后,你会看到类似输出:
OUTPUTOpenClaw gateway listening on http://localhost:18789
💡 小贴士:OpenClaw默认监听端口 18789。你可以在浏览器中访问
http://localhost:18789打开Web管理界面。
5. 基础配置
配置文件位置
OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json。首次启动时 OpenClaw 会自动创建该文件。如果未自动创建,可以手动创建: mkdir -p ~/.openclaw && touch ~/.openclaw/openclaw.json
配置AI模型
编辑配置文件,添加AI模型API密钥。以下是使用通义千问(Qwen)的示例:
JSON{"models": {"providers": {"generic": {"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1","apiKey": "your-dashscope-api-key-here","api": "openai-completions","models": [ {"id": "qwen3.6-plus","name": "Qwen 3.6 Plus","contextWindow": 999999,"maxTokens": 4096 } ] } } }}
修改默认端口(可选)
如果需要修改默认端口(18789),在配置文件中添加:
JSON{"gateway": {"port": 18790 }}
查看配置
BASH# 查看当前配置openclaw gate…