前言

本文从WSL2 安装开始，完整记录 OpenClaw 对接阿里云 Coding Plan 免费模型的全流程，适配 Windows 10/11 + WSL2（Ubuntu）环境，重点标注新手易踩的坑及解决方案，适配 OpenClaw 2026.3.13 版本

一、WSL2 安装（安装过的用户跳过）

1.启用 WSL 和虚拟机功能（管理员权限执行）

• 打开 Windows「开始菜单」，搜索「命令提示符」，右键选择「以管理员身份运行」
• 执行以下命令启用 WSL 和虚拟机平台  

# 启用WSL功能
wsl --install
# 启用虚拟机平台（Win10需额外执行）
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

• 命令执行后会自动下载安装 Ubuntu 发行版；
• 出现提示时按回车确认，等待安装完成后重启电脑。

2.配置 WSL2 默认版本

# 设置WSL2为默认版本
wsl --set-default-version 2
# 验证WSL版本（可选）
wsl --version
# 输出包含WSL版本: 2.x.x（无则需更新 WSL）

3. 初始化 Ubuntu 子系统

• 重启电脑后，自动弹出 Ubuntu 终端，按提示：
• 设置用户名（如xinto，自定义）；
• 设置密码（需输入两次，密码输入时无显示，正常现象）；
• 完成后即可进入 Ubuntu 命令行界面。

4. 更新 Ubuntu 子系统（首次必做）

# 更新软件源
sudo apt update
# 升级依赖包
sudo apt upgrade -y
# 输入设置的密码后等待完成，出现[Y/n]时按回车确认

二、OpenClaw 环境准备（基础依赖安装，逐行执行）

1. 安装 Node.js 和 npm（OpenClaw 核心依赖）

# 安装Node.js和npm（OpenClaw基于Node.js开发，必须安装）
sudo apt install nodejs npm -y
# 验证安装是否成功
node -v
npm -v
# 输出 Node.js 和 npm 的版本号（如 v18.x.x、9.x.x），无command not found报错。

2. 配置 npm 全局目录（解决权限 + PATH 问题）

# 步骤1：创建npm全局目录（避免后续安装权限报错）
mkdir -p ~/.npm-global
# 步骤2：设置npm全局安装路径指向该目录
npm config set prefix ~/.npm-global
# 步骤3：临时配置PATH环境变量（当前终端生效）
export PATH="$HOME/.npm-global/bin:$PATH"
# 步骤4：永久配置PATH（写入bash配置文件，重启终端仍生效）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
# 步骤5：立即加载新的bash配置
source ~/.bashrc
# 验证PATH是否配置成功
echo $PATH | grep ~/.npm-global/bin
# 最后一行命令输出包含/home/你的用户名/.npm-global/bin（无输出则配置失败）。

• ⚠️如遇执行openclaw提示command not found

• 原因：PATH 环境变量未生效，系统找不到 openclaw 命令位置。

• 解决方案：重新执行步骤 3 的export PATH="$HOME/.npm-global/bin:$PATH"，再验证。

3. 安装 OpenClaw

# 全局安装OpenClaw（-g表示全局安装，可在任意目录执行命令）
npm install -g openclaw
# 验证OpenClaw安装成功
openclaw --version
# 输出OpenClaw 2026.3.13（或对应版本号），无报错。

安装结束后会自动出现提示信息，请根据提示信息完成 OpenClaw 配置，参考配置如下

配置项	配置内容
I understand this is powerful and inherently risky. Continue?	选择 ”Yes”
Onboarding mode	选择 “QuickStart”
Model/auth provider	选择 “Skip for now”，后续可以配置
Filter models by provider	选择 “All providers”
Default model	使用默认配置
Select channel (QuickStart)	选择 “Skip for now”，后续可以配置
Configure skills now? (recommended)	选择 “No”，后续可以配置。
Enable hooks?	按空格键选中 “Skip for now”，按回车键进入下一步。
How do you want to hatch your bot?	选择 “Hatch in TUI”。

三、配置阿里云 Coding Plan 模型（核心步骤）

阿里云官方文档教程：https://help.aliyun.com/zh/model-studio/openclaw-coding-plan?spm=a2c4g.11186623.help-menu-2400256.d_0_2_2_0.747d4c4dfDLf0l

1. 初始化 OpenClaw 配置（生成默认配置文件）

# 执行初始化命令，生成默认配置目录和文件
openclaw configure --init

2. 替换全局配置文件（指向阿里云模型）

