OpenClaw 集成图灵平台指南

OpenClaw 是一个开源的个人 AI 助手平台，支持通过多种消息渠道与 AI 交互。通过配置可接入图灵平台的各种强大模型。

关于 OpenClaw

OpenClaw 原名 Moltbot/Clawdbot，部分命令可能尚未完成迁移。如果在使用新命令（如 openclaw dashboard）时遇到 command not found: openclaw 的错误，请切换回旧命令（如 clawdbot dashboard 或 moltbot dashboard）来执行操作。

前置要求

在开始之前，请确保：

已获得图灵平台的 API 密钥
已安装 Node.js 22 或更高版本

快速开始

1. 检查 Node.js 版本

OpenClaw 需要 Node.js 22 或更高版本。使用以下命令检查版本：

node --version

如果未安装或版本过低，请访问 Node.js 官网下载安装。

2. 安装 OpenClaw

macOS / Linux
Windows

推荐使用官方安装脚本：

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

或通过 npm 全局安装：

npm install -g openclaw@latest

通过 npm 全局安装：

npm install -g openclaw@latest

安装完成后，验证安装：

openclaw --version

命令兼容性

如果 openclaw 命令不可用，可以尝试使用 clawdbot 或 moltbot 命令。

3. 初始化配置

首次安装后，运行初始化配置向导：

openclaw onboard

在配置向导中，按照以下建议进行配置：

配置项	示例选择	说明
I understand this is powerful and inherently risky. Continue?	`Yes`	确认继续配置
Onboarding mode	`QuickStart`	快速配置模式
Model/auth provider	`Custom Provider`	选择自定义提供商
API Base URL	`https://live-turing.cn.llm.tcljd.com/api/v1`	图灵平台 API 地址
How do you want to provide this API key?	`Paste API key now`	直接粘贴 API 密钥
API Key	输入你的图灵平台 API 密钥	从图灵平台获取的密钥
Endpoint compatibility	`OpenAI-compatible`	选择 OpenAI 兼容模式
Model ID	`minimax-m3`	填入要使用的模型 ID；可先用示例模型验证，更多可用模型见模型列表
Endpoint ID	`eaglelab`	自定义提供商的唯一标识符，可以填任意名称。此名称将作为 `models.providers` 的 key，并在 `agents` 配置中用作模型路径的前缀（见下方说明）
Model alias (optional)	`minimax-m3`（可选）	模型的别名，方便识别
Filter models by provider	`All providers`	显示所有提供商的模型
Default model	`Keep current`	保持当前选择
Select channel (QuickStart)	`Skip for now`	稍后配置渠道
Configure skills now?	`No`	稍后配置技能
Enable hooks?	按空格键选中需要的选项	根据需要选择
How do you want to hatch your bot?	`Do this later`	稍后配置

Endpoint ID 与模型路径的关系

onboard 向导中填写的 Endpoint ID 即为 models.providers 中的 provider key。在 agents 配置里，模型路径的格式为：

{Endpoint ID}/{Model ID}

示例：

Endpoint ID	Model ID	agents 中的模型路径
`eaglelab`	`minimax-m3`	`eaglelab/minimax-m3`

因此，在下方配置示例中，"agents" 部分的 "primary" 和 "models" 中的 key 都需要使用 {Endpoint ID}/{Model ID} 的完整格式。

重要提示

请妥善保管你的 API 密钥，不要泄露给他人
API 密钥将被保存在本地配置文件中（~/.openclaw/openclaw.json）

配置图灵平台模型

OpenClaw 提供了两种配置方式，你可以选择更适合自己的方式。

方式一：Web 控制台配置

OpenClaw 提供了基于 Web 的编辑器来修改 openclaw.json 配置文件。

1. 启动 Web 控制台

在终端中运行以下命令：

openclaw dashboard

浏览器会自动打开 OpenClaw 的控制台页面（通常是 http://127.0.0.1:18789）。如果浏览器没有自动打开，请手动访问该地址。

