本教程教你如何配置 OpenClaw 使用自定义 API 中转站。
适用系统： Windows / macOS / Linux
预计时间： 10 分钟
1. 安装 OpenClaw
注意：Windows 用户如果提示 不是命令，可以使用 代替。
2. 执行初始化
按提示完成基础设置。
⚠️ 重要提示
OpenClaw 不支持通过环境变量 来设置自定义 API 端点。必须通过配置文件的 来配置。
配置文件位置
注意： 配置文件可能在 或 目录，取决于你的安装方式。
步骤 1：备份配置文件（可选）
macOS/Linux:
Windows:
步骤 2：编辑配置文件
macOS/Linux:
Windows:
步骤 3：复制以下配置内容
关键配置说明
🔑 重要：将所有 替换为你的真实 API Key！
配置文件位置
编辑鉴权文件
macOS/Linux:
Windows:
复制以下内容
🔑 重要：将所有 替换为你的真实 API Key！
1. 运行健康检查（可选）
2. 启动 Gateway 服务
预期输出：
保持这个窗口打开！
3. 启动 TUI（新窗口）
打开新的终端窗口，运行：
4. 测试对话
在 TUI 中输入：
如果 AI 正常回复，配置成功！🎉
5. 访问 Web 控制台（可选）
打开浏览器访问：
使用 结尾输出的 Token 登录。
openclaw
问题 1: (no output) – 没有响应
原因： API Key 未配置或配置错误
解决步骤：
- 检查 中的 字段
- 检查 中的 字段
- 确认两个文件中的 API Key 一致
- 确认没有拼写错误和多余空格
- 重启 Gateway 和 TUI
问题 2: fetch failed – 请求失败
原因： 网络连接问题或 API 地址错误
解决步骤：
- 检查 是否正确：
- GPT:
- Claude:
- Gemini:
- 测试网络连接：
- 查看 Gateway 日志查找错误
问题 3: 端口被占用
错误信息：
Windows 解决：
macOS/Linux 解决：
问题 4: 找不到配置文件
解决： 确保已经运行过 初始化
如果配置目录不存在，手动创建：
Windows:
macOS/Linux:
Windows
macOS/Linux
提示： 使用以下命令查找配置文件位置：
macOS/Linux:
Windows (PowerShell):
- ✅ API Key 需要配置在两个地方：
- 的
- 的
- ✅ 两个文件中的 API Key 必须一致
- ✅ baseUrl 必须正确：
- GPT 需要 后缀
- Claude 不需要后缀
- Gemini 需要 后缀
- ✅ 不支持环境变量配置
- ✅ 配置完成后需要重启 Gateway
配置步骤：
- ✅ 安装 OpenClaw
- ✅ 修改 （包含 apiKey）
- ✅ 修改 （包含 key）
- ✅ 启动 Gateway 和 TUI
- ✅ 开始使用
更新日期： 2026-02-10
版本： v2.0
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/257545.html原文链接：https://javaforall.net
