OpenClaw / Clawdbot 自定义中转站配置教程

什么是 OpenClaw?
OpenClaw 是一款开源的个人 AI 助理，支持本地或远程部署，并且是适用于任何操作系统的 AI 智能体网关。它支持 WhatsApp、Telegram、Discord、iMessage、飞书、QQ、钉钉等，直接运行在你常用的聊天软件里，发送消息，随时随地获取智能体响应。

参考 OpenClaw官方中文帮助文档

第一步：安装与基础初始化

请根据您的操作系统选择对应的安装方式。

脚本安装 🍎 MacOS / 🐧 Linux 用户

1 运行安装脚本
在终端中运行以下指令将自动安装 OpenClaw，然后继续下面第二步配置向导：

2 验证安装
验证 OpenClaw 是否安装成功：

Windows (PowerShell) 用户

运行安装脚本

注意：确保已经安装了 WSL2，在 PowerShell 中运行 WSL 进行以下安装。

在终端中运行以下指令将自动安装 OpenClaw：

验证 OpenClaw 是否安装成功

注意：在 Windows 原生环境下，如果提示 openclaw 不是命令，请统一使用 clawdbot。

初始化配置 OpenClaw

首先，启动交互式配置向导：

看到 I understand this is powerful and inherently risky. Continue?，请选择 Yes。

请按以下步骤操作：

1.我们直接选择 “快速开始”（QuickStart）

2.直接选择 “跳过”（Skip for now）

3.选择 “All providers”

4.选择 “Keep current”:

5.聊天工具也可以先选择 “跳过”（Skip for now）

6.配置 Skills，也可以先选择 “跳过”（Skip for now），用空格键勾选，回车键确认

7.推荐设置：建议把以下三个选项都选上，如下图所示

8.
恭喜您已经完成了 OpenClaw 的配置向导！

提示： OpenClaw 会自动使用默认浏览器打开 OpenClaw 的网关界面。如网关未启动，可使用以下命令启动

9.获取VIIIA API Key

进入网站 https://api.viaaai.com 进行注册并充值。
在“令牌管理”页面，复制您的 API Key。

建议新建令牌 -> 令牌分组选择：根据使用场景搭配不同分组可以节约成本。

第二步：修改主配置文件 `clawdbot.json`

2.1 打开路径：C:\Users\Administrator\.clawdbot\clawdbot.json
将 models 和 auth 部分修改为以下内容，以支持自定义中转站。

这是整个配置流程中最关键的一步。openclaw.json 文件负责定义模型列表、Provider 信息以及鉴权模式，配置正确与否直接决定多模型能否正常调用。
文件路径：

Windows：C:\Users\admin\.openclaw\openclaw.json
macOS：~/.openclaw/openclaw.json

2.2 配置文件结构说明
整个配置文件分为三个核心部分：

配置块作用agents.defaults定义默认使用的模型、并发数等运行参数
auth.profiles声明各 Provider 的鉴权方式（此处只声明类型，不填 Key）
models.providers定义各 Provider 的接口地址、模型列表和参数

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\Administrator\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.viaaai.com/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.viaaai.com",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.viaaai.com/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

api 字段不能混用：Claude 必须使用 anthropic-messages，Gemini 使用 google-generative-ai，其余模型使用 openai-completions，协议类型写错会导致请求格式不匹配。

baseUrl 末尾斜杠：Claude 的 baseUrl 不带 /v1，其他 Provider 需要带，这是由各自协议的路径规范决定的。

Windows 路径转义：workspace 字段在 Windows 下需要用双反斜杠 \\ 转义，macOS 直接用正斜杠即可。

第三步：配置鉴权文件 `auth-profiles.json`

打开路径：C:\Users\Administrator\.clawdbot\agents\main\agent\auth-profiles.json
在此处填入你从中转站获取的真实 API Key。

文件路径：

Windows：C:\Users\admin\.openclaw\agents\main\agent\auth-profiles.json
macOS：~/.openclaw/agents/main/agent/auth-profiles.json

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-your-unique-gpt-key-here"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-your-unique-claude-key-here"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-your-unique-google-key-here"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

API Key 可以从Viaaai的大模型中转服务获取复制对应模型名称ID。Viaaai 支持 GPT、Claude、Gemini、DeepSeek 等多个主流模型的统一接入，获取 Key 后按上述格式填入对应字段即可。

安全提示： auth-profiles.json 包含真实密钥，不要将其提交到 Git 仓库。
建议在 .gitignore 中添加 .openclaw/agents/ 路径。

第四步：检查并启动

4.1. 运行健康检查：

4.2. 启动 Gateway 服务(前台启动openclaw网关，macOS 通常不需要)：

4.3. 访问控制台：
打开浏览器访问 http://127.0.0.1:18789/，使用 clawdbot onboarding 结尾输出的 Token 登录即可开始调教你的 AI Agent。

4.4 补充常用的openclaw日常运维命令

openclaw dashboard 自动用 token 打开浏览器面板
openclaw onboard 重新运行初始化向导
openclaw doctor 健康检查与依赖检测
openclaw config get 查看当前配置
openclaw config set x y 修改配置项
openclaw hooks list 查看已安装 hooks
openclaw skills list 查看已经安装的技能
ollama list 查看已下载本地模型
ollama ps 查看本地模型运行状态
tail -f ~/.openclaw/logs/gateway.log 实时查看 Gateway 日志

OpenClaw Clawdbot 自定义中转站配置教程

OpenClaw / Clawdbot 自定义中转站配置教程#

第一步：安装与基础初始化#

脚本安装 🍎 MacOS / 🐧 Linux 用户#

Windows (PowerShell) 用户#

初始化配置 OpenClaw#

9.获取VIIIA API Key#

第二步：修改主配置文件 clawdbot.json#

第三步：配置鉴权文件 auth-profiles.json#

安全提示： auth-profiles.json 包含真实密钥，不要将其提交到 Git 仓库。#

第四步：检查并启动#