2. 进入配置页面

在左侧菜单栏中依次选择：Config > Authentication，点击菜单下方的 Raw。

3. 添加图灵平台配置

在配置编辑器中，找到 "agents": {...} 部分，替换 "models" 和 "agents" 这两个部分，并将 YOUR_TURING_API_KEY 替换为你的图灵平台 API 密钥。

Endpoint ID 说明

"models": { "providers": { ... } } 中的 key（下例中为 "eaglelab"）就是 Endpoint ID。在 "agents" 部分，模型路径必须写成 {Endpoint ID}/{Model ID} 的形式。

本例 Endpoint ID 为 eaglelab，Model ID 为 minimax-m3，所以路径为 eaglelab/minimax-m3
如果你的 Endpoint ID 是 my-provider，Model ID 是 minimax-m3，则路径为 my-provider/minimax-m3

  "models": {
    "mode": "merge",
    "providers": {
      "eaglelab": {                        // ← 这里的 key 就是 Endpoint ID，可以自定义
        "baseUrl": "https://live-turing.cn.llm.tcljd.com/api/v1",
        "apiKey": "YOUR_TURING_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "minimax-m3",
            "name": "MiniMax M3",
            "input": ["text", "image"],
            "contextWindow": 1048576,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "eaglelab/minimax-m3"     // ← 格式：{Endpoint ID}/{Model ID}
      },
      "models": {
        "eaglelab/minimax-m3": {             // ← 同上，使用 {Endpoint ID}/{Model ID} 作为 key
          "alias": "minimax-m3"
        }
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },

4. 保存并应用配置

配置完成后，单击右上角 Save 保存配置，然后单击 Update 使配置生效。

方式二：手动编辑配置文件

如果你更习惯直接编辑配置文件，可以按以下步骤操作。配置文件位于 ~/.openclaw/openclaw.json，OpenClaw 启动时会自动读取。

1. 打开配置文件

使用文本编辑器打开配置文件。如果文件不存在，编辑器会自动创建：

# 使用 nano 编辑器
nano ~/.openclaw/openclaw.json

# 或使用 vim 编辑器
# vim ~/.openclaw/openclaw.json

2. 添加图灵平台配置

在配置文件中，找到 "agents": {...} 部分，替换 "models" 和 "agents" 这两个部分，并将 YOUR_TURING_API_KEY 替换为你的图灵平台 API 密钥。

Endpoint ID 说明

"models": { "providers": { ... } } 中的 key（下例中为 "eaglelab"）就是 Endpoint ID。在 "agents" 部分，模型路径必须写成 {Endpoint ID}/{Model ID} 的形式。

本例 Endpoint ID 为 eaglelab，Model ID 为 minimax-m3，所以路径为 eaglelab/minimax-m3
如果你的 Endpoint ID 是 my-provider，Model ID 是 minimax-m3，则路径为 my-provider/minimax-m3

  "models": {
    "mode": "merge",
    "providers": {
      "eaglelab": {                        // ← 这里的 key 就是 Endpoint ID，可以自定义
        "baseUrl": "https://live-turing.cn.llm.tcljd.com/api/v1",
        "apiKey": "YOUR_TURING_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "minimax-m3",
            "name": "MiniMax M3",
            "input": ["text", "image"],
            "contextWindow": 1048576,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "eaglelab/minimax-m3"     // ← 格式：{Endpoint ID}/{Model ID}
      },
      "models": {
        "eaglelab/minimax-m3": {             // ← 同上，使用 {Endpoint ID}/{Model ID} 作为 key
          "alias": "minimax-m3"
        }
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },

3. 保存配置文件

如果使用 nano 编辑器：

按 Ctrl+X 退出编辑器
提示保存时按 Y 确认
按 Enter 确认文件名

如果使用 vim 编辑器：

按 Esc 确保退出插入模式
输入 :wq 并按 Enter 保存并退出

4. 验证配置

可以使用以下命令查看配置文件内容，确认配置正确：

cat ~/.openclaw/openclaw.json

配置说明

配置项	说明
`baseUrl`	图灵平台 API 地址：`https://live-turing.cn.llm.tcljd.com/api/v1`
`apiKey`	图灵平台 API 密钥，从图灵平台 Portal 申请获取
`api`	API 类型，使用 `openai-completions` 表示 OpenAI 兼容接口
`models`	可用的模型列表，包含模型 ID、名称、输入类型、上下文窗口等信息；模型 ID 以模型列表为准
`agents.defaults.model.primary`	默认使用的主模型，格式为 `{Endpoint ID}/{Model ID}`。其中 Endpoint ID 是 `models.providers` 中定义的 provider key，例如 `eaglelab/minimax-m3`
`gateway.mode`	网关模式，`local` 表示本地模式
`gateway.auth`	认证配置，用于 Web 控制台访问

开始对话

配置完成后，你可以通过以下方式使用 OpenClaw：

命令行界面（TUI）

在终端中启动交互式界面：

openclaw tui

这是最常用的交互式界面，支持实时对话和命令执行。

Web 控制台

启动 Web 界面进行配置和对话：

openclaw dashboard

浏览器会自动打开控制台页面（通常是 http://127.0.0.1:18789），你可以在 Web 界面中：

进行 AI 对话
切换不同的模型
修改配置参数
查看对话历史

连接聊天工具

OpenClaw 支持多渠道交互，能够通过飞书、Discord等聊天工具，让 AI 助手融入你的日常工作，7x24 小时持续服务。详细配置请参考 OpenClaw 官方文档。

常见问题

问题 1：提示找不到模型或回复为空

请确认：

模型 ID 拼写正确
API 密钥有效且有足够的额度
网络连接正常，能够访问图灵平台 API

问题 2：执行 openclaw 命令时提示 "command not found"

可能的原因和解决方案：

OpenClaw 安装未成功：执行 openclaw --version，若输出版本号则安装成功
命令未迁移完成：尝试使用旧命令 moltbot 或 clawdbot 替代
需要重新安装：运行 npm install -g openclaw@latest 重新安装最新版本

问题 3：配置文件在哪里？

OpenClaw 的配置文件位于：

配置文件：~/.openclaw/openclaw.json
日志文件：~/.openclaw/logs/

你可以直接编辑配置文件来修改设置。

使用技巧

1. 在 Web 控制台中切换模型

启动 Web 控制台：

openclaw dashboard

在控制台界面中，你可以：

在设置页面切换不同的模型
查看模型的详细信息和能力
配置对话参数（温度、最大 Token 等）

2. 使用命令行快速对话

如果你只需要快速提问，可以使用 TUI 模式：

openclaw tui

3. 集成到聊天工具

OpenClaw 支持集成到钉钉、企业微信等聊天工具，让 AI 助手 7x24 小时为你服务。详细配置请参考 OpenClaw 官方文档。

参考资源

技术支持

遇到问题？请访问技术支持与联系方式获取帮助。

← 返回 AI 编程工具概述

前置要求​

快速开始​

1. 检查 Node.js 版本​

2. 安装 OpenClaw​

3. 初始化配置​

配置图灵平台模型​

方式一：Web 控制台配置​

1. 启动 Web 控制台​

2. 进入配置页面​

3. 添加图灵平台配置​

4. 保存并应用配置​

方式二：手动编辑配置文件​

1. 打开配置文件​

2. 添加图灵平台配置​

3. 保存配置文件​

4. 验证配置​

配置说明​

推荐模型​

开始对话​

命令行界面（TUI）​

Web 控制台​

连接聊天工具​

常见问题​

问题 1：提示找不到模型或回复为空​

问题 2：执行 openclaw 命令时提示 "command not found"​

问题 3：配置文件在哪里？​

使用技巧​

1. 在 Web 控制台中切换模型​

2. 使用命令行快速对话​

3. 集成到聊天工具​

参考资源​

技术支持​

返回​