跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

Docker 部署 OpenClaw:Web UI 访问、飞书配对及模型配置

总结了 Docker 部署 OpenClaw 时遇到的三个核心问题及其解决方案。首先解决了 Web UI 无法访问的跨域(CORS)配置问题,通过修改配置文件允许通配符来源。其次处理了飞书机器人配对码刷新导致失败的问题,指导使用 CLI 命令查看并授权最新配对请求。最后提供了接入公司自定义大模型节点的配置方法,通过修改 agents 和 models 节点实现本地模型调用。

锁机制发布于 2026/4/6更新于 2026/9/1080 浏览

本文整理了 Docker 部署 OpenClaw 时的典型环境与配置问题,涵盖 Web UI 访问、飞书配对及自定义模型配置的核心排查思路与解决方案。


一、问题一:安装成功但 Web UI 无法访问

1. 现象描述

  • 终端提示安装成功,但在浏览器中访问 http://127.0.0.1:18789 时,页面提示连接被重置。
  • 使用具体的局域网 IP(如 192.168.5.30:18789)访问时,同样提示无法连接或无法访问此网站。

alt

2. 原因分析

  • 在排除了代理服务器和系统防火墙的干扰后,根本原因在于 OpenClaw 核心网关的跨域访问(CORS)安全机制。
  • 系统默认包含白名单配置,它的作用是告诉 OpenClaw 的核心网关:'只有从这些特定的网址(域名或 IP)打开的控制台网页,才被允许连接我并下发控制指令'。

3. 解决方案

修改 OpenClaw 的配置文件 ~/.openclaw/openclaw.json,在 gateway.controlUi.allowedOrigins 节点中加上 * 作为通配符(或添加你实际访问的 URL)。具体配置参考如下:

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
      "allowedOrigins": [
        "*"
      ],
      "dangerouslyDisableDeviceAuth": true
    }
  }

}

二、问题二:飞书机器人配对失败与配对码刷新

1. 现象描述

  • 在系统内设置了飞书 Channel 后,通过飞书机器人发送消息没反应,系统提示未配对,并给了一个配对码。
  • 给飞书发送多次消息,配对码会不断发生改变。

alt

2. 解决方案

由于多次发消息导致配对码不断刷新,我们需要通过后台 CLI 指令直接查看并抓取最新、最准确的配对请求进行手动授权。

  1. 查看最新的飞书配对请求:执行 docker compose run --rm openclaw-cli pairing list feishu 命令查看当前的配对列表。

alt

  1. 获取正确配对码:在输出的表格中,找到最新的配对码(例如:ZLX3M556)。
  2. 执行授权配对:拿到正确的配对码后,执行 docker compose run --rm openclaw-cli pairing approve feishu ZLX3M556 命令通过审批。当日志输出类似 Approved feishu sender ou_... 后,即代表授权成功。

alt


三、进阶配置:接入公司自行配置的大模型

OpenClaw 支持灵活地接入公司自己配置的大模型节点。配置 Agent 的方法同样是修改 ~/.openclaw/openclaw.json 文件。

以下是接入公司自行配置的、提供 MiniMax 模型的高速自定义节点的配置示例:

{
  "agents": {
    "defaults": {
      "model": "yuxiaor/MiniMax-M2.7-highspeed"
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "yuxiaor": {
        "api": "openai-completions",
        "baseUrl": "http://xxxxxxxxxxx/v1",
        "apiKey": "your key",
        "models": [
          { "id": "MiniMax-M2.7-highspeed", "name": "MiniMax 2.7 highspeed" }
        ]
      }
    }
  }
}

配置解析:

  • 在 models.providers 节点下自定义公司自行配置的节点名称(如 yuxiaor),并将其 API 格式指定为兼容性最好的 openai-completions。
  • 填入公司配置节点提供的 baseUrl 和对应的 apiKey。
  • 在 agents.defaults.model 中,将默认模型指向刚才声明的节点与模型名称(如 yuxiaor/MiniMax-M2.7-highspeed)。这样配置并重启后,OpenClaw 默认就会调用公司配置的模型来进行回复了。

alt

目录

  1. 一、问题一:安装成功但 Web UI 无法访问
  2. 二、问题二:飞书机器人配对失败与配对码刷新
  3. 三、进阶配置:接入公司自行配置的大模型

更多推荐文章

查看全部
  • Git 入门:配置、核心概念与文件操作
  • 基于 Llama-Factory 的 ASR 文本后处理实践
  • 蒙特卡罗树搜索 (MCTS) 原理与代码实例
  • 前端国际化最佳实践:让你的网站走向世界
  • JavaWeb 核心:JSON 数据交换与 Ajax 异步请求详解
  • 计算机视觉基础与实战应用指南
  • C++ 异常处理:高效捕获与精准修复
  • Flutter 开发环境配置指南 Windows/Mac
  • OpenClaw 本地部署配置飞书机器人指南
  • 高铁轨道探伤:GLM-4.6V-Flash-WEB 识别钢轨磨损痕迹
  • Raphael AI:基于 Flux 模型的在线 AI 图像生成工具
  • AI 绘画与传统艺术融合:Z-Image-Turbo 辅助创作指南
  • 元宇宙时代下的音视频开发技术趋势与实战路径
  • Ubuntu 24 安装 OpenClaw 报错:systemctl is-enabled unavailable 修复
  • Python 数据分析入门:集中趋势与离散程度
  • 使用剪映专业版 AI 对口型制作真人演唱视频
  • 在 Cursor 中打造专属前端 AI 助手:Agent Skills 实战指南
  • OpenClaw Skills 合集开源:700+ 本地 AI Agent 技能插件盘点
  • OpenClaw 安装部署全流程:搭建你的自托管 AI 助手
  • 在 Windows 上安装与配置 JDK 23 开发环境

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online