应创千云-OpenClaw：接入大模型服务完全指南

选择服务器(https://yun.stargames.games)目前仅支持前缀为OpenClaw的机型--->

选择Ubuntu-OpenClaw镜像--->

下单开通服务器--->

开通服务器后链接SSH--->

输入openclaw onboard --install-daemon进行初始化

搭建完成后本地进行连接

       第一步：本地需要和服务器之间建立一个连接隧道，因为这个服务是在服务器本地运行的，没有开放到公网(也可以设置开放到公网)

                  终端执行 
                  ssh -N -L 18789:127.0.0.1:18789 root@你的服务器IPV4地址
                  然后输入服务器密码回车

       第二步：

                  用初始化的token凭证访问网站，http://localhost:18789/#token=xxxxxxxxxxxxxxxxxxxxxxxxxx，类似这样

       提示：

       配置API可以在终端配置也可以在后台进行配置

其他配置请查看=包括内容

公网访问设置请查看最下面内容

===================================================================================

1. 什么是 OpenClaw？

OpenClaw（原名 Moltbot/Clawdbot）是一个开源的个人 AI 助手平台，支持通过终端、Web、钉钉等多种渠道与 AI 模型交互。我们为您提供OpenClaw的集成部署与优化服务，助您快速构建智能应用。

2. 准备工作

在开始安装和配置之前，请确保您已准备好以下内容：

一台运行 Linux/macOS 的服务器或个人电脑**（Windows 用户可使用 WSL 或 Docker）。
Node.js v22.0 或更高版本**（安装脚本会自动安装，但如果您已有环境，建议提前确认版本）。
大模型服务的 API Key**：您需要一个兼容 OpenAI API 格式的模型服务（如自行部署的 vLLM、或第三方云服务），并获取有效的 API Key 和接入点地址。
基本的命令行操作能力（会使用终端执行命令、编辑文件）。

如需一键部署OpenClaw及模型服务，欢迎联系我们的技术支持团队。

3. 安装 OpenClaw

OpenClaw 官方提供了一键安装脚本，支持 macOS 和 Linux。Windows 用户建议使用 WSL 或 Docker。

3.1 执行安装命令

打开终端，运行以下命令：

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

3.2 安装过程说明

• 脚本会自动检测系统类型，安装必要的依赖（如 Node.js、build tools）。

• 如果系统缺少 Node.js，脚本会通过 NodeSource 自动安装最新 LTS 版本。

• 如果缺少编译工具（如 make、g++、cmake、python3），也会一并安装。

• 整个过程约需 3-5 分钟，请保持网络畅通。

3.3 安装后初始化配置

安装完成后，终端会自动进入交互式配置界面，您需要根据提示完成初始设置。参考以下配置项填写（如果不太确定，可直接按推荐值选择）：

💡 提示：如果您不小心退出了配置界面，可以随时通过命令 openclaw config 重新进入。

配置完成后，OpenClaw 会以 TUI（终端用户界面）模式启动。您可以先退出（按 Ctrl+C），因为我们还需要接入自己的模型服务。

4. 在 OpenClaw 中配置自定义模型服务

OpenClaw 支持通过 providers 配置接入任意兼容 OpenAI API 格式的服务。您需要将您的服务接入信息添加到配置文件中。

OpenClaw 的配置以 JSON 格式存储，您可以通过 Web UI 或直接编辑配置文件来修改。推荐使用 Web UI 方式，更加直观。

方式一：通过 Web UI 修改配置（推荐）

4.1 启动 Web 控制台

在终端中执行以下命令：

openclaw dashboard

这会启动一个本地 Web 服务，默认地址为 http://localhost:3000（具体端口以终端输出为准）。在浏览器中打开该地址。

4.2 进入 Raw JSON 编辑器

• 在左侧菜单栏中，点击 配置（Settings）。

• 然后选择 All Settings > RAW（原始配置编辑器）。

此时您会看到一个 JSON 编辑框，里面是 OpenClaw 的完整配置。

4.3 添加自定义 Provider 配置

在 models.providers 对象中，您需要添加一个自定义的 provider（例如命名为 custom），并按照以下模板填写：

{
  "models": {
    "mode": "merge",
    "providers": {
      "custom": {
        "baseUrl": "https://api.your-service.com/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "your-model-id-1",
            "name": "your-model-name-1",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 8192,
            "maxTokens": 2048
          },
          {
            "id": "your-model-id-2",
            "name": "your-model-name-2",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 32768,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom/your-model-id-1"
      },
      "models": {
        "custom/your-model-id-1": {},
        "custom/your-model-id-2": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

关键字段说明：

⚠️ 重要：

• 将 baseUrl 和 apiKey 替换为您的实际值。

• 根据您服务的实际模型情况填写 models 数组，每个模型都需要有一个唯一的 id。

• 如果您的服务支持流式输出，OpenClaw 会自动启用。

如果您已经配置过其他渠道（如钉钉、飞书等），请勿直接全量替换已有配置，而是将上述 custom provider 的内容合并到现有配置的对应位置（models.providers、agents.defaults.models 等）。

4.4 保存并应用配置

• 编辑完成后，点击右上角的 Save 按钮保存配置。

• 然后点击 Update 使新配置生效。

• 保存后，<code style="box-sizing: border-box; -webkit-font-smoothing: auto; margin: 0px 10px; padding: 0px 12px; font-family: Cour