OpenClaw 使用 npm部署教程

發(fā)布時(shí)間：2026-03-17 11:58:02 作者：方寸 ACE

本文詳細(xì)介紹了如何使用npm在Windows系統(tǒng)上安裝和配置OpenClaw,包括環(huán)境準(zhǔn)備、安裝方式、初始化配置、啟動(dòng)服務(wù)、連接客戶端、常見(jiàn)問(wèn)題解決方法及進(jìn)階配置

OpenClaw 部署教程（使用 npm）

本教程介紹如何通過(guò) npm 在 Windows 系統(tǒng)上安裝和配置 OpenClaw。

環(huán)境準(zhǔn)備

系統(tǒng)要求

操作系統(tǒng): Windows 10/11, macOS, 或 Linux
Node.js: v18.0.0 或更高版本
npm: v8.0.0 或更高版本

檢查環(huán)境

# 檢查 Node.js 版本
node --version
?
# 檢查 npm 版本
npm --version

如果未安裝 Node.js，請(qǐng)前往 nodejs.org 下載并安裝 LTS 版本。

安裝 OpenClaw

方式一：全局安裝（推薦）

# 使用 npm 全局安裝
npm install -g openclaw
# 驗(yàn)證安裝
openclaw --version

方式二：本地安裝

# 創(chuàng)建項(xiàng)目目錄
mkdir my-openclaw
cd my-openclaw
# 初始化 npm 項(xiàng)目
npm init -y
# 本地安裝 OpenClaw
npm install openclaw

初始化配置

1. 創(chuàng)建配置文件

# 創(chuàng)建配置目錄
mkdir -p ~/.openclaw
# 創(chuàng)建基礎(chǔ)配置文件
touch ~/.openclaw/config.yaml

2. 編輯配置文件

打開(kāi) ~/.openclaw/config.yaml，添加基礎(chǔ)配置：

# OpenClaw 基礎(chǔ)配置
app:
  name: "My OpenClaw"
  debug: false
?
# 網(wǎng)關(guān)配置
gateway:
  host: "localhost"
  port: 8080
?
# 模型配置（示例：使用 OpenAI）
models:
  default: "gpt-4"
  providers:
 ?  openai:
 ? ?  api_key: "your-api-key-here"
 ? ?  base_url: "https://api.openai.com/v1"
?
# 可選：其他配置
plugins:
  - name: "web_search"
 ?  enabled: true
  - name: "file_manager"
 ?  enabled: true

3. 設(shè)置環(huán)境變量（可選）

# Windows PowerShell
$env:OPENCLAW_CONFIG_PATH = "$env:USERPROFILE\.openclaw\config.yaml"
# 或者添加到系統(tǒng)環(huán)境變量
[Environment]::SetEnvironmentVariable("OPENCLAW_CONFIG_PATH", "$env:USERPROFILE\.openclaw\config.yaml", "User")

啟動(dòng)服務(wù)

啟動(dòng) Gateway 服務(wù)

# 啟動(dòng) OpenClaw 網(wǎng)關(guān)
openclaw gateway start
# 或者后臺(tái)運(yùn)行
openclaw gateway start --daemon

檢查服務(wù)狀態(tài)

# 查看網(wǎng)關(guān)狀態(tài)
openclaw gateway status
# 查看詳細(xì)狀態(tài)
openclaw status

停止服務(wù)

# 停止網(wǎng)關(guān)
openclaw gateway stop
# 重啟網(wǎng)關(guān)
openclaw gateway restart

連接到客戶端

Web 界面

啟動(dòng)服務(wù)后，打開(kāi)瀏覽器訪問(wèn)：

http://localhost:8080

命令行交互

# 進(jìn)入交互模式
openclaw chat
# 或者發(fā)送單條消息
openclaw chat "你好，OpenClaw"

常見(jiàn)問(wèn)題

Q1: 安裝時(shí)出現(xiàn)權(quán)限錯(cuò)誤

解決方法：

# Windows: 以管理員身份運(yùn)行 PowerShell
# 然后執(zhí)行
npm install -g openclaw
# 或者更改 npm 全局目錄
npm config set prefix "$env:USERPROFILE\npm-global"

Q2: 端口被占用

解決方法：

# 查看端口占用情況
netstat -ano | findstr :8080
# 修改配置文件中的端口
# 編輯 ~/.openclaw/config.yaml
gateway:
  port: 8081 ?# 改為其他端口

Q3: 無(wú)法連接到模型 API

解決方法：

檢查 API Key 是否正確
確認(rèn)網(wǎng)絡(luò)連接正常
查看日志獲取詳細(xì)信息：

openclaw logs

Q4: 如何更新 OpenClaw

# 全局更新
npm update -g openclaw
# 查看版本
openclaw --version

?? 進(jìn)階配置

配置多個(gè)模型提供商

models:
  default: "gpt-4"
  providers:
 ?  openai:
 ? ?  api_key: "${OPENAI_API_KEY}"
 ? ?  base_url: "https://api.openai.com/v1"
 ?  anthropic:
 ? ?  api_key: "${ANTHROPIC_API_KEY}"
 ? ?  base_url: "https://api.anthropic.com"
 ?  local:
 ? ?  base_url: "http://localhost:11434" ?# Ollama 本地模型

啟用插件

plugins:
  - name: "web_search"
 ?  enabled: true
 ?  config:
 ? ?  engine: "duckduckgo"
  - name: "file_manager"
 ?  enabled: true
 ?  config:
 ? ?  allowed_paths:
 ? ? ?  - "~/Documents"
 ? ? ?  - "~/Projects"