使用 npm / pnpm 部署 OpenClaw 并配置免费 Qwen Token

本文介绍如何通过 Node.js 环境 使用 npm 或 pnpm 部署 OpenClaw，并接入 Qwen（通义千问）免费 API Token。

一、环境准备

1️⃣ 基础依赖

组件	推荐版本
Node.js	≥ 18.x
npm	≥ 9.x
pnpm（可选）	≥ 8.x
Git	最新版本

检查版本：

node -v
npm -v

如需安装 pnpm：

npm install -g pnpm

二、克隆 OpenClaw 项目

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

三、使用 npm 安装依赖

npm install

启动项目：

npm run dev

或生产模式：

npm run build
npm start

四、使用 pnpm 安装依赖（推荐）

pnpm 具有：

更快的安装速度
磁盘去重存储
更严格的依赖管理

安装依赖：

pnpm install

启动开发模式：

pnpm dev

构建生产版本：

pnpm build
pnpm start

五、获取免费 Qwen Token

Qwen（通义千问）由阿里云提供，通过 DashScope 平台调用。

1️⃣ 注册 DashScope

进入官网注册账号。

2️⃣ 创建 API Key

控制台 → API Key 管理 → 创建 Key

格式示例：

sk-xxxxxxxxxxxxxxxx

免费额度通常包含一定调用 Token。

六、配置 OpenClaw 接入 Qwen

在项目根目录创建 .env 文件：

QWEN_API_KEY=sk-xxxxxxxxxxxx
QWEN_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
DEFAULT_MODEL=qwen-turbo

或在 config.ts / config.js 中配置：

export default {
  providers: {
    qwen: {
      baseURL: process.env.QWEN_BASE_URL,
      apiKey: process.env.QWEN_API_KEY,
      model: "qwen-turbo"
    }
  }
}

七、测试接口调用

本地默认端口（示例）：

http://localhost:3000

测试请求：

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-turbo",
    "messages": [
      { "role": "user", "content": "你好" }
    ]
  }'

八、Docker 部署（Node 版本）

构建镜像：

docker build -t openclaw-node .

运行容器：

docker run -d \
  -p 3000:3000 \
  --env-file .env \
  openclaw-node

九、常见问题排查

1️⃣ 401 错误

API Key 填写错误
未使用 compatible-mode 地址

2️⃣ 依赖安装失败

删除 node_modules
删除 package-lock.json 或 pnpm-lock.yaml
重新安装

rm -rf node_modules
pnpm install

3️⃣ Token 超限

十、npm vs pnpm 对比

项目	npm	pnpm
安装速度	普通	快
磁盘占用	高	低
monorepo 支持	一般	强
推荐程度	可用	⭐ 推荐

总结

通过本文，你可以：

使用 npm 或 pnpm 快速部署 OpenClaw
获取免费 Qwen API Token
成功接入通义千问模型
运行本地 LLM API 服务

如用于生产环境，建议：

使用反向代理（Nginx）
配置 HTTPS
设置访问鉴权
监控 API Token 使用量