> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw 手动安装-支持智能路由

> 手动安装和配置 OpenClaw Gateway，支持 EvoLink Auto 智能路由

## 概述

OpenClaw 是一个开源的 AI 智能体 Gateway 网关,充当聊天应用与 AI 智能体之间的桥梁。通过一个中心化的 Gateway 进程,它可以将 Telegram、WhatsApp、Discord、飞书等聊天平台连接到 AI 编程智能体。

本文档介绍如何手动安装 OpenClaw 并配置 **EvoLink API** 作为模型提供商。完成本文档后,你可以继续配置具体的聊天渠道(如 Telegram 或飞书)。

**本文将介绍:**

* 安装并配置 OpenClaw Gateway
* 将 EvoLink API 配置为自定义模型提供商
* 验证安装是否成功

## 系统环境检查(可选)

在开始安装之前,建议先运行环境检查工具,确保你的系统满足 OpenClaw 的运行要求。

### 下载检查工具

从 [GitHub Releases](https://github.com/suuuuuu-1/openclaw-env-checker/releases) 下载对应平台的检查工具:

| 平台                    | 文件名                            |
| --------------------- | ------------------------------ |
| Windows               | `openclaw-checker-win-x64.exe` |
| macOS (Intel)         | `openclaw-checker-macos-x64`   |
| macOS (Apple Silicon) | `openclaw-checker-macos-arm64` |
| Linux                 | `openclaw-checker-linux-x64`   |

### 检查项目

工具会自动检查以下条件:

* ✅ Node.js 版本(需要 >= 22.12.0)
* ✅ npm 可用
* ✅ Git 可用
* ✅ 网络连通性(github.com、npmjs.org、evolink.ai)

<img src="https://mintcdn.com/muyutechnology/nIFIx0gxdF53THw8/images/OpenClaw-Checker/check-success.png?fit=max&auto=format&n=nIFIx0gxdF53THw8&q=85&s=46f1fdbec3263845e35158b104fa5091" alt="检查成功示例" width="1778" height="1742" data-path="images/OpenClaw-Checker/check-success.png" />

如果检查未通过,工具会给出具体的修复建议。

## 使用前准备

在开始配置之前,请确保已完成以下准备工作:

### 1. 安装 Node.js

OpenClaw 通过 npm 安装,需要先安装 Node.js 22 或更高版本。

<Tabs>
  <Tab title="Windows">
    访问 [Node.js 官网](https://nodejs.org/zh-cn/download),下载 Windows 安装包(.msi 文件),双击运行安装程序。

    安装完成后,打开 PowerShell 验证:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      建议以管理员身份运行 PowerShell,避免后续安装时出现权限问题。
    </Note>
  </Tab>

  <Tab title="macOS">
    **方式 1: 使用安装包**

    访问 [Node.js 官网](https://nodejs.org/zh-cn/download),下载 macOS 安装包(.pkg 文件),双击运行安装程序。

    **方式 2: 使用 Homebrew**

    ```bash theme={null}
    brew install node
    ```

    安装完成后,打开终端验证:

    ```bash theme={null}
    node --version
    npm --version
    ```

    <Note>
      如果后续安装时遇到权限问题,可能需要在命令前加 `sudo`。
    </Note>
  </Tab>
</Tabs>

### 2. 获取 EvoLink API Key

* 登录 [EvoLink 控制台](https://evolink.ai/dashboard)
* 在控制台中找到 API Keys,点击"创建新Key"按钮,然后复制生成的 Key
* API Key 通常以 `sk-` 开头,请妥善保存

## 第一步:安装 OpenClaw

在终端中执行:

```bash theme={null}
npm install -g openclaw@latest
```

安装完成后验证:

```bash theme={null}
openclaw --version
```

## 第二步:初始化引导

运行新手引导命令,OpenClaw 会引导你完成初始配置并安装后台守护服务:

```bash theme={null}
openclaw onboard --install-daemon
```

### 1. 确认安装

系统会提示安装风险说明,确认同意后继续:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=fce0ba49fe04129dc943e6f63353595e" alt="确认安装" width="1488" height="1420" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011629_241.png" />

### 2. 选择安装模式

系统会提示选择安装模式,选择 **Quickstart** 即可:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=24fbf84b590649d1fc1d515d2ee50609" alt="选择 Quickstart" width="1738" height="1540" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011705_241.png" />

### 3. 选择供应商

系统会提示选择模型供应商,这里选择 **跳过(Skip)**,后续我们会手动配置 EvoLink 作为自定义供应商:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=a4f74b3bb72312ba426ea37179232576" alt="跳过供应商选择" width="1398" height="1272" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011742_033.png" />

### 4. 选择模型

系统会提示选择要启用的模型,选择 **All(全部)** 即可:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=701f58ca7164b7830cef3bfb713d911b" alt="选择所有模型" width="1380" height="1528" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011808_857.png" />

### 5. 选择默认模型

系统会提示选择默认模型,选择 **Keep current(保持当前)** 即可:

<img src="https://mintcdn.com/muyutechnology/9zwrwFbHVtE0nZ-d/images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png?fit=max&auto=format&n=9zwrwFbHVtE0nZ-d&q=85&s=5ded0a9c44fd991865dbe84195862563" alt="保持当前模型" width="1334" height="1792" data-path="images/OpenClaw-Telegram/ScreenShot_2026-02-08_011825_375.png" />

### 6. 选择渠道

系统会提示选择要配置的聊天渠道。这里建议选择 **Skip for now(暂时跳过)**,以后可以随时添加渠道:

<img src="https://mintcdn.com/muyutechnology/NlmbcWype-ERs65V/images/OpenClaw-Telegram/%E9%80%89%E6%8B%A9%E6%B8%A0%E9%81%93.png?fit=max&auto=format&n=NlmbcWype-ERs65V&q=85&s=15c688d8a70b5f8ae165dd2cd86882c7" alt="选择渠道" width="1328" height="700" data-path="images/OpenClaw-Telegram/选择渠道.png" />

### 7. 配置 Skills

系统会提示是否配置 Skills。建议选择 **No**,以后可以随时添加:

<img src="https://mintcdn.com/muyutechnology/NlmbcWype-ERs65V/images/OpenClaw-Telegram/%E9%85%8D%E7%BD%AESkills.png?fit=max&auto=format&n=NlmbcWype-ERs65V&q=85&s=5edf42414955f53d15cee1be85331183" alt="配置 Skills" width="672" height="355" data-path="images/OpenClaw-Telegram/配置Skills.png" />

### 8. 启用 Hooks

系统会提示是否启用 Hooks。建议选择 **session-memory**:

<img src="https://mintcdn.com/muyutechnology/JJmr3OHsJ7C2UIEk/images/OpenClaw-Telegram/%E5%90%AF%E7%94%A8Hooks.png?fit=max&auto=format&n=JJmr3OHsJ7C2UIEk&q=85&s=91d5235d050ce3ef829d16de768237a4" alt="启用 Hooks" width="1227" height="459" data-path="images/OpenClaw-Telegram/启用Hooks.png" />

### 9. 重启网关服务

系统会提示网关服务已安装，选择 **Restart(重启)**:

<img src="https://mintcdn.com/muyutechnology/NlmbcWype-ERs65V/images/OpenClaw-Telegram/%E9%87%8D%E5%90%AF%E7%BD%91%E5%85%B3.png?fit=max&auto=format&n=NlmbcWype-ERs65V&q=85&s=42712c7e9dbe454441e005d2275e8d3d" alt="重启网关" width="1129" height="327" data-path="images/OpenClaw-Telegram/重启网关.png" />

### 10. 启动机器人

系统会提示如何启动机器人。建议选择 **Do this later(稍后处理)**:

<img src="https://mintcdn.com/muyutechnology/JJmr3OHsJ7C2UIEk/images/OpenClaw-Telegram/%E5%90%AF%E5%8A%A8%E6%9C%BA%E5%99%A8%E4%BA%BA.png?fit=max&auto=format&n=JJmr3OHsJ7C2UIEk&q=85&s=c7cd5c913d22a3ac5a7985055d6d60dd" alt="启动机器人" width="1325" height="534" data-path="images/OpenClaw-Telegram/启动机器人.png" />

## 第三步:配置 EvoLink API 与模型切换

### 1. 找到两个配置文件（重点）

OpenClaw 模型配置通常涉及两个文件:

<Tabs>
  <Tab title="Windows">
    * `openclaw.json`: `%USERPROFILE%\\.openclaw\\openclaw.json`
    * `models.json`: `%USERPROFILE%\\.openclaw\\agents\\main\\agent\\models.json`
  </Tab>

  <Tab title="macOS">
    * `openclaw.json`: `~/.openclaw/openclaw.json`
    * `models.json`: `~/.openclaw/agents/main/agent/models.json`

    可直接打开:

    ```bash theme={null}
    open ~/.openclaw/openclaw.json
    open ~/.openclaw/agents/main/agent/models.json
    ```
  </Tab>
</Tabs>

<Warning>
  如果 `models.json` 中某个 provider 的 `apiKey` / `baseUrl` 非空,它会覆盖 `openclaw.json` 中同名 provider 的对应值。建议两边保持一致。
</Warning>

### 2. 配置模型提供商

建议在 `openclaw.json` 中配置以下 providers（并同步到 `models.json`）:

```json theme={null}
"models": {
  "providers": {
    "evolink-anthropic": {
      "api": "anthropic-messages",
      "baseUrl": "https://direct.evolink.ai",
      "apiKey": "你的EvoLink API Key",
      "models": [
        { "id": "evolink/auto", "name": "EvoLink Auto" },
        { "id": "claude-fable-5", "name": "Claude Fable 5" },
        { "id": "claude-opus-4-8", "name": "Claude Opus 4.8" },
        { "id": "claude-opus-4-7", "name": "Claude Opus 4.7" },
        { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
        { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" },
        { "id": "claude-opus-4-5-20251101", "name": "Claude Opus 4.5" },
        { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" },
        { "id": "claude-haiku-4-5-20251001", "name": "Claude Haiku 4.5" }
      ]
    },
    "evolink-google": {
      "api": "google-generative-ai",
      "baseUrl": "https://direct.evolink.ai/v1beta",
      "apiKey": "你的EvoLink API Key",
      "models": [
        { "id": "evolink/auto", "name": "EvoLink Auto" },
        { "id": "gemini-3.1-flash-lite-preview", "name": "Gemini 3.1 Flash Lite" },
        { "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash" }
      ]
    },
    "evolink-openai": {
      "api": "openai-completions",
      "baseUrl": "https://direct.evolink.ai/v1",
      "apiKey": "你的EvoLink API Key",
      "models": [
        { "id": "gpt-5.4", "name": "GPT-5.4" },
        { "id": "gpt-5.2", "name": "GPT-5.2" },
        { "id": "gpt-5.1", "name": "GPT-5.1" },
        { "id": "gpt-5.1-chat", "name": "GPT-5.1 Chat" },
        { "id": "gpt-5.1-thinking", "name": "GPT-5.1 Thinking" },
        { "id": "gemini-2.5-pro", "name": "Gemini 2.5 Pro (OpenAI SDK)" },
        { "id": "gemini-2.5-flash", "name": "Gemini 2.5 Flash (OpenAI SDK)" },
        { "id": "gemini-3-pro-preview", "name": "Gemini 3.0 Pro (OpenAI SDK)" },
        { "id": "gemini-3-flash-preview", "name": "Gemini 3.0 Flash (OpenAI SDK)" },
        { "id": "doubao-seed-2.0-pro", "name": "Doubao Seed 2.0 Pro" },
        { "id": "doubao-seed-2.0-lite", "name": "Doubao Seed 2.0 Lite" },
        { "id": "doubao-seed-2.0-mini", "name": "Doubao Seed 2.0 Mini" },
        { "id": "doubao-seed-2.0-code", "name": "Doubao Seed 2.0 Code" },
        { "id": "kimi-k2-thinking", "name": "Kimi K2 Thinking" },
        { "id": "kimi-k2-thinking-turbo", "name": "Kimi K2 Thinking Turbo" }
      ]
    }
  }
}
```

<Note>
  以上模型 ID 为示例。请以你的 EvoLink 账户实际开通模型为准。
</Note>

<Warning>
  Gemini 场景下 `evolink-google.baseUrl` 必须带 `/v1beta`，即 `https://direct.evolink.ai/v1beta`。若缺少该后缀,常见报错为 `Forbidden (403)`。
</Warning>

### 3. 配置默认模型（支持快速切换）

在 `agents.defaults` 中设置默认模型。推荐使用智能路由 `evolink/auto`，系统会根据请求自动选择合适的模型：

```json theme={null}
"agents": {
  "defaults": {
    "model": {
      "primary": "evolink-anthropic/evolink/auto"
    }
  }
}
```

<Tip>
  **智能路由 (EvoLink Auto)**：使用 `evolink/auto` 作为模型 ID，系统会根据请求的复杂度、长度和类型，自动在模型池中选择合适的模型进行处理。无需手动切换，适合大多数通用场景。详见 [EvoLink Auto 文档](/cn/api-manual/language-series/evolink-auto/evolink-auto-quickstart)。
</Tip>

如需指定特定模型，也可以手动切换：

* 智能路由: `evolink-anthropic/evolink/auto`（推荐）
* Claude: `evolink-anthropic/claude-opus-4-6`
* GPT: `evolink-openai/gpt-5.2`
* Gemini: `evolink-google/gemini-3.1-pro-preview`
* Doubao: `evolink-openai/doubao-seed-2.0-mini`

### 4. 快速切换到 EvoLink 模型（推荐）

完成 provider 配置后，后续切换模型建议直接用 CLI 命令，不必反复手改 JSON:

```bash theme={null}
# 查看已配置的 EvoLink OpenAI 兼容模型
openclaw models list --provider evolink-openai --plain

# 切换默认模型（示例：gpt-5.4）
openclaw models set evolink-openai/gpt-5.4

# 查看当前生效模型
openclaw models status --plain
```

<Note>
  如果 `models list --provider evolink-openai` 看不到你预期的模型，请先检查 `openclaw.json` 与 `models.json` 两处是否都已配置对应 provider。
</Note>

### 5. 重启并验证

配置完成后重启网关:

```bash theme={null}
openclaw gateway restart
```

检查状态:

```bash theme={null}
openclaw gateway status
```

发送一条测试消息验证模型可用:

```bash theme={null}
openclaw agent --agent main -m "hi" --json
```

## 常用命令

| 命令                         | 描述       |
| -------------------------- | -------- |
| `openclaw gateway status`  | 检查网关运行状态 |
| `openclaw gateway restart` | 重启网关服务   |
| `openclaw gateway stop`    | 停止网关服务   |
| `openclaw gateway start`   | 启动网关服务   |
| `openclaw logs --follow`   | 实时查看网关日志 |
| `openclaw plugins list`    | 查看已安装的插件 |

## 故障排除

| 问题                          | 排查方法                                                                                               |
| --------------------------- | -------------------------------------------------------------------------------------------------- |
| npm 安装失败                    | Windows: 以管理员身份运行 PowerShell; macOS: 在命令前加 `sudo`                                                  |
| 找不到配置文件                     | 确认 onboard 流程已完成,检查 `~/.openclaw/` 目录是否存在                                                          |
| 网关启动失败                      | 检查端口是否被占用,使用 `openclaw gateway status` 查看详细错误                                                      |
| API Key 无效                  | 确认 API Key 正确复制,检查是否有多余空格或引号                                                                       |
| 模型配置不生效                     | 同时检查 `openclaw.json` 与 `models.json` 是否一致（`models.json` 可能覆盖）                                      |
| Gemini 返回 `Forbidden (403)` | 检查 `models.providers.evolink-google.baseUrl` 是否为 `https://direct.evolink.ai/v1beta`（必须带 `/v1beta`） |
| 切换模型后仍使用旧模型                 | 执行 `openclaw models status --plain` 确认当前模型,必要时 `openclaw gateway restart`                          |

## 下一步

OpenClaw 安装和 EvoLink API 配置已完成。接下来你可以:

* **配置 Telegram 渠道**: 参考 [OpenClaw + Telegram](/cn/integration-guide/openclaw-telegram) 文档
* **配置飞书渠道**: 参考 [OpenClaw + 飞书](/cn/integration-guide/openclaw-feishu) 文档
* **使用自动安装工具**: 参考 [OpenClaw 自动安装](/cn/integration-guide/openclaw-auto) 文档