Harness 与 Agent 工程 · AI研发与测试工程 · 2026-05-10

家用Linux系统OpenClaw部署保姆级教程

OpenClaw让AI助手在多平台无缝运行,新手也能轻松部署自己的智能系统。

核心内容:

  1. OpenClaw核心功能与多渠道集成能力
  2. 部署前的系统与硬件要求详解
  3. 从零开始的完整Linux部署步骤

🦞 家用 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. 部署硬件条件

💻 操作系统要求

⚙️ 硬件要求

📝 说明:以下硬件要求为经验估算值,实际需求取决于使用场景和并发量。

📦 软件依赖

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…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026051048712.html