OpenClaw 安装与配置_openclaw重新配置

首页

OpenClaw 安装与配置

热心网友

转载

2026-04-01

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 后：

点击右上角的 Save 按钮。
接着点击 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 之旅。如果在实践过程中有任何新的发现或想法，随时可以交流探讨。

来源:https://blog.csdn.net/weimeilayer/article/details/158619696?ops_request_misc=elastic_search_misc&request_id=3408c9629226947a81126d714010d25d&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~ElasticSearch~search_v2-

免责声明：游乐网为非赢利性网站，所展示的游戏/软件/文章内容均来自于互联网或第三方用户上传分享，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系youleyoucom@outlook.com。

上一篇：DeepSeek再度崩溃一小时，距大宕机恢复仅隔一天下一篇：OpenClaw隔夜失忆解决方案