OpenClaw 配置教程

OpenClaw 是一个强大的 AI 编程代理工具，支持终端 TUI、Web Dashboard 和多种聊天平台集成。本教程将详细介绍如何安装和配置 OpenClaw 接入闪电API。

系统要求

• Node.js 22+（必需）
• Windows 用户：建议使用 WSL2 环境
• 网络：能够访问 GitHub 和 npm 仓库

1. 安装 OpenClaw

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

安装验证

安装完成后运行以下命令验证：

openclaw --version
openclaw doctor
openclaw status
openclaw dashboard

2. 配置文件位置

默认位置（推荐）

配置文件名固定为 openclaw.json，建议放在默认位置：

• Linux/macOS/WSL2: ~/.openclaw/openclaw.json
• Windows: %USERPROFILE%\.openclaw\openclaw.json

自定义位置

如需指定其他位置，使用环境变量：

# Linux/macOS
export OPENCLAW_CONFIG_PATH="/path/to/openclaw.json"

# Windows PowerShell
$env:OPENCLAW_CONFIG_PATH = "C:\path\to\openclaw.json"

3. 重要：必须使用 Responses 格式

关键配置：接入闪电API时，必须使用 openai-responses 格式：

{
  "api": "openai-responses"
}

4. 配置闪电API

基础配置示例

创建或编辑 ~/.openclaw/openclaw.json：

{
  "models": {
    "mode": "merge",
    "providers": {
      "flashapi": {
        "baseUrl": "https://ai.flashapi.top/v1",
        "apiKey": "你的闪电API密钥",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2"
          },
          {
            "id": "claude-sonnet-4-6", 
            "name": "Claude Sonnet 4.6"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "flashapi/gpt-5.2"
      }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "auth": {
      "mode": "token",
      "token": "your-secure-token"
    }
  }
}

完整配置示例

{
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "flashapi/gpt-5.2"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "compaction": {
        "mode": "safeguard"
      },
      "workspace": "~/.openclaw/workspace"
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "flashapi": {
        "baseUrl": "https://ai.flashapi.top/v1",
        "apiKey": "你的闪电API密钥",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "GPT-5.2",
            "contextWindow": 200000,
            "maxTokens": 32000
          },
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6", 
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "contextWindow": 1000000,
            "maxTokens": 32000
          }
        ]
      }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "mode": "token", 
      "token": "your-secure-token"
    }
  },
  "logging": {
    "level": "info",
    "consoleLevel": "debug",
    "consoleStyle": "pretty"
  }
}

配置说明

字段	说明
baseUrl	闪电API地址，固定为 https://ai.flashapi.top/v1
apiKey	你的闪电API密钥
api	必须设为 openai-responses
models	可用模型列表
primary	默认使用的模型，格式：提供商名/模型ID
gateway.port	Web控制台端口，默认18789
gateway.auth.token	访问令牌，建议设置强密码

5. 启动和验证

重启网关

openclaw gateway restart

验证配置

# 检查配置
openclaw doctor

# 进入TUI测试
openclaw tui

# 查看状态
openclaw status

访问Web控制台

# 获取控制台URL
openclaw dashboard

然后在浏览器中访问显示的地址。

6. 安装困难时的解决方案

如果OpenClaw安装或配置遇到问题，可以使用Codex来自动生成配置：

步骤

1. 启动Codex CLI：

   codex

2. 让AI生成配置：

   请把用户目录下.codex api 配置到openclaw中，注意是response格式。

3. 验证配置：

   openclaw doctor

7. 常见问题

配置文件不生效？

• 确认文件路径正确
• 检查JSON格式是否有效
• 使用 openclaw doctor 诊断

模型调用失败？

• 确认API密钥正确
• 检查 api 字段是否为 openai-responses
• 验证模型ID是否正确

网关启动失败？

• 检查端口是否被占用
• 确认Node.js版本 >= 22
• 查看日志：openclaw logs

权限问题？

• Linux/macOS: 确保有写入 ~/.openclaw/ 的权限
• Windows: 以管理员身份运行PowerShell

8. 高级功能

多模型配置

可以同时配置多个模型提供商：

{
  "models": {
    "providers": {
      "flashapi-gpt": {
        "baseUrl": "https://ai.flashapi.top/v1",
        "apiKey": "你的密钥",
        "api": "openai-responses",
        "models": [{"id": "gpt-5.2", "name": "GPT-5.2"}]
      },
      "flashapi-claude": {
        "baseUrl": "https://ai.flashapi.top/v1", 
        "apiKey": "你的密钥",
        "api": "openai-responses",
        "models": [{"id": "claude-sonnet-4-6", "name": "Claude Sonnet"}]
      }
    }
  }
}

Telegram Bot集成

在配置中添加Telegram支持：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot Token"
    }
  },
  "plugins": {
    "entries": {
      "telegram": {
        "enabled": true
      }
    }
  }
}

9. 下一步

• 查看API文档 - 了解支持的模型
• 获取帮助 - 遇到问题联系我们
• 官方文档 - OpenClaw官方文档