项目愿景 ​

NBility 是一个 AI Coding 中转站，支持 Claude、Codex 等主流 AI 模型在多种平台使用。本仓库包含两个核心部分：

1. 文档站 (VitePress) -- 面向用户的多语言文档门户，部署于 doc.nbility.dev
2. Landing Page (Deno) -- 独立的单文件 Deno 服务器，服务于 nbility.dev 主站着陆页

架构总览 ​

• 技术栈: VitePress 1.x + Vue 3 + TypeScript + Deno
• 构建工具: pnpm + Vite (VitePress 内置)
• 部署: GitHub Pages (文档站，通过 GitHub Actions) + Vercel (额外部署配置) + Deno Deploy (Landing Page)
• 国际化: 5 种语言 -- 简体中文 (默认)、English、Francais、Espanol、Portugues
• 功能增强: PWA (workbox)、RSS/Atom Feed 生成、Sitemap、图片缩放 (medium-zoom)、代码块分组图标

模块结构图 ​

graph TD
    A["(根) NBility"] --> B[".vitepress/"];
    A --> C["deno/"];
    A --> D["内容目录 (*.md)"];
    A --> E["public/"];
    A --> F[".github/workflows/"];

    B --> B1["config.mts"];
    B --> B2["theme/"];
    B2 --> B2a["index.ts"];
    B2 --> B2b["components/"];
    B2b --> B2b1["AnnouncementBar.vue"];
    B2b --> B2b2["BackToTop.vue"];
    B2b --> B2b3["ModelCards.vue"];
    B2b --> B2b4["ToolWizard.vue"];
    B2b --> B2b5["Timeline.vue"];
    B2 --> B2c["NotFound.vue"];
    B2 --> B2d["style.css + dark-mode.css"];

    D --> D1["/ (zh-CN 默认)"];
    D --> D2["en/"];
    D --> D3["fr/"];
    D --> D4["es/"];
    D --> D5["pt/"];

    C --> C1["landing.deno.ts"];
    C --> C2["deno.json"];

    click C "./deno/CLAUDE.md" "查看 deno 模块文档"

模块索引 ​

| 模块 | 路径 | 语言/框架 | 职责 | |

NBility

AI Coding 中转站 — 支持 Claude、Codex 模型在多种平台使用

文档 · English · 注册 · FAQ

已有账号？直接查看 快速开始 配置工具。

一、获取 API Key ​

1. 注册账号 ​

访问 nbility.dev，点击注册：

选择注册方式（GitHub、LinuxDO 或用户名注册）：

填写用户名、密码和确认密码完成注册：

2. 登录 ​

注册完成后使用用户名和密码登录：

登录后进入控制台：

3. 创建令牌 ​

进入控制台 → 令牌管理 → 添加令牌，填写表单：

• 令牌分组建议选择 官渠，该分组包含 claude-opus-4-5-20251101、claude-haiku-4-5-20251001、claude-opus-4-6、claude-sonnet-4-5-20250929、claude-sonnet-4-6 等模型，会根据任务复杂度自动选择，无需手动切换。

创建完成后在令牌列表点击复制按钮获取 API Key（格式为 sk-xxx）：

4. 充值 ​

进入控制台 → 钱包管理，支持支付宝、微信或兑换码：

| 方式 | 操作路径 | |

选择适合你的 AI 编程工具。以下是 NBility 平台支持的各工具全面对比。

基本信息 ​

| 工具 | 开发者 | 类型 | |

通用 ​

NBility 是什么？ ​

NBility 是一个 AI Coding 中转站，支持 Claude、Codex 模型在多种平台使用。

支持哪些工具？ ​

目前支持以下工具：

• Claude Code — Anthropic 官方 CLI
• OpenAI Codex — OpenAI 官方编程助手
• RooCode — VS Code AI 编程插件
• Qwen Code — 阿里通义千问编程工具
• Droid CLI — 轻量级 AI 编程 CLI
• OpenCode — 开源 AI 编程终端工具

数据隐私如何保障？ ​

NBility 仅作为 API 中转服务，不存储你的代码和对话内容。所有请求直接转发至对应的模型提供商。

