OpenClaw 千问大模型配置

一、 OpenClaw 安装部署指南

想在Windows 11系统上顺利运行OpenClaw吗？目前最稳定高效的方案，是借助WSL 2（Windows Subsystem for Linux）搭建Ubuntu-24.04环境。我们已为你准备了一份超详细的“手把手”教程。请直接参考这篇实战指南《Windows11 WSL 2 Ubuntu-24.04 部署OpenClaw》，按照其中的步骤操作，即可完成环境配置。

二、 获取阿里通义千问API密钥

部署好运行环境后，下一步是获取AI模型的服务能力。本教程推荐使用阿里云百炼平台提供的通义千问大模型API。你需要首先访问百炼平台控制台，完成账号注册并创建一个新应用，从而获取至关重要的API Key，用于后续的OpenClaw配置。

三、 配置OpenClaw连接千问API

所有的核心配置都集中在一个关键文件中：~/.openclaw/openclaw.json。你需要将上一步从阿里百炼获取的真实API Key，准确无误地填入下方提供的配置模板中。请特别注意 apiKey 和 baseUrl 这两个字段的值是否正确。

{
  "meta": {
    "lastTouchedVersion": "2026.3.8",
    "lastTouchedAt": "2026-03-09T05:14:42.121Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-09T05:14:42.107Z",
    "lastRunVersion": "2026.3.8",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {
      "qwen-portal:default": {
        "provider": "qwen-portal",
        "mode": "oauth"
      }
    }
  },
  "models": {
    "providers": {
      "qwen-portal": {
        // 通义千问模型API的兼容模式端点地址
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        // 请在此处替换为你从阿里百炼控制台获取的真实API Key
        "apiKey": "sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "api": "openai-completions",
        "models": [
          {
            "id": "coder-model",
            "name": "Qwen Coder",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "vision-model",
            "name": "Qwen Vision",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen-portal/coder-model"
      },
      "models": {
        "qwen-portal/coder-model": {
          "alias": "qwen"
        },
        "qwen-portal/vision-model": {}
      },
      "workspace": "/root/.openclaw/workspace"
    }
  },
  "tools": {
    "profile": "messaging"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "command-logger": {
          "enabled": true
        },
        "boot-md": {
          "enabled": true
        },
        "bootstrap-extra-files": {
          "enabled": true
        },
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "gateway": {
    // OpenClaw网关服务的监听端口
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      // 通过WebUI访问时需要携带此Token，格式为：http://127.0.0.1:18789/#token=xxxxxxxx
      // 如果未携带Token直接访问，将会收到“未授权”(Unauthorized)的错误提示
      "token": "f9274d4d49af4cb0e7bb3f2fb987e346c4b8c71811deb801"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send"
      ]
    }
  },
  "plugins": {
    "entries": {
      "qwen-portal-auth": {
        "enabled": true
      }
    }
  }
}

四、 启动OpenClaw网关服务

1. 清理残留的OpenClaw进程

为了确保一个纯净的启动环境，避免端口冲突或旧配置影响，建议先清理系统中可能存在的旧OpenClaw进程。在终端中执行以下命令即可：

pkill -9 -f openclaw-gateway || true

2、 启动OpenClaw服务

进程清理完毕后，即可启动OpenClaw网关服务。请根据你的实际安装方式，选择合适的启动命令：

• 常规启动（适用于本地测试或开发环境）: 直接运行 pnpm openclaw gateway 或简写命令 openclaw gateway。
• 后台守护进程启动（适合长期运行的生产环境）:

  nohup pnpm openclaw gateway run \
    --bind loopback \
    --port 18789 \
    --force \
    > gateway.log 2>&1 &

  此命令会将服务置于后台运行，并将日志输出到gateway.log文件中。

当你在终端中看到服务成功启动并监听指定端口的提示信息时，即表示OpenClaw网关已正常运行。

五、 通过WebUI访问与管理

最后一步，通过直观的Web用户界面来连接并使用你的AI助手。在浏览器的地址栏中输入以下控制面板地址即可访问OpenClaw的Web管理界面。