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

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

16213

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

本指南将帮助您在应创千云平台上一键部署 OpenClaw，并快速接入自定义大模型服务。无论您是 AI 应用开发者，还是希望拥有个人智能助手的爱好者，都能通过本指南轻松上手。

1. OpenClaw 简介

OpenClaw（原 Moltbot/Clawdbot）是一个开源、可扩展的个人 AI 助手平台。支持通过终端、Web 界面、钉钉、飞书等多种渠道与 AI 模型交互，并提供灵活的配置机制，可自由接入任意兼容 OpenAI API 格式的大模型服务。

应创千云为您提供 OpenClaw 的集成部署与优化服务，助您快速构建稳定、安全的智能应用。

2. 准备工作

部署前请确保已准备以下内容：

  • 一台运行 Linux/macOS 的服务器或个人电脑（Windows 用户推荐使用 WSL2 或 Docker）。

  • 应创千云平台已提供预置 OpenClaw 镜像的服务器，可直接选用。

  • Node.js v22.0 或更高版本（安装脚本会自动安装，已有环境建议提前确认版本）。

  • 大模型服务 API Key：需准备兼容 OpenAI API 格式的模型服务（自建 vLLM 或第三方云服务均可），并获取有效 API Key 和接口地址。

  • 具备基础命令行操作能力（终端执行命令、编辑文件）。

如需一键部署 OpenClaw + 模型服务全套环境，可直接联系应创千云技术支持。

3. 在应创千云上一键部署 OpenClaw

应创千云提供预置 OpenClaw 镜像，只需几步即可完成部署。

3.1 选择并开通服务器

  1. 访问 https://yun.stargames.games 并登录。

  2. 在机型列表中选择前缀为 OpenClaw 的机型。

  3. 在镜像市场选择 Ubuntu-OpenClaw 镜像。

  4. 下单并开通服务器，等待创建完成。图片[1]-应创千云-OpenClaw：接入大模型服务完全指南-星游社区

3.2 初始化 OpenClaw

通过 SSH 连接服务器

执行初始化命令，安装守护进程：

bash
openclaw onboard --install-daemon

过程约 3–5 分钟，会自动完成依赖安装与初始配置。

3.3 本地安全访问 OpenClaw Web 界面

OpenClaw 默认仅监听本地 127.0.0.1，不对外暴露，需通过 SSH 隧道安全访问。

第一步：建立 SSH 隧道

本地终端执行：

bash
ssh -N -L 18789:127.0.0.1:18789 root@你的服务器IPV4地址

输入密码后，隧道建立成功（保持终端打开，不要关闭）。

第二步：访问 Web 界面

浏览器打开：

text
http://localhost:18789

在页面中输入初始化时生成的 Token 登录。

安全重要提醒

  • 请勿将 Token 直接拼接在 URL 中分享、截图或保存至浏览器书签，避免泄露。

  • Token 等同于管理员权限，一旦泄露可能导致服务被非法控制。

4. 手动安装 OpenClaw（通用方法）

如需在本地电脑、其他云服务器环境部署，可使用官方一键脚本。

4.1 执行安装命令

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

4.2 安装说明

脚本会自动检测系统并安装：

  • Node.js（无环境时自动安装最新 LTS）

  • 编译工具（make、g++、cmake、python3 等）

全程保持网络畅通。

4.3 初始化配置

安装完成后自动进入交互式配置，推荐选择：

  • I understand this is powerful and inherently risky. Continue? → 输入 Yes

  • Onboarding mode → QuickStart

  • Model/auth provider → Skip for now

  • Filter models by provider → All providers

  • Default model → 使用默认

  • Select channel (QuickStart) → Skip for now

  • Configure skills now? → No

  • Enable hooks? → 按空格取消选中，再选择 Skip for now

  • How do you want to hatch your bot? → Hatch in TUI

如需重新配置：

bash
openclaw config

5. 配置自定义模型服务

OpenClaw 支持接入任意兼容 OpenAI API 格式的模型，推荐使用 Web UI 配置。

5.1 启动 Web 控制台

bash
openclaw dashboard

默认地址：http://localhost:3000（以终端输出为准）。

5.2 进入原始配置编辑器

  1. 左侧菜单点击 Settings（设置）

  2. 选择 All Settings > RAW（原始配置）

5.3 添加自定义模型提供商（最简可运行示例）

在 models.providers 中追加以下配置（不要全量覆盖原有配置）：