账户与 Token ​

如何注册？ ​

访问 nbility.dev/register，按提示完成注册即可。

如何获取 API Token？ ​

注册后登录控制台，前往 Token 管理页 创建新的 Token。

Token 有效期多长？ ​

Token 在手动删除或重新生成前持续有效。建议定期轮换以确保安全。

用量额度是多少？ ​

NBility 为每个用户提供用量额度，具体数量根据平台资源动态调整。请关注控制台中的用量信息。

工具配置 ​

环境变量设置后不生效怎么办？ ​

检查以下常见原因：

1. 未重启终端 — 修改 .bashrc / .zshrc 后需要执行 source ~/.bashrc 或新开终端
2. 变量名拼写错误 — 注意区分大小写，如 ANTHROPIC_BASE_URL 不能写成 Anthropic_Base_Url
3. 多余的引号或空格 — export KEY="value" 中 value 前后不要有多余空格

# 检查变量是否已设置
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# 如果为空，说明变量未生效

配置文件路径在哪里？ ​

| 工具 | 配置文件路径 | |

NBility 平台支持来自多个供应商的 AI 模型，覆盖不同的使用场景和工具链。你可以根据实际需求自由选择和切换模型。

Anthropic (Claude) ​

| 模型 ID | 说明 | 推荐场景 | 兼容工具 | |

前提条件 ​

• 已安装 OpenClaw（参考下方安装章节）
• 已获取 NBility API Key（控制台获取）

核心特性 ​

多渠道集成 ​

• 全平台覆盖：支持飞书（Lark）、Discord、Slack、Microsoft Teams 等
• 单一网关：通过单个 Gateway 进程管理所有渠道
• 语音支持：支持 macOS/iOS/Android 语音交互
• 画布界面：可渲染交互式 Canvas 界面

自托管与数据安全 ​

• 完全自托管：运行在你自己的机器或服务器上
• 开源：MIT 协议，代码完全透明
• 本地数据存储：上下文与技能存储在本地，不上传云端

智能 Agent 能力 ​

• 持久运行：支持后台持久运行与持久记忆
• 定时任务：支持 cron 定时任务
• 会话隔离：按 Agent/工作区/发送者隔离会话
• 多 Agent 路由：支持多 Agent 协作
• 工具调用：原生支持工具调用与代码执行

安装 ​

curl -fsSL https://openclaw.ai/install.sh | bash

npm install -g openclaw@latest

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm run build
pnpm run openclaw onboard

安装完成后运行引导向导（手动克隆方式已在上方命令中包含）：

openclaw onboard

配置 ​

配置文件位置 ​

OpenClaw 配置文件位于 ~/.openclaw/openclaw.json：

• macOS: /Users/你的用户名/.openclaw/openclaw.json
• Linux: /home/你的用户名/.openclaw/openclaw.json
• Windows: C:\Users\你的用户名\.openclaw\openclaw.json

如果文件不存在，请先创建：

mkdir -p ~/.openclaw
touch ~/.openclaw/openclaw.json

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw"
New-Item -ItemType File -Force -Path "$env:USERPROFILE\.openclaw\openclaw.json"

配置文件结构 ​

openclaw.json 的整体结构分为两大部分：

{
  "models": {
    "mode": "merge",
    "providers": {
      // 配置 AI 模型提供商
    }
  },
  "agents": {
    "defaults": {
      // 配置默认模型、工作目录等
    }
  }
}

• models.providers — 定义服务提供商，包括地址、Key、模型列表
• models.mode — 设为 "merge" 时，自定义配置会与内置默认配置合并，强烈建议始终加上
• agents.defaults.model.primary — 默认使用的模型，格式为 provider名称/模型ID
• api — API 协议类型，Anthropic 模型用 "anthropic-messages"，OpenAI 兼容模型用 "openai-responses"

配置方式 ​

配置 Anthropic（Claude）模型 ​

将以下内容写入 openclaw.json：

