必须先拥有有效API密钥，否则OpenClaw启动失败或调用返回401；需登录服务商控制台创建密钥，通过export命令临时验证，再用cat >> ~/.openclaw/.env持久化配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为OpenClaw配置API Key前，必须确保你已拥有至少一个主流AI服务提供商（如Anthropic、OpenAI或OpenRouter）的正式API密钥，且该密钥处于有效状态、未被撤销或过期；缺少可用密钥将导致网关启动失败或后续模型调用直接返回401错误。
获取并验证API密钥
登录对应服务商控制台（例如Anthropic Console），在“API Keys”页面点击“Create new key”，复制生成的密钥字符串（以sk-开头）。
在终端执行临时导出与验证命令：export ANTHROPIC_API_KEY="sk-..." && openclaw models status。若返回包含claude-3-5-sonnet等可用模型列表，则密钥格式与权限正确；若提示Unauthorized，说明密钥无效或权限不足，需重新生成。
选择持久化配置方式
方法一：手动写入.env文件（推荐用于生产环境）
执行以下命令将密钥安全写入用户级配置目录：
cat >> ~/.openclaw/.env <<'EOF'<br>ANTHROPIC_API_KEY=sk-xxx<br>OPENAI_API_KEY=sk-yyy<br>EOF。注意【.env文件必须位于~/.openclaw/路径下，且不能放在项目根目录或系统全局路径】，否则网关无法加载。
重启服务使配置生效：systemctl restart openclaw-gateway。
方法二：使用交互式向导注册令牌
在网关主机运行openclaw auth setup-token，按提示完成本地令牌生成；随后将输出的令牌字符串粘贴至OpenClaw Web界面的认证入口。若跨机器操作，请改用openclaw auth paste-token --token=xxx命令注入。
【遇到This credential is only authorized for use with Claude Code错误时，必须立即放弃setup-token方式，退回API Key模式】。Anthropic明确限制该令牌仅限Claude Code场景，非合规使用可能触发服务终止。
配置多密钥轮换机制
第一步：在.env中按行追加多个同类型密钥
例如同时配置3个Anthropic密钥：ANTHROPIC_API_KEY=sk-a1,sk-a2,sk-a3，用英文逗号分隔。
第二步：确认网关版本支持轮换
运行openclaw version检查输出是否含v0.8.0+字样；低于此版本不识别逗号分隔格式，会导致解析失败并静默跳过所有密钥。
第三步：触发轮换验证
当某次请求返回HTTP 429（rate_limit）、quota_exceeded或rate_limit错误时，OpenClaw会自动切换至列表中的下一个密钥重试；但401或500类错误不会轮换，直接报错终止。
