隐私设置

隐私和GDPR声明

Nfero 使用必要存储来保存语言偏好和演示访问控制。经您同意,Google Analytics 和轻量使用事件将用于改进模型演示和外部订阅路径。实时演示提示词可能会发送到已配置的阿里巴巴托管模型端点。

工具 + 模型配对

OpenClaw 与阿里巴巴编码计划和令牌计划 (Token Plan)

开源、可自托管的个人 AI 编程助手,支持本地智能体(agent)工作流。

OpenClaw 是一款出色的自托管智能助手,适用于跨代码仓库、终端、浏览器及连接通道的统一协作场景。Alibaba 官方文档明确支持直接接入 pay-as-you-go、Coding Plan 和 Token Plan。

选择合适的访问方式

选择合适的访问方式

若仅一人进行交互式开发会话,请选择 Coding Plan;若为独立创始人或团队需基于 Credits 的用量模式、多席位支持或更稳定的日常智能体使用,则请选择 Token Plan。如不使用网关,请及时停止,避免心跳调用消耗计费方案额度。

推荐长期运行智能体推荐使用 Token Plan;单名交互式开发者推荐使用 Coding Plan

Token Plan(团队版)

当一名或多名指定用户需在常规编码与智能体会话中,基于 Credits 进行统一访问(且无需 Coding Plan 的滚动调用窗口)时,此方案最为合适。

Coding Plan

最适合单名开发者以交互方式使用 OpenClaw,且偏好固定月度请求额度的场景。

Pay-as-you-go Model Studio API

适用于后端服务、定时自动化任务、共享服务,或任何非指定用户交互式工具会话的工作负载。

安全配置模式

注册 Alibaba 提供商并将其设为主模型

示例已做脱敏处理。请仅在本机替换占位符,切勿将真实的 API 密钥粘贴到 Nfero 中。

开始之前

  1. 安装最新版 OpenClaw,并确认执行 `openclaw --version` 命令可正常返回版本信息。
  2. 从对应的 Alibaba 订阅页面获取专属的 Coding Plan 或 Token Plan API 密钥。
  3. 在修改 `~/.openclaw/openclaw.json` 文件前,请务必选择一个确切受支持的模型 ID。
  4. 请先备份现有的 OpenClaw 配置;切勿将真实密钥粘贴至公开问题、聊天窗口或网站中。

安全配置模式

协议
OpenAI-compatible
配置路径
~/.openclaw/openclaw.json
  1. 创建一个 `bailian` 提供商,确保模型前缀与提供商记录一致。
  2. 使用下方所示的 Token Plan 接口端点,或将其替换为 Coding Plan 接口端点 `https://coding-intl.dashscope.aliyuncs.com/v1`。
  3. 在本地将占位符替换为对应订阅计划的专属密钥。
  4. 重启网关后,使用 `/model` 或 `/status` 命令确认当前激活的提供商和模型。
json
{
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "apiKey": "YOUR_TOKEN_PLAN_API_KEY",
        "api": "openai-completions",
        "models": [{ "id": "qwen3.7-plus", "name": "Qwen3.7 Plus" }]
      }
    }
  },
  "agents": {
    "defaults": { "model": { "primary": "bailian/qwen3.7-plus" } }
  }
}

验证连接

  • 运行 `openclaw gateway restart`,然后启动 `openclaw tui`。
  • 运行 `/status` 命令,并确认所选模型 ID 以 `bailian/` 开头。
  • 在启用频道(Channels)、技能(Skills)或定时任务前,先发送一个小型代码仓库相关问题进行测试。
  • 若空闲期间用量异常上升,请检查会话日志中是否存在 `[OpenClaw heartbeat poll]` 记录。

模型配对

推荐入门模型

使用本工具通过每个模型运行交互式编码、推理、审查和文档任务。在生产使用前,请在阿里云确认最终模型的可用性和确切计划支持。 (Alibaba Cloud)

文本生成推理视觉理解
最佳配对角度

均衡默认选项,具备推理能力、视觉理解能力及面向工具的工作流支持。

文本生成推理
最佳配对角度

阿里巴巴推荐该模型用于大型代码库及长上下文智能体(agent)任务。

文本生成推理视觉理解
最佳配对角度

低资源消耗选项,适用于轻量级路由、摘要生成及快速仓库问答等场景。

常见问题

常见问题

现象描述

HTTP 401 错误、无效访问令牌(invalid access token)或无效 IAM 令牌(invalid_iam_token)

可能原因

密钥不完整、已被撤销、来自其他计费计划,或与错误的计费计划/地域端点配对。

解决方法

重新复制专用密钥,并仅将其与文档中指定的基础 URL 配对;清除密钥前后空格,并重启网关。

现象描述

未知模型

可能原因

服务商密钥、`bailian/` 模型前缀与模型列表不一致,或该模型未在当前白名单中。

解决方法

确保配置中存在 `models.providers.bailian`,主模型 ID 格式为 `bailian/<model-id>`,且该精确的模型 ID 已明确列于该服务商下。

现象描述

OAuth 令牌刷新失败

可能原因

OpenClaw 仍在通过旧版 OAuth 提供商或缓存的模型配置进行路由。

解决方法

备份相关文件,删除过时的 OAuth/提供商记录,清除陈旧的模型缓存,并按 Alibaba 常见问题解答(FAQ)中的说明重启 OpenClaw。

现象描述

无人聊天时仍持续产生用量

可能原因

OpenClaw 的网关心跳机制会周期性调用已配置的模型。

解决方法

在空闲时停止网关,或增大 `agents.defaults.heartbeat.every` 参数值;并在会话日志中验证该变更是否生效。

重要限制

  • 请使用来自同一 Alibaba 计费方案(如 Alibaba Cloud Token Plan 或 Coding Plan)的专用 API 密钥与基础 URL。Coding Plan、Token Plan 及通用 Model Studio 凭据不可互换使用。
  • 计费方案密钥仅限分配给指定用户的交互式编码或智能体工具使用。请勿共享、提交至代码仓库,或在截图中暴露该密钥。
  • 请勿将 Coding Plan 或 Token Plan 密钥用于自动化脚本、批量任务、应用后端、公共服务或其他非交互式 API 工作负载;此类场景请使用 pay-as-you-go Model Studio API 访问方式。
  • 模型可用性采用精确字符串白名单机制,且可能动态调整。编辑生效配置前,请务必查阅当前 Alibaba 计费方案文档确认模型 ID。