OpenClaw 安装与配置

OpenClaw 安装与配置（含阿里云 Coding Plan 集成）

一、环境准备

在开始之前，得先确保你的系统环境达标。核心要求是 Node.js，版本至少需要 v22.0.0 或更高。

检查命令很简单，打开你的终端或命令提示符，分别运行：

node -v
npm -v

两行命令会分别显示 Node.js 和 npm 的版本号，核对一下即可。

二、安装 OpenClaw

Windows（PowerShell）

对于 Windows 用户，使用 PowerShell 执行以下一键安装命令是最快捷的方式：

iwr -useb https://openclaw.ai/install.ps1 | iex

不过，不少朋友在执行时可能会遇到一个典型错误，提示脚本执行被禁止。这其实是 Windows 系统的一项默认安全策略在起作用，目的很明确，就是防止未经签名的潜在恶意脚本自动运行。

解决起来并不复杂，核心在于调整 PowerShell 的“执行策略”。

快速解决方法

只需要几个步骤：

第一步，以管理员身份运行 PowerShell。你可以点击“开始”菜单或直接按 Win 键，搜索“PowerShell”，在结果上右键选择“以管理员身份运行”。

第二步，修改执行策略。在弹出的管理员窗口中，输入以下命令并回车：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

简单说明一下：RemoteSigned 是一个广为推荐的中庸选项，它允许你运行本地编写的脚本，同时对于从网上下载的脚本，则要求有数字签名，在便利与安全之间找到了平衡点。而 -Scope CurrentUser 意味着这个改动只对你当前的用户账户生效，不会影响系统里的其他用户。

系统通常会询问你是否确认更改，输入 Y 然后回车。

第三步，验证修改。完成后，可以输入以下命令查看当前策略是否已更新为 RemoteSigned：

Get-ExecutionPolicy

至此，再回头去执行最初的安装命令，应该就能一路畅通了。

其他临时或备选方案

如果因为公司策略或其他原因，无法永久修改设置，也有变通之法。

临时绕过：如果只是想单次运行脚本，可以在命令提示符或 PowerShell 中使用 Bypass 参数。比如，运行特定脚本文件时：

powershell -ExecutionPolicy Bypass -File “D:\Program Files\nodejs\npm.ps1”

或者，你也可以在当前的 PowerShell 会话中临时设置，这个设置会随窗口关闭而失效：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

设置完成后，再去执行 iex 那条命令就行了。

macOS / Linux

对于 macOS 或 Linux 用户，过程就简单多了，直接在终端中执行：

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程基本一路回车，采用默认选项即可顺利完成。

三、验证安装

无论通过哪种方式安装完成，都建议验证一下。打开终端，运行：

openclaw-cn --version

如果正确输出版本号，恭喜你，安装成功了。

四、初始化配置向导

安装好之后，第一步是进行初始化配置。运行下面的命令会启动一个交互式向导：

openclaw-cn onboard --install-daemon

对于大多数想快速上手的朋友，建议选择“快速开始”模式。根据提示，通常可以这样选择：

• 是否了解风险：Yes
• 引导模式：QuickStart
• 模型提供商：Skip for now （我们稍后会专门配置）
• 渠道配置：Skip for now
• 技能配置：No
• Hook 配置：按空格键选中后，同样选择 Skip for now
• 启动方式：Hatch in TUI （这将启动一个酷炫的终端界面）

五、配置阿里云 Coding Plan 模型

接下来是关键步骤：接入阿里云 Coding Plan 提供的丰富模型。这能让你免费调用包括通义千问、MiniMax、智谱、Kimi等在内的多个强力模型。

1. 打开 Web UI 配置界面

首先，我们需要打开 OpenClaw 的 Web 管理界面。在终端运行：

openclaw dashboard

命令执行后，通常会自动在浏览器中打开本地管理页面。

2. 修改 RAW 配置

在 Web 界面的左侧菜单栏，依次点击：配置 → All Settings → RAW。

在这里，你会看到一个可以编辑的 Raw JSONS 输入框。将下面这段完整的 JSON 配置内容粘贴进去，记得把其中的 YOUR_API_KEY 替换成你从阿里云 Coding Plan 获取的专属 API Key。

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "YOUR_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": 204800, "maxTokens": 131072 },
          { "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": {
      "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": {}
      }
    }
  },
  "gateway": { "mode": "local" }
}

3. 保存并生效

粘贴并替换好 API Key 后：

1. 点击右上角的 Save 按钮。
2. 接着点击 Update 按钮，让新配置立即生效。

值得注意的是，出于安全考虑，保存后 API Key 在界面上会显示为 __OPENCLAW_REDACTED__ 这样的占位符，这完全正常，不影响实际的功能调用。

六、使用 OpenClaw

配置完成，现在可以尽情使用了。OpenClaw 提供了两种主要的使用界面。

Web UI 模式

如果你更喜欢在浏览器中操作，运行：

openclaw dashboard

TUI 模式

如果你是个终端爱好者，那么 TUI（文本用户界面）模式会带来极致的效率体验。运行：

openclaw tui

在 TUI 模式中，你可以方便地切换模型：

• 临时切换模型：直接在输入框中输入 /model qwen3-coder-next 这样的命令。
• 查看可用模型：输入 /model 命令，会列出所有已配置且可用的模型。

七、常见问题

1. 如何永久修改默认模型？

如果你希望每次启动都默认使用某个特定模型（比如专精代码的 qwen3-coder-next），需要修改配置文件。关键在于调整 agents.defaults.model.primary 这个字段：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/目标模型ID"
      }
    }
  }
}

2. 报错 HTTP 401: Incorrect API key provided.

遇到这个错误，说明 API Key 认证失败了。可以按以下顺序排查：

• 检查 API Key 是否复制正确、完整，前后有无多余空格。
• 确认你使用的确实是阿里云“Coding Plan”页面生成的专属 Key，而不是其他服务的 Key。
• 尝试删除本地缓存文件：找到 ~/.openclaw/agents/main/agent/models.json，移除其中 providers.bailian 的配置项，然后重启 OpenClaw 服务。

3. 已有渠道配置如何安全添加 Coding Plan？

如果你的 OpenClaw 已经配置了其他模型渠道，想新增 Coding Plan，切忌直接覆盖整个配置文件。正确做法是：

• 找到原有配置中的 models、agents、gateway 这几个核心字段。
• 将上面提供的 Coding Plan 配置内容，合并到对应的字段中，确保结构正确。
• 如果原配置没有这些字段，手动添加进去即可。

希望这份指南能帮助你顺利开启 OpenClaw 之旅。如果在实践过程中有任何新的发现或想法，随时可以交流探讨。