# 步骤1：备份原全局配置文件（防止改错无法恢复）
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
# 步骤2：写入阿里云模型配置（替换原文件）
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "wizard": {
    "lastRunAt": "2026-03-19T09:27:42.780Z",
    "lastRunVersion": "2026.3.13",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "【替换为你的阿里云Coding Plan API Key】",
        "api": "openai-completions",
        "models": [
          {"id": "qwen3.5-plus", "name": "qwen3.5-plus", "reasoning": false, "input": ["text", "image"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 1000000, "maxTokens": 65536},
          {"id": "qwen3-max-2026-01-23", "name": "qwen3-max-2026-01-23", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 262144, "maxTokens": 65536},
          {"id": "qwen3-coder-next", "name": "qwen3-coder-next", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 262144, "maxTokens": 65536},
          {"id": "qwen3-coder-plus", "name": "qwen3-coder-plus", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 1000000, "maxTokens": 65536},
          {"id": "MiniMax-M2.5", "name": "MiniMax-M2.5", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 1000000, "maxTokens": 65536},
          {"id": "glm-5", "name": "glm-5", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 202752, "maxTokens": 16384},
          {"id": "glm-4.7", "name": "glm-4.7", "reasoning": false, "input": ["text"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 202752, "maxTokens": 16384},
          {"id": "kimi-k2.5", "name": "kimi-k2.5", "reasoning": false, "input": ["text", "image"], "cost": {"input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0}, "contextWindow": 262144, "maxTokens": 32768}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "workspace": "$HOME/.openclaw/workspace",
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-max-2026-01-23": {},
        "bailian/qwen3-coder-next": {},
        "bailian/qwen3-coder-plus": {},
        "bailian/MiniMax-M2.5": {},
        "bailian/glm-5": {},
        "bailian/glm-4.7": {},
        "bailian/kimi-k2.5": {}
      }
    }
  },
  "tools": {
    "profile": "coding"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "【可保留默认值，或自定义随机字符串】"
    }
  },
  "meta": {
    "lastTouchedVersion": "2026.3.13",
    "lastTouchedAt": "2026-03-19T09:27:42.786Z"
  }
}
EOF

关键修改：

• 将apiKey替换为你的阿里云 Coding Plan 专属 API Key（从阿里云控制台获取）；
• workspace路径中的$HOME会自动识别为当前用户主目录，无需手动修改；
• token可保留默认值，或自定义一串随机字符（用于网关鉴权）。

3. 修复无效配置项（清理冗余配置）

# 自动检测并删除无效配置项（如tailscale/nodes）
openclaw doctor --fix
# 验证配置是否修复成功
openclaw doctor

• 执行说明：doctor --fix会自动删除新版本不兼容的配置，最后执行openclaw doctor无Config invalid提示即为成功。
• ⚠️提示Unrecognized keys: "tailscale", "nodes"
• 原因：新版本 OpenClaw 移除了这些配置项，原配置文件存在冗余。
• 解决方案：必须执行openclaw doctor --fix，否则网关无法启动。

4. 配置 Agent 级别模型（解决 Anthropic 模型调用报错）

# 步骤1：创建Agent配置目录（确保目录存在，无则新建）
mkdir -p ~/.openclaw/agents/main/agent/
# 步骤2：写入Agent配置文件（强制指向阿里云模型）
cat > ~/.openclaw/agents/main/agent/config.json << 'EOF'
{
  "model": {
    "primary": "bailian/qwen3.5-plus"
  },
  "models": {
    "bailian/qwen3.5-plus": {},
    "bailian/qwen3-max-2026-01-23": {},
    "bailian/qwen3-coder-next": {},
    "bailian/qwen3-coder-plus": {},
    "bailian/MiniMax-M2.5": {},
    "bailian/glm-5": {},
    "bailian/glm-4.7": {},
    "bailian/kimi-k2.5": {}
  }
}
EOF
# 步骤3：验证Agent配置文件是否创建成功
ls -l ~/.openclaw/agents/main/agent/config.json

• 验证标准：最后一行命令输出包含config.json文件信息（如-rw-r--r-- 1 用户名 用户名 334 日期 路径）。
• ⚠️Web 端提示No API key found for provider "anthropic"
• 原因：Agent 级配置未覆盖，仍默认调用 Anthropic 模型（无 API Key 则报错）。
• 解决方案：必须手动创建上述 Agent 配置文件，强制指定阿里云模型。

四、启动服务并验证（分步执行，确保每步成功）

1. 重启 OpenClaw 网关（加载新配置）

# 重启网关服务，使新配置生效
openclaw gateway restart

2. 启动 Web 可视化界面（推荐，比 TUI 稳定）

# 启动Web Dashboard（可视化界面，新手友好）
openclaw dashboard

• 命令执行后，终端输出🦞 OpenClaw Dashboard running at http://127.0.0.1:18789；
• 打开 Windows 浏览器（Edge/Chrome），输入该地址访问。

3. （可选）启动终端 TUI 界面（备用方案）

# 启动TUI并强制指定阿里云模型（避免卡顿）
openclaw tui --model bailian/qwen3.5-plus