{
  "models": {
    "mode": "merge",
    "providers": {
      "nbility-anthropic": {
        "baseUrl": "https://nbility.dev",
        "apiKey": "sk-你的NBility-Token",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "nbility-anthropic/claude-opus-4-6"
      }
    }
  }
}

配置 OpenAI（GPT）模型 ​

通过 NBility 调用 OpenAI 模型时，api 字段须设为 openai-responses：

{
  "models": {
    "mode": "merge",
    "providers": {
      "nbility-openai": {
        "baseUrl": "https://nbility.dev/v1",
        "apiKey": "sk-你的NBility-Token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "nbility-openai/gpt-5"
      }
    }
  }
}

同时配置 Anthropic + OpenAI（推荐） ​

在 models.providers 下并列添加两个 provider，即可同时使用两家模型：

{
  "models": {
    "mode": "merge",
    "providers": {
      "nbility-anthropic": {
        "baseUrl": "https://nbility.dev",
        "apiKey": "sk-你的NBility-Token",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          },
          {
            "id": "claude-sonnet-4-5-20250929",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 8192,
            "reasoning": false
          }
        ]
      },
      "nbility-openai": {
        "baseUrl": "https://nbility.dev/v1",
        "apiKey": "sk-你的NBility-Token",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          },
          {
            "id": "gpt-5-codex",
            "name": "GPT-5 Codex",
            "input": ["text", "image"],
            "contextWindow": 200000,
            "maxTokens": 16384,
            "reasoning": true
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "nbility-anthropic/claude-opus-4-6",
        "fallbacks": [
          "nbility-anthropic/claude-sonnet-4-5-20250929",
          "nbility-openai/gpt-5"
        ]
      }
    }
  }
}

切换默认模型时，只需修改 model.primary 的值：

• "nbility-anthropic/claude-opus-4-6" → Claude Opus 4.6
• "nbility-anthropic/claude-sonnet-4-5-20250929" → Claude Sonnet 4.5
• "nbility-openai/gpt-5" → GPT-5
• "nbility-openai/gpt-5-codex" → GPT-5 Codex

关键字段说明 ​

| 字段 | 含义 | Anthropic（Claude） | OpenAI（GPT） | |

生效日期：2026年2月11日

NBility 严格遵守《中华人民共和国个人信息保护法》、《网络安全法》、《数据安全法》及相关法律法规。

一、我们收集哪些信息及用途 ​

| 场景 | 收集内容 | 用途 | |

在 VSCode 中安装 RooCode ​

1. 在 VSCode 中搜索 RooCode 并安装
2. 访问 https://nbility.dev/console/token 获取你的 API Key

新增提供商 ​

完成 RooCode 安装后，打开 RooCode，选择配置提供商，新增一个 OpenAI Compatible 的供应商：

| 配置项 | 值 | |

首次使用？请先完成 账户注册与充值。

一、环境准备 ​

安装 Node.js ​

Claude Code 通过 npm 安装，需先确认 Node.js 已就绪。

node -v
npm -v

brew install node

node -v
npm -v

若未安装，前往 nodejs.org/zh-cn/download 下载对应平台安装包，安装完成后 Windows 需重启。

Windows 额外：安装 Git Bash ​

Claude Code 依赖 bash 运行环境，Windows 用户需安装 Git Bash：

1. 下载地址：git-scm.com/install/windows，选择对应版本安装。
2. 验证：右键桌面，出现 Open Git Bash here 选项即安装成功。

生效日期：2026年2月11日

1. 总则 ​

本协议由使用 NBility API 聚合平台（以下简称"提供方"、"NBility"或"公司"）服务的实体或个人（以下简称"用户"或"您"）与 NBility 共同缔结。本协议包括协议正文、隐私政策及其他相关政策和公告。您承诺具备完全民事行为能力（年满十八周岁）以订立本协议。若您代表某一法律实体，须保证拥有充分授权。

2. 定义 ​

| 术语 | 含义 | |

ZCF 是 Claude Code / Codex 的零配置增强工具，zcf init 一条命令完成 API 配置、工作流导入、MCP 服务集成等全部初始化。

没有账号？先完成 账户注册 获取 API Key。