使用 Claude 不限量运行 OpenClaw

OpenClaw 是一个多渠道 AI 网关，通过中心辐射式架构将 Claude 连接到超过 50 个消息渠道。每个渠道都是独立的推理端点——Telegram 机器人、Discord 服务器、Slack 工作区、网页组件和自定义集成都通过运行在您基础设施上的中央网关进行路由。技能被注入系统提示词，渠道始终保持开启，因此 OpenClaw 会持续、不间断地消耗 API 用量，且用量随活跃渠道和用户数量线性增长。

OpenClaw 的持续在线架构

OpenClaw 作为中心辐射式网关运行。中心是一个中央进程（通常在 VPS 上通过端口 18789 运行），负责管理模型配置、技能注入和请求路由。辐射节点是渠道连接器——每个连接器都与消息平台保持持久连接，并将传入消息转发到中心进行推理。

每个渠道都是一个持续开放的推理入口。当用户在任何已连接的平台上发送消息时，渠道连接器会将其转发到中心。中心构建完整提示词（系统提示词 + 技能 + 对话历史 + 用户消息），将其发送给 Claude，再将响应以流式方式返回渠道。没有排队或批处理——每条消息都会立即触发推理。

网关永不休眠。只要进程在运行，全部 50+ 个渠道就会保持活跃，任何传入消息都会触发一次 Claude API 调用。交互式工具仅在开发者工作时消耗 token，而 OpenClaw 只要有任何用户在任何渠道发送消息就会消耗 token——对于活跃部署，这意味着每天数百次甚至数千次调用。因此，对于正式部署，无限量访问不仅方便，而且在经济上也必不可少。

openclaw.json 中的提供商配置

OpenClaw 的模型配置位于 ~/.openclaw/openclaw.json 的 models.providers 配置块中。每个提供商条目都需要名称、api 字段（对于 Claude，MUST显式设为 'anthropic-messages'——它不是默认值）、指向网关的 baseUrl，以及用于身份验证的 apiKey。api 字段控制 OpenClaw 使用的请求格式。

将 baseUrl 设为 https://aiprimetech.io（根主机地址，不含 /v1——anthropic-messages 处理程序会附加正确的路径）。apiKey 可以使用直接值，也可以通过 ${ENV_VAR} 语法插入环境变量。变量插值有助于避免将密钥保存在配置文件中：将 apiKey 设为 '${UNLIMITED_API_KEY}'，并在 shell 或 systemd 单元中导出该变量。

您还可以在提供商配置中指定自定义请求头。使用 headers 字段传递 anthropic-beta 标志或自定义路由请求头。例如，headers: {'anthropic-beta': 'max-tokens-3-5-sonnet-2024-07-15'} 可为支持的模型启用扩展输出。在无限量网关上，标准请求头无需修改即可使用。

模型条目与 api 字段要求

OpenClaw 配置中有一个需要特别注意的问题：每个模型条目中的 api 字段MUST显式设为 'anthropic-messages'。如果省略，OpenClaw 会默认使用与 Claude 不兼容的通用补全格式。这会导致难以理解的错误，看似连接失败，实际却是格式不匹配。请务必在每个 Claude 模型条目中包含 api: 'anthropic-messages'。

在 openclaw.json 的 models.models 下定义模型条目。每个条目通过名称引用提供商，并指定模型 ID。为各个 Claude 变体创建条目：将 claude-sonnet-4-5 作为大多数渠道的默认模型，将 claude-opus-4-6 用于需要更深入推理的渠道，将 claude-haiku-4-5 用于速度比深度更重要的高流量渠道。

在渠道配置中为渠道分配模型。每个渠道可以使用不同的模型——客户支持渠道可以使用 Sonnet，以获得均衡的回复；技术渠道可以使用 Opus，以提供复杂问题的解释；通知渠道可以使用 Haiku，以快速确认消息。在无限量方案下，可根据质量需求分配模型，无需考虑成本。

运行在端口 18789 上的中心辐射式网关

OpenClaw 网关通常运行在端口 18789 上（可在 openclaw.json 的 server.port 中配置）。它提供 REST API，供渠道连接器提交消息和接收响应。网关在内部处理提示词构建、模型选择、对话历史管理和流式响应。

将网关部署在能够可靠保持在线的 VPS 上——它需要 24/7 运行，才能让渠道持续响应。使用 systemd 或 Docker 确保进程崩溃后自动重启。该进程对 CPU 和内存的需求较低；瓶颈始终是上游 API 调用延迟，而非本地处理。一台小型 VPS（1 CPU、1 GB 内存）即可轻松处理数十个并发渠道。

