配置指南

快速开始使用 fu5.org API 服务,支持 OpenAI 兼容接口

OpenClaw 专业配置指南

为开发者提供准确、专业的 fu5.org 集成配置方案

🔧

配置类型

OpenAI 兼容接口配置

API 端点

https://api.fu5.org/v1

🔑

认证方式

API Key (Bearer Token)

🤖

支持模型

5+ 个主流模型

1 获取 API 密钥

仪表盘页面 登录后获取你的 fu5.org API 密钥。

📝

API 密钥格式

fu5.org 的 API 密钥格式为:fu5-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

请妥善保管你的 API 密钥,不要泄露给他人。

2 OpenClaw 配置文件

编辑 OpenClaw 主配置文件:~/.openclaw/openclaw.json

openclaw.json - 完整配置示例
{
  "models": {
    "mode": "merge",
    "providers": {
      "fu5": {
        "baseUrl": "https://api.fu5.org/v1",
        "apiKey": "fu5-你的API密钥",
        "auth": "api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-ai/deepseek-v3.2",
            "name": "DeepSeek V3.2 (via fu5)",
            "api": "openai-completions"
          },
          {
            "id": "minimaxai/minimax-m2.5",
            "name": "MiniMax M2.5 (via fu5)",
            "api": "openai-completions"
          },
          {
            "id": "z-ai/glm4.7",
            "name": "GLM4.7 (via fu5)",
            "api": "openai-completions"
          },
          {
            "id": "z-ai/glm5",
            "name": "GLM5 (via fu5)",
            "api": "openai-completions"
          },
          {
            "id": "google/gemma-4-31b-it",
            "name": "gemma-4-31b-it",
            "api": "openai-completions"
          }
        ]
      }
    }
  }
}
💡

配置说明

  • mode: "merge" - 将 fu5 提供商的模型合并到现有模型列表中
  • baseUrl - fu5.org 的 API 端点地址
  • apiKey - 替换为你的实际 API 密钥
  • auth: "api-key" - 使用 API Key 认证方式
  • api: "openai-completions" - 使用 OpenAI 兼容接口

3 可用模型

fu5.org 当前支持的 AI 模型:

模型 ID 显示名称 提供商 特点
deepseek-ai/deepseek-v3.2 DeepSeek V3.2 (via fu5) DeepSeek 代码生成、数学推理
minimaxai/minimax-m2.5 MiniMax M2.5 (via fu5) MiniMax 中文对话、创意写作
z-ai/glm4.7 GLM4.7 (via fu5) 智谱AI 中文理解、快速响应
z-ai/glm5 GLM5 (via fu5) 智谱AI 最新版本、企业级
google/gemma-4-31b-it gemma-4-31b-it Google 轻量级、多语言
🔍

查看完整模型列表

访问 模型列表页面 查看所有可用模型及其详细信息。

4 验证配置

配置完成后,验证 OpenClaw 是否正常工作:

终端命令
# 1. 重启 OpenClaw 服务
openclaw restart

# 2. 检查服务状态
openclaw status

# 3. 查看可用模型列表
openclaw models list

# 4. 测试模型响应(可选)
openclaw chat --model "deepseek-ai/deepseek-v3.2" --message "Hello"

5 故障排除

❌ 连接失败

可能原因: API 密钥错误或网络问题

解决方案: 检查 API 密钥格式,确保网络连接正常

⚠️ 模型不可用

可能原因: 配置文件格式错误

解决方案: 检查 JSON 格式,确保没有语法错误

🔧 服务未启动

可能原因: OpenClaw 服务未运行

解决方案: 运行 openclaw start 启动服务

📄 配置文件不存在

可能原因: 配置文件路径错误

解决方案: 确认路径为 ~/.openclaw/openclaw.json