——
OpenClaw 1M 上下文窗口正式 GA：5 个关键变更与迁移指南
Anthropic 的 100 万 token 超长上下文能力已从 Beta 测试阶段正式进入稳定生产环境（GA）。 这一升级意味着开发者可以更可靠地处理大型代码库、长文档和复杂多轮对话。本文将详细解读 OpenClaw 针对此次 GA 发布的核心代码变更，以及你需要了解的配置调整事项。
—
一、为什么这次升级很重要？
在 Beta 阶段，使用 1M 上下文窗口需要额外注入 context-1m-2025-08-07 Beta 头部，且 OAuth 认证存在兼容性问题——这是许多企业级用户的主要痛点。随着 Anthropic 将 1M 上下文正式纳入标准 API，这些限制已被彻底移除。
对于 AI Agent 开发者而言，这意味着：
- 更简洁的认证流程（无需区分 OAuth 与 API Key 的特殊处理）
- 更稳定的生产环境支持
- 降低因 Beta 头部过期导致请求失败的风险
—
二、OpenClaw 的 5 项核心变更
1. 移除 Beta 头部自动注入
此前，当配置 context1m: true 时，OpenClaw 会自动添加以下头部：
// 已移除的旧代码逻辑
headers['anthropic-beta'] = 'context-1m-2025-08-07';
现在：该头部不再自动注入，Anthropic 后端已原生支持 1M 上下文识别。
2. OAuth 认证限制解除
Beta 阶段的一个关键限制是：OAuth Token 会被 Anthropic 拒绝用于 1M 上下文请求。OpenClaw 此前通过以下逻辑绕过：
// 已移除的 OAuth 跳过逻辑
if (isOAuthToken && is1MModel) {
// 强制降级或报错处理
}
现在：OAuth 与 API Key 享有同等的 1M 上下文支持，无需特殊处理。
3. 清理用户配置的遗留 Beta 头部
为防止用户自定义 anthropicBeta 数组中包含已废弃的 1M Beta 头部，OpenClaw 现在会自动过滤：
// 配置清理逻辑示例
const LEGACY_BETA_HEADERS = ['context-1m-2025-08-07'];
const cleanedBetas = userConfig.anthropicBeta?.filter(
beta => !LEGACY_BETA_HEADERS.includes(beta)
);
4. 移除废弃的辅助函数与常量
以下内部 API 已被清理，不影响用户配置：
| 移除项 | 说明 |
|——–|——|
| isAnthropic1MModel() | 模型识别辅助函数 |
| ANTHROPIC_1M_MODEL_PREFIXES | 1M 模型前缀常量数组 |
| 相关日志导入 | 减少 bundle 体积 |
5. 保留 context1m 配置参数
重要：context1m: true 配置项仍然有效，但其作用域已调整：
// config/openclaw.config.ts
export default {
providers: {
anthropic: {
context1m: true, // 仍用于 context.ts 中的窗口大小计算
// 不再触发 Beta 头部注入
}
}
};
—
三、迁移检查清单
如果你正在使用 1M 上下文功能，请按以下步骤验证：
步骤 1：更新 OpenClaw 版本
使用 npm
npm update @openclaw/core
或使用 pnpm
pnpm update @openclaw/core
验证版本
npx openclaw --version # 应 >= 1.x.x
步骤 2：检查自定义 Beta 配置
搜索项目中可能的遗留配置
grep -r "context-1m-2025-08-07" ./config/
grep -r "anthropicBeta" ./config/
步骤 3：验证 OAuth 流程（如适用）
// 测试脚本：验证 OAuth + 1M 上下文
import { OpenClaw } from '@openclaw/core';
const agent = new OpenClaw({
auth: { type: 'oauth', / ... / },
context1m: true,
});
// 应正常返回，不再抛出 OAuth 不兼容错误
await agent.chat({
model: 'claude-3-opus-20240229',
messages: [/ 长上下文内容 /]
});
步骤 4：监控上下文窗口计算
启用调试日志，确认 context.ts 正确识别 1M 窗口
DEBUG=openclaw:context npm run dev
—
四、FAQ：常见问题解答
Q1: 我需要修改现有的 context1m: true 配置吗？
不需要。该参数继续控制上下文窗口大小计算，仅 Beta 头部注入行为被移除。现有配置完全兼容。
Q2: 使用 OAuth 的企业用户有什么变化？
最大的变化是移除了人工限制。此前 OAuth 用户被迫使用 64K 上下文或切换为 API Key，现在可直接使用 1M 上下文，认证流程与其他功能一致。
Q3: 如果我的代码中硬编码了 Beta 头部怎么办？
OpenClaw 会自动过滤已知的遗留头部，但建议主动清理。搜索你的代码库中的 anthropic-beta 头部设置，确认没有手动添加 context-1m-2025-08-07。
Q4: 哪些模型支持 1M 上下文 GA？
根据 Anthropic 官方公告，以下模型已确认支持：
claude-3-opus-20240229及后续版本claude-3-5-sonnet-20241022及后续版本
具体列表请参考 Anthropic 官方文档。
Q5: 这次更新会影响上下文缓存（Prompt Caching）吗？
不会。上下文缓存是独立功能，与 1M 上下文的 GA 升级无直接关联。两者可配合使用以优化长对话的成本和延迟。
—
五、总结与下一步
Anthropic 1M 上下文窗口的 GA 发布标志着超长上下文技术进入成熟生产阶段。OpenClaw 的此次更新专注于清理技术债务、简化认证流程，并为未来的功能扩展奠定基础。
建议行动：
1. 本周内更新至最新版 OpenClaw
2. 审查并清理自定义 Beta 头部配置
3. 评估 OAuth 场景下 1M 上下文的重新启用
—
相关阅读
—
参考来源
