🦞 OpenClaw 配置 7Code.cc 教程

OpenClaw 是一个开源（MIT 许可）的自托管网关，可将 WhatsApp、Telegram、Discord、iMessage 等聊天应用连接到 AI 编码代理，支持多代理路由、工具使用和会话记忆。更多信息请参考 OpenClaw 官网。本教程将指导你如何在 OpenClaw 中安装并配置 7Code.cc API。

快速导航

步骤 1：安装 OpenClaw

前置要求

需要 Node.js 22 或更高版本。验证方式：node --version

🍎 macOS / 🐧 Linux

方法一：官方安装脚本（推荐）

自动检测环境并安装所有依赖：

bash

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

方法二：npm

bash

npm install -g openclaw@latest

方法三：pnpm

bash

pnpm add -g openclaw@latest
pnpm approve-builds -g

⊞ Windows

方法一：PowerShell 安装脚本（推荐）

iwr -useb https://openclaw.ai/install.ps1 | iex

方法二：npm（CMD / PowerShell 均可）

bash

npm install -g openclaw@latest

方法三：pnpm

bash

pnpm add -g openclaw@latest
pnpm approve-builds -g

初始化

安装完成后，运行初始化向导：

bash

openclaw onboard --install-daemon

注意

更多安装方式（Docker、从源码构建等）请参考 OpenClaw 官方文档。

步骤 2：获取 API 密钥

访问 7Code.cc 控制台，创建一个新的令牌：

点击「添加令牌」
名称：随便填写，方便自己区分即可
令牌分组：根据实际需要选择，分组有详细描述（必填项，不能留空）
额度建议：设置为无限额度

创建成功后，复制令牌备用。

步骤 3：配置 OpenClaw

配置文件位置

系统	路径
macOS / Linux	`~/.openclaw/openclaw.json`
Windows	`%USERPROFILE%\.openclaw\openclaw.json`

注意

如果文件不存在，可以手动创建。首次运行 openclaw doctor 也会自动生成默认配置。

7Code.cc 配置示例

在 openclaw.json 中添加或修改以下内容：

json

{
  "meta": {
    "lastTouchedVersion": "2026.2.3-1",
    "lastTouchedAt": "2026-02-06T10:08:26.053Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-06T10:06:14.214Z",
    "lastRunVersion": "2026.2.3-1",
    "lastRunCommand": "doctor",
    "lastRunMode": "local"
  },
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "model": {
        "primary": "7code-claude/claude-opus-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "7code-claude": {
        "baseUrl": "https://ai.7code.cc",
        "apiKey": "你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "User-Agent": "claude-cli/2.0.76 (external, cli)",
          "Authorization": "Bearer 你的API密钥"
        },
        "models": [
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6"
          }
        ]
      },
      "7code-codex": {
        "baseUrl": "https://ai.7code.cc/v1",
        "apiKey": "你的API密钥",
        "api": "openai-completions",
        "headers": {
          "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal",
          "Authorization": "Bearer 你的API密钥"
        },
        "models": [
          {
            "id": "gpt-5.2-codex",
            "name": "gpt-5.2-codex"
          }
        ]
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "保留默认值即可"
    },
    "mode": "local"
  }
}

重要提示

请将 "apiKey" 和 "headers.Authorization" 中的密钥替换为你在 7Code.cc 控制台生成的 API 密钥
Authorization 的格式为 Bearer 你的API密钥（注意 Bearer 后有一个空格）
"gateway.auth.token" 保留默认生成的值即可，无需修改
"agents.defaults.model.primary" 用于设置默认使用的 AI 模型
格式为 provider名称/模型ID，例如：
7code-claude/claude-opus-4-6 或 7code-codex/gpt-5.2-codex

关键配置说明

models.providers.7code-claude — Claude 模型配置：

字段	值	说明
`baseUrl`	`https://ai.7code.cc`	7Code.cc API 地址
`apiKey`	你的 API 密钥	从控制台获取
`api`	`anthropic-messages`	Anthropic 协议，用于 Claude 系列模型
`headers`	自定义请求头	详见下方说明
`models`	模型列表	需要使用的模型

models.providers.7code-codex — Codex 模型配置：

字段	值	说明
`baseUrl`	`https://ai.7code.cc`	7Code.cc API 地址
`apiKey`	你的 API 密钥	从控制台获取
`api`	`openai-completions`	OpenAI 协议，用于 GPT/Codex 系列模型
`headers`	自定义请求头	详见下方说明
`models`	模型列表	需要使用的模型

