OpenClaw 部署教程（使用 npm）

本教程介绍如何通过 npm 在 Windows 系统上安装和配置 OpenClaw。

---

📋 目录

1. 环境准备

2. 安装 OpenClaw

3. 初始化配置

4. 启动服务

5. 常见问题

---

环境准备

系统要求

• 操作系统: Windows 10/11, macOS, 或 Linux

• Node.js: v18.0.0 或更高版本

• npm: v8.0.0 或更高版本

检查环境

# 检查 Node.js 版本
node --version
​
# 检查 npm 版本
npm --version

如果未安装 Node.js，请前往 nodejs.org 下载并安装 LTS 版本。

---

安装 OpenClaw

方式一：全局安装（推荐）

# 使用 npm 全局安装
npm install -g openclaw
​
# 验证安装
openclaw --version

方式二：本地安装

# 创建项目目录
mkdir my-openclaw
cd my-openclaw
​
# 初始化 npm 项目
npm init -y
​
# 本地安装 OpenClaw
npm install openclaw

---

初始化配置

1. 创建配置文件

# 创建配置目录
mkdir -p ~/.openclaw
​
# 创建基础配置文件
touch ~/.openclaw/config.yaml

2. 编辑配置文件

打开 ~/.openclaw/config.yaml，添加基础配置：

# OpenClaw 基础配置
app:
  name: "My OpenClaw"
  debug: false
​
# 网关配置
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. 设置环境变量（可选）

# Windows PowerShell
$env:OPENCLAW_CONFIG_PATH = "$env:USERPROFILE\.openclaw\config.yaml"
​
# 或者添加到系统环境变量
[Environment]::SetEnvironmentVariable("OPENCLAW_CONFIG_PATH", "$env:USERPROFILE\.openclaw\config.yaml", "User")

---

启动服务

启动 Gateway 服务

# 启动 OpenClaw 网关
openclaw gateway start
​
# 或者后台运行
openclaw gateway start --daemon

检查服务状态

# 查看网关状态
openclaw gateway status
​
# 查看详细状态
openclaw status

停止服务

# 停止网关
openclaw gateway stop
​
# 重启网关
openclaw gateway restart

---

连接到客户端

Web 界面

启动服务后，打开浏览器访问：

http://localhost:8080

命令行交互

# 进入交互模式
openclaw chat
​
# 或者发送单条消息
openclaw chat "你好，OpenClaw"

---

常见问题

Q1: 安装时出现权限错误

解决方法：

# Windows: 以管理员身份运行 PowerShell
# 然后执行
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: 无法连接到模型 API

解决方法：

1. 检查 API Key 是否正确

2. 确认网络连接正常

3. 查看日志获取详细信息：

openclaw logs

Q4: 如何更新 OpenClaw

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

---

📝 进阶配置

配置多个模型提供商

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"

---

🔗 相关链接

• OpenClaw 官方文档

• GitHub 仓库

• 社区 Discord

• Skill 市场

---

✅ 快速检查清单

部署完成后，确认以下事项：

• Node.js 和 npm 已正确安装

• OpenClaw 已成功安装

• 配置文件已创建并正确填写

• Gateway 服务已成功启动

• 可以通过浏览器或 CLI 访问 OpenClaw

• 模型 API 连接正常

---

💡 提示: 如果遇到问题，可以运行 openclaw doctor 进行诊断检查。

---

最后更新: 2026-03-16