7.0
热点
AI SCORE
行业动态2026-04-21 11:43
Anthropic官方确认：OpenClaw CLI使用政策回归允许
Hacker News · docs.openclaw.ai#OpenClaw#政策澄清#Anthropic
Editor brief · 编辑速览
官方澄清OpenClaw命令行工具的使用规则，明确了之前的限制已解除。对OpenClaw用户的直接利好。
Anthropic 开发了 Claude 模型家族。OpenClaw 支持两种认证方式：
API key - 直接 Anthropic API 访问，按用量计费（anthropic/* 模型）
Claude CLI - 在同一主机上重用现有 Claude Code 登录
OpenClaw 检测可用的 Anthropic 凭证并选择匹配的使用情况界面：
Claude 订阅/设置凭证显示配额时间窗口和可选的额外使用预算。
ANTHROPIC_ADMIN_KEY 或 ANTHROPIC_ADMIN_API_KEY 在 Control UI Usage 中显示提供商报告的 30 天组织成本和 Messages API 使用情况，包括每日支出、token/缓存总计、热门模型和成本类别。
存储在 Anthropic 提供商配置文件中的 sk-ant-admin... 凭证会自动被识别为 Admin API key。
Admin API 成本历史来自 Anthropic 的 Usage and Cost API。这是实际的提供商账单，独立于 OpenClaw 的会话推导估算成本。
获取 API key
在 Anthropic Console 中创建 API key。
运行入门流程，或直接传递密钥：
openclaw auth create-api-key
验证模型可用：
openclaw models status
确保已安装 Claude CLI 并已登录
验证：
claude auth status
运行入门流程
OpenClaw 检测并重用现有的 Claude CLI 凭证。
openclaw auth claude-cli
验证模型可用：
openclaw models status
设置 token
在安装了 Claude Code 的任何机器上运行 claude setup-token。它打印一个以 sk-ant-oat01- 开头的长期有效的 token。
在入门期间，通过在 macOS 应用中选择"Anthropic setup-token"（在"连接 API key 或 token"下）来粘贴 token，或使用：
openclaw auth create-setup-token <token>
优先使用规范的 Anthropic 模型引用加上 CLI 运行时覆盖
{
"models": {
"claude": "anthropic/claude-opus-5",
"fast": "anthropic/claude-sonnet-5"
}
}
为了兼容性，旧的 claude-cli/claude-opus-4-7 模型引用仍然有效，但新配置应该将 provider/model 选择保持为 anthropic/*，并将执行后端放在 provider/model 运行时策略中。
OpenClaw 使用 Claude Code 的非交互式 claude -p 路径来运行 Claude CLI。Anthropic 目前将该路径视为 Agent SDK/程序式使用：
Anthropic 在 2026 年 6 月 15 日的支持更新中暂停了之前宣布的单独 Agent SDK 信用计划。
订阅计划 Claude Agent SDK、claude -p 和第三方应用使用仍然从已登录订阅的使用限制中扣除。
在 Anthropic 修订该计划期间，之前宣布的月度 Agent SDK 信用不可用。
Console/API-key 登录使用按现付 API 计费，不会获得订阅 Agent SDK 信用。
有关暂停通知，请参阅 Anthropic 的 Agent SDK 计划文章，有关 Pro/Max 和 Team/Enterprise 订阅行为，请参阅 Claude Code 计划文章。
Anthropic 可以在不发布 OpenClaw 的情况下更改 Claude Code 计费和速率限制行为。当计费可预测性很重要时，请检查 claude auth status、/status 和 Anthropic 的相关文档。
捆绑的 Anthropic 插件将 Claude Code 组添加到正常的会话侧边栏。行在正常的聊天窗格中打开。它在网关和连接的节点主机上发现未存档的 Claude Code 会话：
Claude CLI 会话来自有效的项目索引记录。对于未索引的文本记录，有界元数据回退在 ~/.claude/projects/ 下识别并发非侧链交互式（cli）和无头 Agent SDK CLI（sdk-cli）会话。
Claude Desktop 会话使用 Desktop 标题、活动时间和存档状态，当其元数据指向同一 Claude Code 会话 ID 时。
仅 CLI 会话没有存档标志，因此当其文本记录存在时，它保持可见。
发现不需要额外的 OpenClaw 配置。Anthropic 插件已捆绑并默认启用；当本地 ~/.claude/projects/ 目录存在时，本机 macOS 节点会播放只读 Claude 会话命令。当这些命令首次出现时，批准节点配对升级。
侧边栏按其网关或配对节点主机分组行，并在计算机响应时立即显示每个主机的最新有界页面。在主机连接更改后、页面重新获得焦点时以及在可见时每最多 30 秒进行一次协调，因此在 OpenClaw 外创建的 Claude 会话不需要重新加载而出现。更改的目录获得更快的后续处理。在目录组下方使用"加载更多会话"以为具有更多历史记录的每个主机追加下一页；追加的行保持可见，并在刷新时重新获取到相同的深度。目录客户端使用 sessions.catalog.list；打开行使用 sessions.catalog.read。
终端接管从拥有主机用户的登录 shell PATH 而不是服务/守护进程 PATH 解析 claude。这使应用启动的会话与操作员在正常终端中获得的 Claude CLI 一致。
选择一行首先读取最新的文本记录页面。加载较旧的文本记录项遵循不透明的字节游标，并从 JSONL 文件读取另一个有界部分，而不是加载整个历史记录。正常的用户、助手、推理、工具调用和工具结果内容被保留。大于节点/网关安全上限的单个项被清楚地标记为截断。
对于网关本地 claude-cli 行，在正常编辑器中键入会调用 sessions.catalog.continue。OpenClaw 重新解析本地目录记录，创建或重用模型锁定的本机会话，导入最多 200 个可见项或 512 KiB，并为 Claude CLI 绑定播种。第一个转折用 --fork-session 恢复；Claude 为分叉分配新的会话 ID，因此后续转折使用分叉，源会话保持未触及。
无头节点主机也可以通过启用下面的节点本地设置并重新启动节点主机来使其 Claude CLI 行可继续：
{
"node": {
"enable-claude-cli-continuation": true
}
}
节点仅在启用设置且其本地 claude 可执行文件解析时才播放 agent.cli.claude.run.v1。OpenClaw 在该节点上重新解析目录记录，导入相同的有界历史记录，并将采用的会话绑定到节点和目录报告的工作目录。每个转折使用该节点的 Claude 文件和登录运行节点的真实 claude -p 进程。节点的执行批准策略仍然适用；网关无法强制选择加入。
节点继续 v1 仅一次性。它省略了网关环回 MCP 配置和网关技能插件参数，不从网关文本记录重新播种，并拒绝附件和图像。Claude Desktop 行保持仅查看。本机 macOS 应用节点也保持仅查看，直到应用播放运行命令。
有关节点命令和安全边界，请参阅节点：Claude 会话和文本记录。
配置 Anthropic API key 后，OpenClaw 从 Anthropic 的模型端点刷新 Claude 目录，因此新发布的受支持模型系列快照无需 OpenClaw 发布即可出现。已发布目录已描述的模型始终保留其发布的元数据和价格。
仅当 Anthropic 播放的功能与 OpenClaw 将应用的请求成形匹配时，才提供新发现的模型。因此，全新的模型生成保持隐藏，直到 OpenClaw 添加对其的支持，而不是在选择器中出现并使每个请求失败。发现是建议性的：没有 API key 或端点无法访问时，已发布的目录保持不变。
裸科系别名是滚动的：opus 跟踪当前支持的 Claude Opus 一代，今天解析为 anthropic/claude-opus-5，与 sonnet 跟踪当前 Sonnet 的方式相同。升级 OpenClaw 因此可以将说 opus 的配置移到新一代模型上。固定版本以选择退出 - 版本化别名如 opus-4.8 继续解析为其自己的模型，已命名 claude-opus-4-8 的配置永远不会被重写。
anthropic/claude-opus-5 默认使用高强度自适应思考。使用 /think off 禁用思考，或使用 /think xhigh|max 获得模型的更高原生强度级别。OpenClaw 为 Opus 5 省略了手动思考预算、自定义采样参数、助手前填充和优先级层，因为 Anthropic 不支持该模型上的这些请求功能。目录发布其 1,000,000 token 上下文窗口、128,000 token 输出限制、图像输入和 $5/$25 输入/输出价格。
anthropic/claude-sonnet-5 使用相同的自适应思考默认值和请求限制。目录使用 Anthropic 的介绍价格 $2/$10 输入/输出定价，直到 2026 年 8 月 31 日；标准 $3/$15 定价从 2026 年 9 月 1 日开始。
anthropic/claude-fable-5 始终使用自适应思考并默认为高强度。Anthropic 不允许对此模型禁用思考，因此 /think off 和 /think minimal 映射到低强度。OpenClaw 也为 Fable 5 请求省略自定义温度值，因为 Anthropic 拒绝任何启用思考的请求上的温度覆盖。
anthropic/claude-mythos-5 是具有相同始终启用自适应思考合同的有限访问模型。OpenClaw 默认为高，将 /think off 和 /think minimal 映射到低，并省略调用者选择的采样参数。目录发布其 1,000,000 token 上下文窗口、128,000 token 输出限制、图像输入和 $10/$50 输入/输出价格。
Claude Opus 4.8 在 OpenClaw 中默认保持思考关闭。当您使用 /think high|xhigh|max 显式启用自适应思考时，OpenClaw 发送 Anthropic 的 Opus 4.8 强度值；Claude 4.6 模型（Opus 4.6 和 Sonnet 4.6）默认为自适应。
使用 /think:<level> 或模型参数按消息覆盖：
{
"agents": {
"defaults": {
"params": {
"thinking": "high"
}
}
}
}
Opus 5 和 Fable 5 分类器在受限制域中的请求上返回 stop_reason: "refusal"。没有回退，即使 Anthropic 对该拒绝类别有推荐的模型，转折也会以错误结束。
对于对 anthropic/claude-opus-5 或 anthropic/claude-fable-5 的每个直接 API-key 请求，OpenClaw 发送 server-side-fallback-2026-07-01 测试版标头加上 fallbacks: "default"。Anthropic 为报告的拒绝类别选择推荐的模型。
只有安全分类器拒绝才能触发回退。速率限制、过载和服务器错误的行为完全相同，并通过 OpenClaw 的正常模型故障转移。
救援发生在同一通话内。在任何输出之前的拒绝除了延迟之外是不可见的；整个答案来自提供模型。在中流拒绝时，部分文本被保留为回退模型继续的前缀，而拒绝的模型的推理和工具调用根据 Anthropic 的重放规则被丢弃（它们不得被回显或执行）。
如果推荐的模型也拒绝，则转折会显示拒绝为错误。
回退发生在 Anthropic API 级别，因此提供模型不需要在您配置的 OpenClaw 回退链中。
回退提供的转折在助手消息上记录 provider_fallback 诊断，命名 fromModel 和 toModel，消息的 responseModel 报告回答的模型。
Anthropic 以提供模型的价格对回退尝试计费。OpenClaw 以 Opus 4.8 价格对已知的 Opus 4.8 回退提供的转折计费。
中流拒绝另外以 Anthropic 为主模型的已流式传输部分计费；该部分在 API 的每次尝试使用中报告，但不折叠到 OpenClaw 的每转估计中。
适用于针对 api.anthropic.com 进行 API-key 认证的 anthropic/claude-opus-5 和 anthropic/claude-fable-5。OAuth（包括 Claude CLI 订阅重用）、代理基本 URL、Bedrock、Vertex 和 Foundry 请求保持不变，仍在那里显示拒绝为错误。
有关底层行为，请参阅 Anthropic 的拒绝和回退指南。
OpenClaw 支持 API-key 认证的 Anthropic 提示缓存功能。
使用模型级参数作为基线，然后通过 agents.entries.*.params 覆盖特定代理：
{
"agents": {
"defaults": {
"models": {
"provider/model": {
"params": {
"caching": "ephemeral"
}
}
}
},
"entries": [
{
"id": "agent-1",
"params": {
"caching": "none"
}
}
]
}
}
这使一个代理保持长期缓存，而同一模型上的另一个代理禁用缓存用于突发/低重用流量。
Bedrock 上的 Anthropic Claude 模型（amazon-bedrock/anthropic.claude）在配置时接受 cacheRetention 传递。
非 Anthropic Bedrock 模型在运行时被强制为 cacheRetention: "none"。
API-key 智能默认值在未设置显式值时也为 Claude-on-Bedrock 引用播种 cacheRetention: "short"。
对于 Claude Opus 5 和 Opus 4.8，OpenClaw 的共享 /fast 切换使用 Anthropic 的本机快速模式用于直接 API-key 流量到 api.anthropic.com。
捆绑的 Anthropic 插件注册图像和 PDF 理解。OpenClaw 从配置的 Anthropic 认证自动解析媒体功能；不需要额外的配置。
当图像或 PDF 附加到对话时，OpenClaw 自动将其通过 Anthropic 媒体理解提供者路由。
Claude Opus 5、Sonnet 5、Mythos 5 和 Fable 5 具有确切的 1,000,000 token 输入窗口，支持最多 128,000 输出 token。Anthropic 的 1M 上下文窗口也在具有自适应思考的 Claude 4.x 模型上推出：Opus 4.8、Opus 4.7、Opus 4.6 和 Sonnet 4.6。OpenClaw 自动调整这些模型的大小，无需 params.context1m：
{
"agents": {
"defaults": {
"models": {
"anthropic/claude-opus-5": {}
}
}
}
}
较旧的配置可以保留 params.context1m: true；对于这些模型它是无害的无操作，OpenClaw 无论如何不再发送已弃用的 context-1m-2025-08-07 测试版标头。具有该值的较旧 anthropicBeta 配置条目在请求标头解析期间被删除，不支持的较旧 Claude 模型保持在其正常上下文窗口上。
params.context1m: true 对 Claude CLI 后端（claude-cli/*）的行为相同：符合资格的支持 GA 的 Opus 和 Sonnet 模型已自动获得 1M 窗口，因此参数在那里也是可选的。
anthropic/claude-opus-5 及其 claude-cli 变体默认具有 1M 上下文窗口；无需 params.context1m: true。
Anthropic token 认证过期且可以被撤销。对于新设置，改用 Anthropic API key。
Anthropic 认证是按代理的；新代理不继承主代理的密钥。为该代理重新运行入门流程（或在网关主机上配置 API key），然后使用 openclaw models status 验证。
openclaw models status
运行 openclaw models status 查看哪个认证配置文件处于活动状态。重新运行入门流程，或为该配置文件路径配置 API key。
openclaw models status --json | grep auth.unusableProfiles
检查 openclaw models status --json 用于 auth.unusableProfiles。Anthropic 速率限制冷却可以是模型范围的，因此同级 Anthropic 模型可能仍然可用。添加另一个 Anthropic 配置文件或等待冷却。