网关在内存中维护对话历史（可配置为持久化到磁盘或 Redis）。所有渠道中的每个活跃对话都有各自不断增长的上下文。当有 50 个渠道，且每个渠道都有多个活跃用户时，网关可能同时维护数百个对话状态。上下文管理是自动完成的——旧对话会根据可配置的 TTL 设置清理。

技能注入与系统提示词管理

OpenClaw 的技能系统会在每次请求的系统提示词中注入针对特定能力的指令。技能以文本文件的形式定义在 skills 目录中，可以分配给特定渠道，也可以全局应用。每项技能都会添加上下文，帮助 Claude 根据渠道用途作出恰当回应，例如采用客户支持语气、技术文档风格或运用特定领域知识。

每项技能都会为其所分配渠道上的每次请求增加 token 用量。一个启用了五项技能的渠道，可能在尚未包含任何对话历史之前，就为每次请求的系统提示词增加 2,000-5,000 个 token。如果五十个渠道各自使用不同的技能配置，每天的技能总开销将相当可观。在无限量方案下，这不是问题——可以编写全面的技能，无需担心每次请求的成本。

技能可以通过模板变量包含动态内容。OpenClaw 支持将用户信息、渠道上下文、一天中的时间以及自定义变量注入技能文本。这种动态注入在请求时进行，确保技能始终包含最新信息。这种灵活性无需复杂的路由逻辑，即可实现精细的渠道专属行为。

渠道配置与扩展

OpenClaw 中的每个渠道都在 openclaw.json 的 channels 部分或独立的渠道配置文件中进行配置。渠道条目指定平台类型（telegram、discord、slack、web、custom）、该平台的身份验证凭据、要使用的模型、分配的技能，以及对话管理设置（历史长度、TTL、角色设定）。

扩展呈线性增长：每增加一个渠道，就会多一个开放的推理端点。添加一个 Telegram 机器人会增加一个渠道。添加一个监控多个频道的 Discord 服务器，可能会增加十个渠道。每个受监控的 Discord 频道都是独立的对话流，拥有各自的上下文。一个集成了 Discord、Telegram、Slack 和网页组件的大型 OpenClaw 部署，很容易就会有 50-100 个活跃的推理端点。

采用按 token 计费时，增加渠道会直接增加成本。每个新增渠道都会根据其消息量按比例增加 API 费用。采用不限量方案时，你可以在合理使用速率限制内自由扩展渠道。添加新平台、新机器人、新组件——固定费用涵盖所有这些内容。唯一的约束是每分钟速率限制，而这一限制足以满足大多数多渠道部署的需求。

OpenClaw 部署故障排查

最常见的配置错误是在模型条目中忘记设置 api: 'anthropic-messages'。缺少此字段时，OpenClaw 会以错误的格式发送请求，并收到 API 返回的难以理解的错误。如果出现响应解析失败或意外的 400 错误，请先检查 api 字段。必须显式设置此字段——Claude 模型没有正确的默认值。

如果某些渠道出错，而其他渠道正常，通常是渠道级模型分配指向了不存在或名称有拼写错误的模型条目。OpenClaw 不会在启动时验证模型引用，而是在渠道尝试使用配置错误的模型时，请求才会失败。请检查每个渠道的模型引用是否与现有 models.models 条目名称完全一致。

在多渠道高负载下遇到速率限制错误时，请记住，所有渠道共用同一个 API 密钥和速率限制。如果高峰时段有五十个渠道同时活跃，总请求速率可能会超过合理使用限制。网关会通过排队和重试来处理 429 响应，这会增加延迟，但不会丢失消息。对于消息量极大的部署，请联系 AI Prime Tech，咨询提高速率配额的事宜。

// ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "unlimited": {
        "api": "anthropic-messages",
        "baseUrl": "https://aiprimetech.io",
        "apiKey": "${UNLIMITED_API_KEY}"
      }
    },
    "models": {
      "sonnet": { "provider": "unlimited", "model": "claude-sonnet-4-5" },
      "opus":   { "provider": "unlimited", "model": "claude-opus-4-6" },
      "haiku":  { "provider": "unlimited", "model": "claude-haiku-4-5" }
    }
  },
  "server": { "port": 18789 }
}

# IMPORTANT: api: "anthropic-messages" is REQUIRED
# Without it, OpenClaw uses wrong request format

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。