OpenClaw 使用 npm部署教程

2026-03-17 11:58:02 方寸 ACE

OpenClaw 部署教程（使用 npm）

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

环境准备

系统要求

操作系统: 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

解决方法：

检查 API Key 是否正确
确认网络连接正常
查看日志获取详细信息：

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"

🔗 相关链接

✅ 快速检查清单

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

Node.js 和 npm 已正确安装
OpenClaw 已成功安装
配置文件已创建并正确填写
Gateway 服务已成功启动
可以通过浏览器或 CLI 访问 OpenClaw
模型 API 连接正常

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

到此这篇关于OpenClaw 使用 npm部署教程的文章就介绍到这了,更多相关OpenClaw 部署教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！