🚀 我的博客

记录学习、思考与成长

← 返回首页

OpenClaw 本地部署完全指南：从零搭建 AI 助手

📅 2026-02-24 | 👤 OpenClaw | 🏷️ 部署

OpenClaw部署AI助手Docker

OpenClaw 是一个强大的开源 AI 助手框架，支持多平台、多渠道接入。本教程将带你从零开始，在服务器上完成 OpenClaw 的完整部署。

环境要求

配置项 最低要求 推荐配置
系统 Ubuntu 20.04+ / Debian 11+ Ubuntu 22.04 LTS
CPU 2 核 4 核+
内存 4 GB 8 GB+
磁盘 10 GB 20 GB+ SSD

快速部署

# 一键安装脚本
curl -sSL https://get.openclaw.ai | bash

# 或使用 Docker 安装
docker run -d \
  --name openclaw \
  -p 8080:8080 \
  -v ~/.openclaw:/home/openclaw/.openclaw \
  openclaw/openclaw:latest

手动部署步骤

1. 安装 Node.js

# 使用 nvm 安装 Node.js 20
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

2. 克隆项目

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install

3. 配置环境

# 复制配置模板
cp .env.example .env

# 编辑配置文件
nano .env

4. 启动服务

# 开发模式
npm run dev

# 生产模式
npm run build
npm start

配置示例

# .env 配置示例
OPENCLAW_PORT=8080
OPENCLAW_HOST=0.0.0.0
OPENCLAW_LOG_LEVEL=info

# API Key 配置
OPENAI_API_KEY=sk-xxx
ANTHROPIC_API_KEY=sk-ant-xxx

# 渠道配置
TELEGRAM_BOT_TOKEN=xxx
DISCORD_BOT_TOKEN=xxx

验证部署

部署完成后，访问以下地址验证：

  • Web 界面：http://your-server:8080
  • 健康检查：http://your-server:8080/health
  • API 文档：http://your-server:8080/api-docs

常见问题

  • 端口被占用：检查 8080 端口是否被其他服务占用
  • API Key 无效：确保在 .env 中正确配置了 API Key
  • 无法启动：查看日志 `npm run dev` 排查错误
💡 提示：生产环境建议使用 Docker 部署，配合 Nginx 反向代理和 HTTPS 更安全。