OpenClaw 使用指南

本文介绍如何安装 OpenClaw，并将其接入模力方舟的模型。以下命令适用于 Windows、macOS、Linux；请根据所用系统选择对应方式。

安装 OpenClaw

OpenClaw 是在终端中运行的 CLI 工具，也提供 Windows 和 macOS 桌面伴侣应用。官方推荐使用安装脚本：它会检测系统、在需要时安装 Node.js、安装 OpenClaw，并自动进入配置流程。

Windows
macOS / Linux
npm
桌面应用

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

上述命令会自动进入配置流程。如只想完成安装、稍后再配置，请运行：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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

上述命令会自动进入配置流程。如只想完成安装、稍后再配置，请运行：

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

如果你已自行管理 Node.js，可使用 npm 安装：

npm install -g openclaw@latest

OpenClaw 支持 Node.js 24.16 及以上版本，推荐使用 Node.js 26。

请从 Node.js 官方下载页面下载并安装符合版本要求的版本。

Windows 用户也可以下载并安装 Windows Hub，在图形界面中完成设置、查看托盘状态、聊天或连接已有 Gateway。首次启动时可创建本地 Gateway。

macOS 用户可从 OpenClaw GitHub Releases 下载 OpenClaw-<version>.dmg 并安装菜单栏应用。

自动配置选项

使用官方安装脚本后，OpenClaw 会自动进入配置流程。使用方向键选择，按 Enter 确认；各配置项的建议选择如下：

How should I set things up?：选择 Ask first — check with me before looking around。

May I look around to find your AI access?：选择 Yes, take a look。

Model/auth provider：选择 Skip for now，稍后配置模力方舟模型。

验证安装

安装完成后，重新打开终端并运行：

openclaw --version

如能输出版本号，说明 OpenClaw 已安装成功。

配置模力方舟模型

完成自动配置后，可通过配置文件或 Web UI 添加模力方舟的 Provider 和默认模型。

配置文件方式
Web UI 方式
CC Switch 自动配置

配置文件位置

macOS / Linux / WSL：~/.openclaw/openclaw.json
Windows：%USERPROFILE%\.openclaw\openclaw.json

如果文件中已有 meta，请将下方的 models 和 agents 放在与 meta 同一级，并保留其他已有字段。

添加模力方舟 Provider

以下示例使用模力方舟的 Kimi-K2.5 模型。将“模力方舟访问令牌”替换为实际访问令牌：

{
  "models": {
    "mode": "merge",
    "providers": {
      "gitee-ai": {
        "baseUrl": "https://ai.gitee.com/v1",
        "apiKey": "模力方舟访问令牌",
        "api": "openai-completions",
        "models": [
          {
            "id": "Kimi-K2.5",
            "name": "Kimi-K2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "gitee-ai/Kimi-K2.5"
      }
    }
  }
}

重启并验证

保存配置后，运行以下命令重启 Gateway：

openclaw gateway restart

然后进入终端界面并查看模型列表：

openclaw tui

在 OpenClaw TUI 中输入：

/model

选择 gitee-ai/Kimi-K2.5 后发送一条测试消息；如能正常响应，说明配置已生效。

启动 Web UI

在 OpenClaw 所在机器的终端运行：

openclaw dashboard

该命令会打开浏览器；如果运行环境没有图形界面，会在终端输出 Web UI 地址。也可直接访问本地 Gateway 的 127.0.0.1:18789 或 localhost:18789。

在 Web UI 中配置模型

进入 Web UI 后，在侧边栏依次打开 系统（System）→ 高级（Advanced）。在文件编辑器中，将编辑模式从 表单（Form） 切换为 原始配置（Raw）；再将下方的 models 和 agents 两段内容添加到现有配置中，与 meta 同级。将和“模力方舟访问令牌”替换为实际值。

{
  "models": {
    "mode": "merge",
    "providers": {
      "gitee-ai": {
        "baseUrl": "https://ai.gitee.com/v1",
        "apiKey": "模力方舟访问令牌",
        "api": "openai-completions",
        "models": [
          {
            "id": "Kimi-K2.5",
            "name": "Kimi-K2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "gitee-ai/Kimi-K2.5"
      }
    }
  }
}

保存配置后，按 Web UI 的提示重启 Gateway。重启完成后，在模型列表中选择 gitee-ai/Kimi-K2.5，发送一条测试消息；如能正常响应，说明配置已生效。

警告

Web UI 是管理界面，建议仅通过本机地址、Tailscale 或 SSH 隧道访问，不要直接暴露到公网。

开始使用 OpenClaw

完成配置后，可通过终端界面或本地 Web UI 开始使用。

终端界面

openclaw

配置有效时，该命令会直接进入终端 TUI。输入需求并发送即可开始对话；如需切换模型，可通过 /model 操作。

本地 Web UI

openclaw dashboard

该命令会在浏览器中打开本地 Control UI；如未自动打开，请使用终端输出的链接访问。

安装 OpenClaw​

自动配置选项​

验证安装​

配置模力方舟模型​

配置文件位置​

添加模力方舟 Provider​

重启并验证​

启动 Web UI​

在 Web UI 中配置模型​

开始使用 OpenClaw​

终端界面​

本地 Web UI​