跳到主要内容

OpenClaw

OpenClaw 是一个可自托管的个人 AI Agent 平台，可以运行在你自己的设备上，连接消息渠道、调用本地工具，并通过自定义模型 provider profile 调用 XInfera。

安装 OpenClaw​

请根据 OpenClaw 官方说明完成安装。

安装完成后，确认命令可用：

openclaw --version

如果提示 command not found，请重启终端，并确认安装路径已经加入 PATH。

配置 XInfera Provider​

通过 provider 配置，让 OpenClaw agents、gateway、dashboard 和 TUI 共用同一套 XInfera 模型设置。

第 1 步：找到 OpenClaw 配置文件​

OpenClaw 的配置文件通常在：

~/.openclaw/openclaw.json

第 2 步：添加 XInfera provider​

使用 OpenClaw 的 OpenAI 风格 provider 类型添加自定义 provider：

{
  "providers": {
    "xinfera": {
      "baseURL": "https://api.xinfera.cn/v1",
      "apiKey": "sk-YOUR_API_KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "deepseek-v4-flash",
          "name": "deepseek-v4-flash"
        },
        {
          "id": "glm-5.2",
          "name": "glm-5.2"
        }
      ]
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "xinfera/deepseek-v4-flash"
      }
    }
  }
}

第 3 步：重启并验证 gateway​

修改 provider 配置后，重启 gateway：

openclaw gateway restart
openclaw doctor
openclaw gateway status

发送一个短测试提示词：

openclaw agent --agent main --message "Reply with one sentence confirming XInfera is connected."

如果 OpenClaw 返回模型响应，说明已经成功连接 XInfera。

常见问题​

1. Gateway 未运行

运行 openclaw gateway start，然后执行 openclaw gateway status。

2. Provider 配置没有生效

编辑配置后需要重启 gateway。同时检查 OpenClaw 当前版本要求的是 baseURL、baseUrl 还是 base_url。

3. 401 Unauthorized 或 billing 错误

检查 XInfera API Key、余额、有效期、配额，并确认 OpenClaw 读取的是你编辑的配置文件。

4. 404 Not Found 或模型不可用

OpenClaw 使用 OpenAI 风格 provider 模式时应填写 https://api.xinfera.cn/v1。确认所选模型能通过同一个 API 密钥在 /v1/models 中看到。

Contents