OpenClaw 配置指南

OpenClaw 是一个 AI 代码生成工具,支持多种 AI 模型。本指南将帮助你配置 OpenClaw 以使用 Du's API。

前置要求

  • 已安装 OpenClaw
  • 拥有 Du's API 的 API Key

配置方式

OpenClaw 支持两种配置方式:

  1. 环境变量(推荐)
  2. 配置文件

方式一:环境变量配置

OpenAI 模型

macOS / Linux

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

Windows CMD

set OPENAI_API_BASE=https://api.dusapi.com
set OPENAI_API_KEY=your-api-key-here

Windows PowerShell

$env:OPENAI_API_BASE="https://api.dusapi.com"
$env:OPENAI_API_KEY="your-api-key-here"

Anthropic (Claude) 模型

macOS / Linux

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

Windows CMD

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

Windows PowerShell

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

方式二:配置文件

OpenClaw 通常会在用户目录下查找配置文件。

配置文件位置

  • macOS/Linux: ~/.openclaw/config.yaml~/.config/openclaw/config.yaml
  • Windows: %USERPROFILE%\.openclaw\config.yaml

配置文件内容

providers:
  openai:
    base_url: https://api.dusapi.com
    api_key: your-api-key-here
    default_model: gpt-5.4

  anthropic:
    base_url: https://api.dusapi.com
    api_key: your-api-key-here
    default_model: claude-sonnet-4-6

# 默认使用的提供商
default_provider: openai

支持的模型

OpenAI 模型

  • gpt-5.4 - 最新的 GPT-5.4 模型
  • gpt-5.3-codex - GPT-5.3 Codex(推荐用于代码生成)
  • gpt-5.3-codex-spark - 轻量级 Codex
  • gpt-5.2 - GPT-5.2 模型

Anthropic 模型

  • claude-opus-4-6 - Claude 4.6 Opus
  • claude-opus-4-6-thinking - Claude 4.6 Opus (Thinking)
  • claude-sonnet-4-6 - Claude 4.6 Sonnet

验证配置

配置完成后,运行以下命令验证:

openclaw --version

然后尝试一个简单的代码生成任务:

openclaw generate "Create a function to sort an array"

如果配置正确,OpenClaw 应该会生成相应的代码。

使用示例

生成代码

openclaw generate "Write a Python function to calculate prime numbers"

重构代码

openclaw refactor --file mycode.py --instruction "Add error handling"

解释代码

openclaw explain --file mycode.py

指定模型

openclaw generate "Create a REST API" --model gpt-5.3-codex

永久配置

macOS / Linux

将环境变量添加到你的 shell 配置文件(~/.bashrc~/.zshrc~/.bash_profile):

# Du's API 配置
export OPENAI_API_BASE="https://api.dusapi.com"
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

Windows

在 Windows 中,可以通过系统设置添加永久环境变量:

  1. 打开「系统属性」→「高级」→「环境变量」
  2. 在「用户变量」中添加相应的变量

常见问题

配置后无法连接

  1. 检查 API Key 是否正确
  2. 确认 Base URL 是否正确
  3. 检查网络连接是否正常
  4. 确认环境变量已正确设置

如何切换模型?

使用 --model 参数指定模型:

openclaw generate "Your prompt" --model claude-sonnet-4-6

或者在配置文件中修改 default_model

如何切换提供商?

使用 --provider 参数:

openclaw generate "Your prompt" --provider anthropic

或者在配置文件中修改 default_provider

环境变量不生效

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

配置文件和环境变量哪个优先?

通常环境变量的优先级更高。如果同时设置了配置文件和环境变量,OpenClaw 会优先使用环境变量。

高级配置

设置代理

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

调试模式

export OPENCLAW_DEBUG=true

自定义超时时间

在配置文件中添加:

timeout: 60  # 60 秒超时

配置脚本示例

创建一个快速配置脚本:

setup-openclaw.sh (macOS/Linux)

#!/bin/bash

# Du's API OpenClaw 配置
export OPENAI_API_BASE="https://api.dusapi.com"
export OPENAI_API_KEY="your-api-key-here"

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

echo "OpenClaw 已配置完成!"
echo "OpenAI Base: $OPENAI_API_BASE"
echo "Anthropic Base: $ANTHROPIC_BASE_URL"

使用方法:

source setup-openclaw.sh

下一步