OpenClaw 配置指南#

OpenClaw 是一个开源的自托管 AI 助手/代理，由 Peter Steinberger 创建。它通过 Gateway 架构连接各种消息平台（WhatsApp、Telegram、Slack、Discord 等），支持 Anthropic、OpenAI、Google 等多种模型提供商。本指南将帮助你配置 OpenClaw 以使用 Du's API。

前置要求#

• 已安装 OpenClaw（参见安装教程）
• 拥有 Du's API 的 API Key

配置方式#

OpenClaw 支持两种配置方式：

1. 配置文件（推荐）
2. 环境变量

方式一：配置文件（推荐）#

OpenClaw 的配置涉及两个层级：

• 全局配置：~/.openclaw/openclaw.json — 定义提供商（models.providers）和默认模型
• Agent 级别配置：~/.openclaw/agents/<agentId>/agent/models.json — Agent 级别的模型覆盖

API Key 不建议以明文存储在 openclaw.json 中。推荐通过环境变量设置 API Key，在配置文件中使用 ${ENV_VAR} 语法引用：

{
  apiKey: "${DUSAPI_API_KEY}"
}

API Key 的解析优先级为：Agent models.json > openclaw.json 中的 apiKey > 环境变量。

配置自定义提供商#

在 ~/.openclaw/openclaw.json 的 models.providers 中添加 Du's API 作为自定义提供商：

{
  models: {
    providers: {
      "dusapi-openai": {
        baseUrl: "https://api.dusapi.com/v1",
        apiKey: "${DUSAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.4",
            name: "GPT-5.4",
            reasoning: true,
            input: ["text"],
            contextWindow: 1000000,
            maxTokens: 32000
          },
          {
            id: "gpt-5.4-mini",
            name: "GPT-5.4 Mini",
            reasoning: true,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 16000
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "dusapi-openai/gpt-5.4"
      },
      models: {
        "dusapi-openai/gpt-5.4": { alias: "GPT-5.4" },
        "dusapi-openai/gpt-5.4-mini": { alias: "GPT-5.4-Mini" }
      }
    }
  }
}

Agent 级别覆盖#

如果需要为特定 Agent 覆盖模型配置，可以编辑 ~/.openclaw/agents/<agentId>/agent/models.json。该文件中非空的 baseUrl 和 apiKey 会覆盖全局配置中的同名值。

应用配置#

修改配置文件后，OpenClaw Gateway 支持热重载，大部分设置会自动生效。你也可以通过 CLI 修改：

openclaw config set models.providers.dusapi-openai.baseUrl "https://api.dusapi.com/v1"

方式二：环境变量配置#

对于内置的 OpenAI 和 Anthropic 提供商，OpenClaw 可以直接通过环境变量配置，无需在 openclaw.json 中定义 provider。

export OPENAI_BASE_URL="https://api.dusapi.com/v1"
export OPENAI_API_KEY="your-api-key-here"

export ANTHROPIC_BASE_URL="https://api.dusapi.com"
export ANTHROPIC_API_KEY="your-api-key-here"

支持的模型#

OpenAI 模型#

• gpt-5.4 - GPT-5.4（旗舰模型，支持 1M context）
• gpt-5.4-mini - GPT-5.4 Mini（轻量快速）
• gpt-5.4-nano - GPT-5.4 Nano（最小最便宜）
• gpt-5.3-codex - GPT-5.3 Codex（代码专用）
• gpt-5.2 - GPT-5.2

Anthropic 模型#

• claude-opus-4-6 - Claude 4.6 Opus
• claude-sonnet-4-6 - Claude 4.6 Sonnet

验证配置#

配置完成后，使用以下命令验证：

# 检查配置是否正确
openclaw doctor

# 查看已配置的模型提供商
openclaw models list

# 测试 AI 响应
openclaw agent --message "Hello, can you hear me?"

永久配置#

# Du's API 配置
export DUSAPI_API_KEY="your-api-key-here"

# 如果使用环境变量方式配置内置提供商：
export OPENAI_BASE_URL="https://api.dusapi.com/v1"
export OPENAI_API_KEY="your-api-key-here"

export ANTHROPIC_BASE_URL="https://api.dusapi.com"
export ANTHROPIC_API_KEY="your-api-key-here"

source ~/.zshrc  # 或 ~/.bashrc

常见问题#

配置后无法连接#

1. 检查 API Key 是否正确
2. 确认 Base URL 是否正确（OpenAI 兼容需要 /v1 后缀）
3. 运行 openclaw doctor 诊断配置问题
4. 检查 Gateway 是否正在运行：openclaw gateway status

如何切换模型？#

在 OpenClaw 聊天中使用 /model 命令切换模型，或在配置文件的 agents.defaults.model.primary 中修改默认模型。

如何查看当前使用的模型？#

openclaw models list

环境变量不生效#

确保你在设置环境变量后，在同一个终端会话中运行 OpenClaw。如果重新打开了终端，需要重新设置环境变量，或者将其添加到 shell 配置文件中。

模型不在可选列表中#

确保你在 agents.defaults.models 中添加了模型的允许列表条目。格式为 provider-name/model-id，例如 dusapi-openai/gpt-5.4。

高级配置#

设置代理#

export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"

诊断模式#

openclaw doctor

查看 Gateway 状态#

openclaw gateway status

下一步#

• 查看模型列表了解所有可用模型
• 查看API 调用方法了解更多 API 使用技巧
• 如有问题，查看常见问题