内容概览

内容简介

OpenClaw 是一个开源的 AI 助手平台，让你可以在本地运行自己的 AI 助手。它就像你自己的贾维斯

适合小白的OpenClaw 完整部署教程

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手平台，让你可以在本地运行自己的 AI 助手。它就像你自己的贾维斯，可以：

  • 通过多种渠道聊天（Telegram、Discord、WhatsApp、网页等）
  • 访问你的文件、日历、浏览器等资源
  • 执行自动化任务
  • 扩展各种技能（天气查询、文件管理、网页搜索等）

第一部分：系统准备

1.1 操作系统要求

  • macOS：10.15 或更高
  • Linux：Ubuntu 20.04+、Debian 11+、CentOS 8+
  • Windows：Windows 10/11 + WSL2（推荐）
  • 其他：树莓派、云服务器等 1.2 硬件要求
  • 内存：至少 4GB RAM（推荐 8GB+）
  • 存储：至少 2GB 可用空间
  • CPU：现代双核处理器
  • 网络：稳定的互联网连接 1.3 软件要求
  • Node.js：版本 22 或更高
  • Git：用于某些安装方式
  • 包管理器：npm 或 pnpm

第二部分：安装 OpenClaw（多种方式）

2.1 快速安装（推荐给小白）

macOS/Linux

Shell
curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）

文本
iwr -useb https://openclaw.ai/install.ps1 | iex

这个方式会自动：

  • 检测并安装 Node.js（如果需要）
  • 选择最佳安装方式
  • 设置环境变量
  • 运行健康检查

2.2 高级安装选项

方式一：全局 npm 安装（标准方式）

MARKDOWN
# 安装 Node.js（如果还没有）# macOSbrew install node@22
# Ubuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs
# 安装 OpenClawnpm install -g openclaw@latest
# 如果遇到 sharp 包错误SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方式二：Git 源码安装（开发者/定制）

MARKDOWN
# 克隆仓库git clone https://github.com/openclaw/openclaw.gitcd openclaw
# 安装依赖pnpm installpnpm ui:buildpnpm build
# 运行pnpm openclaw onboard --install-daemon

方式三：无 root 权限安装

Shell
curl -fsSL https://openclaw.ai/install-cli.sh | bash

这个方式会将 OpenClaw 安装到 ~/.openclaw 目录，不修改系统文件。

方式四：Docker 安装

MARKDOWN
# 拉取镜像docker pull ghcr.io/openclaw/openclaw:latest
# 运行docker run -p 18789:18789 ghcr.io/openclaw/openclaw:latest

2.3 安装参数详解

安装脚本支持多种参数：

MARKDOWN
# 查看所有参数curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help
# 常用参数示例curl -fsSL https://openclaw.ai/install.sh | bash -s -- \  --install-method git \          # 使用 Git 源码安装  --git-dir ~/my-openclaw \       # 指定安装目录  --no-git-update \               # 不更新现有仓库  --no-prompt \                   # 非交互模式（适合脚本）  --dry-run                       # 只显示将要执行的操作

环境变量方式（适合自动化）：

JavaScript
export OPENCLAW_INSTALL_METHOD=gitexport OPENCLAW_GIT_DIR=~/openclaw-customexport OPENCLAW_NO_PROMPT=1curl -fsSL https://openclaw.ai/install.sh | bash

第三部分：AI 模型配置（核心！）

3.1 理解 AI 模型

OpenClaw 本身不包含 AI 模型，它需要连接外部的 AI 服务。你有多种选择：

  1. 免费模型：DeepSeek、Qwen 等
  2. 付费模型：OpenAI GPT、Claude、Gemini 等
  3. 本地模型：Ollama、LM Studio 等
  4. 混合使用：根据任务选择不同模型

3.2 查看可用模型

MARKDOWN
# 查看已配置的模型openclaw models list
# 查看模型详情openclaw models describe deepseek/deepseek-chat

3.3 配置免费模型（DeepSeek 示例）

步骤 1：获取 API 密钥

  1. 访问 https://platform.deepseek.com/
  2. 注册账号
  3. 在控制台创建 API 密钥

步骤 2：配置 OpenClaw

MARKDOWN
# 设置 DeepSeek API 密钥openclaw config set providers.deepseek.apiKey "你的-api-key"
# 设置为默认模型openclaw config set agents.defaults.model "deepseek/deepseek-chat"
# 验证配置openclaw config get agents.defaults.model

3.4 配置付费模型（OpenAI 示例）

步骤 1：获取 API 密钥

  1. 访问 https://platform.openai.com/
  2. 注册账号并充值
  3. 创建 API 密钥

步骤 2：配置 OpenClaw

MARKDOWN
# 设置 OpenAI API 密钥openclaw config set providers.openai.apiKey "sk-你的密钥"
# 设置为默认模型openclaw config set agents.defaults.model "openai/gpt-4o"
# 可选：设置组织 IDopenclaw config set providers.openai.organization "org-你的组织ID"

3.5 配置本地模型（Ollama 示例）

步骤 1：安装 Ollama

MARKDOWN
# macOS/Linuxcurl -fsSL https://ollama.ai/install.sh | sh
# Windows# 从 https://ollama.com/download 下载安装包

步骤 2：下载模型

MARKDOWN
# 下载一个轻量级模型ollama pull llama3.2:3b
# 或者下载更大的模型ollama pull llama3.1:8b

步骤 3：配置 OpenClaw

MARKDOWN
# 设置 Ollama 端点openclaw config set providers.ollama.baseUrl "http://localhost:11434"
# 设置为默认模型openclaw config set agents.defaults.model "ollama/llama3.2:3b"

3.6 多模型配置

你可以配置多个模型，根据不同场景使用：

MARKDOWN
# 配置多个模型端点openclaw config set providers.deepseek.apiKey "deepseek-key"openclaw config set provide
开篇预览到这里

解锁后会在当前位置展开剩余正文，不会跳离当前页面。

正在读取获取状态
知归编辑部

更新日期：2026.03.08。版本、链接和使用说明以当前页面为准。