OpenClaw 安装与配置教程（Windows）

青萍叙事2026-03-09

⚠️ 安全提示

本文包含命令行与本地服务配置操作。请仅在你信任的电脑与网络环境中执行，并确认你理解脚本安装的风险。

适用范围

操作系统：Windows 10/11
目标：安装 OpenClaw，并通过 Web UI 配置一个自定义模型 Provider（示例：百炼 DashScope 兼容 OpenAI Completions 接口）

准备工作

准备 API Key
- 你需要一个可用的 API Key。
- 后续会把它填到配置中的 apiKey 字段（把 YOUR_API_KEY 替换为真实值）。
确保 PowerShell 可用
- 建议使用 Windows 自带 PowerShell。
- 需要以管理员身份运行，避免权限问题。

第 1 步：以管理员身份打开 PowerShell

在开始菜单搜索 PowerShell
右键选择 以管理员身份运行

第 2 步：允许执行脚本

在 PowerShell 中执行：

1	Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

说明：这会允许当前用户运行本地脚本与签名脚本。如果你对策略不熟悉，建议执行完成后记录原值，必要时再改回去。

第 3 步：运行 OpenClaw 安装脚本

执行安装命令：

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

如果网络环境访问受限，可考虑使用代理或更换网络后再试。
如果安装过程报错，优先复制完整错误信息排查。

第 4 步：完成初始化向导（TUI）

安装完成后通常会进入初始化配置流程。下面是推荐选择（并补充了说明）：

配置项	推荐选择
I understand this is powerful and inherently risky. Continue?	选择 Yes（确认理解风险后继续）
Onboarding mode	选择 QuickStart（先跑通流程）
Model/auth provider	选择 Skip for now（后续在 Web UI 配置）
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

第 5 步：启动 Web UI（Dashboard）

在 PowerShell 或终端执行：

1	openclaw dashboard

然后在浏览器打开：

http://127.0.0.1:18789

如果打不开：

确认命令是否在运行（不要关闭终端窗口）。
检查本机安全软件或防火墙是否拦截了端口访问。

第 6 步：在 Web UI 中打开 RAW 配置

在左侧菜单进入：

配置 > All Settings > RAW

在 Raw JSONS 输入框中：

全选当前内容
粘贴下方配置（会覆盖原内容）

第 7 步：粘贴配置并修改 API Key

把下面 JSON 中的 YOUR_API_KEY 替换为你的真实 Key：

说明：从 OpenClaw 3.2 版本开始，如果要开启全量功能，需要额外把 tools.profile 设置为 full（在 RAW 配置里添加或修改该字段）。另外，为了让不同 agents 之间可以互相通信，还需要补充 sessions.visibility 为 all。

{
  "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"
  }
}