切换默认模型

修改 agents.defaults.model.primary 即可切换默认模型：

使用 Claude："7code-claude/claude-opus-4-6"
使用 Codex："7code-codex/gpt-5.2-codex"

格式为 provider名称/模型ID。

headers 配置说明

headers 用于自定义 HTTP 请求头：

User-Agent — 客户端标识，Claude 模型使用 claude-cli/...，Codex 模型使用 codex_cli_rs/...
Authorization — 认证头，值为 Bearer 你的API密钥（与 apiKey 填同一个密钥）

可用模型：访问 7Code.cc 模型广场查看所有可用模型。如需添加更多模型，在对应 provider 的 models 数组中追加即可。

步骤 4：启动并验证

配置完成后，先运行诊断命令检查配置是否正确：

bash

openclaw doctor

确认无误后，重启 gateway 使配置生效：

bash

openclaw gateway restart

然后启动 TUI 界面验证配置是否正常：

bash

openclaw tui

如果能正常对话，说明配置成功。

步骤 5：对接 QQ（可选）

如果你希望通过 QQ 与 OpenClaw 交互，可以按照以下步骤完成对接。OpenClaw 官方提供了 QQ 机器人接入页面，整个流程非常简单。

5.1 创建 QQ 机器人

访问 OpenClaw QQ 机器人接入页面，使用 QQ 账号登录
点击页面中的「创建机器人」按钮

5.2 复制机器人凭证

机器人创建成功后，页面会显示以下信息：

AppID — 机器人的唯一标识
AppSecret — 机器人的密钥

同时页面会展示 OpenClaw 原生接入流程，包含需要执行的命令。


> [!CAUTION] 安全提示
> AppSecret 是敏感信息，且不支持明文保存、二次查看。请在创建时立即复制并妥善保管。

### 5.3 在 OpenClaw 侧完成 QQ 配置

根据页面提示，依次执行以下命令：

1. 安装 OpenClaw 社区 QQBot 插件

openclaw plugins install @sliverp/qqbot@latest

2. 配置绑定当前 QQ 机器人（token 值从页面复制）

openclaw channels add --channel qqbot --token "你的Token"

3. 重启网关使配置生效

openclaw gateway restart


### 5.4 两种安装方式

你可以选择以下任一方式执行上述命令：

**方式一：通过 OpenClaw Gateway Dashboard 的聊天界面**

直接在 OpenClaw 的 Web 管理界面中，将页面提供的信息和命令发送给 OpenClaw，它会自动执行安装和配置。


**方式二：通过已接入的 IM 渠道发送**

如果你已经有其他 IM 渠道（如 Telegram、飞书等）连接到 OpenClaw，也可以直接通过该渠道将信息发送给 OpenClaw 完成安装。

<!-- ![通过 IM 发送安装](./openclaw-qq/04.webp) -->

🦞 OpenClaw 配置 7Code.cc 教程 ​

步骤 1：安装 OpenClaw ​

🍎 macOS / 🐧 Linux ​

⊞ Windows ​

初始化 ​

步骤 2：获取 API 密钥 ​

步骤 3：配置 OpenClaw ​

配置文件位置 ​

7Code.cc 配置示例 ​

关键配置说明 ​

步骤 4：启动并验证 ​

步骤 5：对接 QQ（可选） ​

5.1 创建 QQ 机器人 ​

5.2 复制机器人凭证 ​

1. 安装 OpenClaw 社区 QQBot 插件 ​

2. 配置绑定当前 QQ 机器人（token 值从页面复制） ​

3. 重启网关使配置生效 ​

🦞 OpenClaw 配置 7Code.cc 教程

步骤 1：安装 OpenClaw

🍎 macOS / 🐧 Linux

⊞ Windows

初始化

步骤 2：获取 API 密钥

步骤 3：配置 OpenClaw

配置文件位置

7Code.cc 配置示例

关键配置说明

步骤 4：启动并验证

步骤 5：对接 QQ（可选）

5.1 创建 QQ 机器人

5.2 复制机器人凭证

1. 安装 OpenClaw 社区 QQBot 插件

2. 配置绑定当前 QQ 机器人（token 值从页面复制）

3. 重启网关使配置生效