AICore DocsOpenClaw
OpenClaw 安装与中转站配置指南
OpenClaw 简介
OpenClaw 是一款开源 AI Agent 工具，可通过自定义网关接入第三方模型。本指南介绍如何在 AiCore API 中完成 OpenClaw 的安装与配置。
系统要求
- macOS、Linux 或 Windows
- Node.js 24（推荐）或 Node.js 22.14+
- 稳定网络连接
安装 OpenClaw
第一步：脚本安装（推荐）
第二步：验证安装
openclaw --version第三步：初始化 OpenClaw
首次安装后建议运行官方 onboarding，完成 Gateway 初始化并创建默认配置目录：
openclaw onboard --install-daemon
openclaw gateway status如果你已完成 onboarding，可直接进入下一步。后续 openclaw.json 配置会把默认模型切换到 AiCore API。
配置中转站 API
🔑
API KEY
在 api.xty.app 控制台的“API 令牌”页面创建令牌（以 sk- 开头）。
🔗
接口地址
https://api.xty.app/v1
打开配置目录
配置 openclaw.json
建议将令牌放在 ~/.openclaw/.env 中，避免直接写入 openclaw.json：
AICORE_API_KEY=sk-你的令牌然后编辑 ~/.openclaw/openclaw.json。必要时替换模型名称：
{
"gateway": {
"mode": "local"
},
"agents": {
"defaults": {
"model": {
"primary": "custom-proxy/gpt-4o"
},
"models": {
"custom-proxy/gpt-4o": {}
}
}
},
"models": {
"mode": "merge",
"providers": {
"custom-proxy": {
"baseUrl": "https://api.xty.app/v1",
"apiKey": "${AICORE_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "gpt-4o",
"name": "gpt-4o",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 32000
}
]
}
}
}
}baseUrl建议使用带/v1的地址：https://api.xty.app/v1primary、models的模型名需要保持一致- 示例中的
gpt-4o仅用于演示，可替换为你在 xty 可用的模型 ID - 如果你不使用
.env，也可以把apiKey改为真实令牌，但不要把包含令牌的配置文件提交到代码仓库
启动或重启 OpenClaw
openclaw gateway restart
openclaw gateway status如果没有安装守护进程，也可以在终端前台运行：
openclaw gateway打开 Dashboard
openclaw dashboard控制界面预览
若未自动打开浏览器，请先确认 openclaw gateway 已正常运行，再访问终端输出的 Dashboard 地址。