json
{
  "models": {
    "mode": "merge",
    "providers": {
      "custom": {
        "baseUrl": "https://api.your-service.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
        "api": "openai-completions",
        "timeout": 1800,
        "models": [
          {
            "id": "your-model-id",
            "name": "自定义大模型",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 8192,
            "maxTokens": 2048
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "custom/your-model-id"
      },
      "models": {
        "custom/your-model-id": {}
      }
    }
  }
}

关键字段说明

  • baseUrl：模型 API 地址，必须以 /v1 结尾

  • apiKey：你的 API Key

  • models.id：模型调用标识（唯一）

  • models.name：界面显示名称

  • timeout：请求超时时间，单位秒（推荐 1800）

  • agents.defaults.model.primary：设置默认模型，格式：提供商/模型ID

关键规范

  • 只追加，不覆盖：已有钉钉/飞书/技能配置时，切勿全量替换配置文件。

  • 模型 ID 必须唯一，不可重复。

  • 流式输出会自动适配，无需额外开启。

5.4 保存并生效

  1. 编辑完成点击右上角 Save

  2. 点击 Update 使配置立即生效，无需重启服务。

6. 服务状态检查与维护

6.1 查看服务状态

bash
systemctl status openclaw-gateway --no-pager

正常显示：active (running)。

6.2 检查端口监听

bash
ss -ltnp | grep 18789

6.3 重启服务（配置修改后）

bash
systemctl restart openclaw-gateway

6.4 查看实时日志

bash
journalctl -u openclaw-gateway -f

6.5 查看当前 Token

bash
openclaw token

7. 配置域名反向代理（可选，生产环境推荐）

如需在外网/手机通过域名访问，推荐使用 Nginx 反代 + BasicAuth 认证，比直接暴露 Token 更安全。

7.1 OpenClaw 配置：启用 trusted-proxy

在 RAW 配置中修改 gateway 节点：

json
"gateway": {
  "mode": "public",
  "host": "127.0.0.1",
  "port": 18789,
  "auth": {
    "mode": "trusted-proxy",
    "trustedProxy": {
      "userHeader": "x-forwarded-user",
      "requiredHeaders": ["x-forwarded-proto", "x-forwarded-host"],
      "allowUsers": ["admin"]
    }
  },
  "trustedProxies": ["127.0.0.1", "::1"]
}

安全说明

  • trustedProxies 仅信任本机反代，严禁设置为 0.0.0.0/0，否则会导致权限绕过。

  • 修改后必须重启服务：systemctl restart openclaw-gateway。

7.2 Nginx 配置示例（支持 HTTPS + BasicAuth + WebSocket）

nginx
server {
    listen 80;
    server_name openclaw.yourdomain.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    server_name openclaw.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    # 基础认证
    auth_basic "OpenClaw Login";
    auth_basic_user_file /etc/nginx/.htpasswd-openclaw;

    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header x-forwarded-user $remote_user;

        # WebSocket
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }
}

7.3 创建 BasicAuth 用户

bash
# 首次创建
htpasswd -c /etc/nginx/.htpasswd-openclaw admin

# 后续添加用户
htpasswd /etc/nginx/.htpasswd-openclaw 用户名

权限修复（若出现 500 权限错误）：

bash
chmod 644 /etc/nginx/.htpasswd-openclaw

7.4 宝塔面板用户

将反代配置放入：

text
/www/server/panel/vhost/nginx/extension/你的域名/*.conf

在站点配置中引入该文件，避免被面板覆盖。

8. 常见问题与故障排查（完整版）

8.1 端口冲突 / Token 不匹配 / 时好时坏

原因：同时运行了多个 OpenClaw 实例（用户态 + 系统态）。

解决：

# 杀死所有 openclaw 进程
pkill -f openclaw

# 只启用系统服务
systemctl restart openclaw-gateway
systemctl enable openclaw-gateway

8.2 WebSocket 1008 unauthorized

原因：反代头缺失或 trusted-proxy 配置不匹配。

检查：

  • Nginx 必须携带：X-Forwarded-Proto、X-Forwarded-Host

  • OpenClaw 中 requiredHeaders 与 Nginx 发送的头完全一致

  • 查看日志：journalctl -u openclaw-gateway -f

8.3 模型调用超时/不回复

原因：上游模型响应慢、网络波动、配置错误。

解决：

  1. 在 providers.custom 中增加 "timeout": 1800

  2. 检查 baseUrl 是否可通、模型 ID 是否正确

  3. 确认服务器 CPU/内存/带宽充足

8.4 Nginx 反代 502 Bad Gateway

原因：OpenClaw 未启动或监听地址错误。

测试本地：

bash
curl http://127.0.0.1:18789

8.5 修改配置后不生效

  • Web UI 修改：必须点 Save → Update

  • 手动改 JSON：必须执行 systemctl restart openclaw-gateway

9. 下一步

  • 在 Web 控制台测试对话、模型切换、参数调优

  • 配置 Skills 技能、Channels 渠道（钉钉/飞书等）

  • 接入业务系统 API，构建企业级 AI 助手

如需进一步支持，可查阅 OpenClaw 官方文档或联系应创千云技术支持。

附录：常用命令速查（正式版）

 
 
操作 命令
查看服务状态 systemctl status openclaw-gateway --no-pager
重启服务 systemctl restart openclaw-gateway
实时日志 journalctl -u openclaw-gateway -f
检查端口 ss -ltnp | grep 18789
查看 Token openclaw token
重新配置 openclaw config

本指南由应创千云团队编写，如有疑问，欢迎联系技术支持。

如果您个人或者企业希望我们为您完成部署与配置，欢迎联系openclaw@stargames.games

© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
技术交流
# AI# AI Agent# openclaw
喜欢就支持一下吧
点赞13 分享
星游社区的头像-星游社区SVIP
社区内容发布规则-星游社区
社区内容发布规则
社区内容发布规则
2年前 127
文档测试-星游社区
文档测试
文档测试
2年前 112
测试分类-新闻-星游社区
测试分类-新闻
测试分类-新闻
2年前 87
网站版本更新2026.1.24-星游社区
网站版本更新2026.1.24
网站版本更新2026.1.24
1个月前 57
如何从2024安全撤离？-星游社区
如何从2024安全撤离？
如何从2024安全撤离？
2年前 48
07月21日，星期日, 每天60秒读懂全世界！-星游社区
07月21日，星期日, 每天60秒读懂全世界！
07月21日，星期日, 每天60秒读懂全世界！
2年前 48
相关推荐
AI半自动化游戏开发工作流设计方案-星游社区
AI半自动化游戏开发工作流设计方案
AI半自动化游戏开发工作流设计方案
1年前 459
Unity入门教程（非常详细）从零基础入门到精通，看完这一篇就够了-星游社区
Unity入门教程（非常详细）从零基础入门到精通，看完这一篇就够了
Unity入门教程（非常详细）从零基础入门到精通，看完这一篇就够了
2年前 350
Sprite精灵实现Pygame矩形、圆形、精细碰撞-星游社区
Sprite精灵实现Pygame矩形、圆形、精细碰撞
Sprite精灵实现Pygame矩形、圆形、精细碰撞
1年前 329
AI编程助手 - Fitten Code（VSCode 版）-星游社区
AI编程助手 - Fitten Code（VSCode 版）
AI编程助手 - Fitten Code（VSCode 版）
2年前 327
更适合英伟达黑粉们的Sana本地部署方案-星游社区
更适合英伟达黑粉们的Sana本地部署方案
更适合英伟达黑粉们的Sana本地部署方案
1年前 276
博弈论入门-星游社区
博弈论入门
博弈论入门
1年前 272
评论 共1条
头像
欢迎您留下宝贵的见解！
提交
头像

昵称

取消
昵称

请填写用户信息：

  • 昵称(必填)
  • 邮箱(必填)
表情
[aoman][baiyan][bishi][bizui][cahan][ciya][dabing][daku][deyi][doge][fadai][fanu][fendou][ganga][guzhang][haixiu][hanxiao][zuohengheng][zhuakuang][zhouma][zhemo][zhayanjian][zaijian][yun][youhengheng][yiwen][yinxian][xu][xieyanxiao][xiaoku][xiaojiujie][xia][wunai][wozuimei][weixiao][weiqu][tuosai][tu][touxiao][tiaopi][shui][se][saorao][qiudale][qinqin][qiaoda][piezui][penxue][nanguo][liulei][liuhan][lenghan][leiben][kun][kuaikule][ku][koubi][kelian][keai][jingya][jingxi][jingkong][jie][huaixiao][haqian][aini][OK][qiang][quantou][shengli][woshou][gouyin][baoquan][aixin][bangbangtang][xiaoyanger][xigua][hexie][pijiu][lanqiu][juhua][hecai][haobang][caidao][baojin][chi][dan][kulou][shuai][shouqiang][yangtuo][youling]
代码

请输入代码：

确认
图片
快捷回复
谢谢你的分享，我从中学到了很多！
教程很好用，谢谢！
好东西，学习一下！
楼主听话，快到碗里来！
路过一下，我只是来打酱油的！
水帖美如花，养护靠大家！

    暂无评论内容

搜索
开启精彩搜索
用户封面
星游社区的头像-星游社区SVIP
社区内容发布规则-星游社区
社区内容发布规则
社区内容发布规则
2年前 127
文档测试-星游社区
文档测试
文档测试
2年前 112
测试分类-新闻-星游社区
测试分类-新闻
测试分类-新闻
2年前 87
网站版本更新2026.1.24-星游社区
网站版本更新2026.1.24
网站版本更新2026.1.24
1个月前 57
如何从2024安全撤离？-星游社区
如何从2024安全撤离？
如何从2024安全撤离？
2年前 48
07月21日，星期日, 每天60秒读懂全世界！-星游社区
07月21日，星期日, 每天60秒读懂全世界！
07月21日，星期日, 每天60秒读懂全世界！
2年前 48