跳到主要内容

OpenClaw

将 OpenClaw 自主智能体（Agent）框架连接到 Open WebUI。

OpenClaw 是一个开源、自托管的自主 AI 智能体框架。它为您的 AI 赋予了“双手”：执行 Shell 命令、读写文件、浏览网页，并与 Telegram, Slack, WhatsApp 等即时通讯平台相连接。

OpenClaw 提供了一个兼容 OpenAI 的 API 端点，这使得 Open WebUI 成为其精美聊天前端的不二之选。有两种不同的集成方式：

方法最适合
API 连接将 Open WebUI 用作 OpenClaw 智能体的完整聊天前端
频道（Channels）插件让 OpenClaw 机器人作为成员参与到 Open WebUI 频道中，与人类进行交互
前提条件
  • 您的机器上已安装了 OpenClaw (快速入门)
  • Node.js 22+ (推荐 24)
  • 拥有受支持 LLM 提供商（Anthropic, OpenAI 等）的 API Key
  • Open WebUI 正在运行（通过 Docker、pip 或桌面应用）
  • 大约需要 15 分钟 来完成此设置

方法 1：API 连接​

将 Open WebUI 用作您的 OpenClaw 智能体的主要对话界面。这是最简单也是最常见的方法。

步骤 1：安装 OpenClaw​

如果您还没有安装 OpenClaw：

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

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

或者通过 npm 安装：

npm install -g openclaw@latest

然后运行引导向导以配置您的 LLM 提供商并命名您的智能体：

openclaw onboard

步骤 2：启用兼容 OpenAI 的 API​

出于安全考虑，默认情况下兼容 OpenAI 的端点是禁用的。请在您的 OpenClaw 配置文件中启用它：

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

如果网关已经处于运行状态，请重启网关以使更改生效。

步骤 3：启动网关​

openclaw gateway

网关默认在 18789 端口启动。验证其是否正常运行：

openclaw gateway status

步骤 4：在 Open WebUI 中添加连接​

  1. 在浏览器中打开 Open WebUI。
  2. 转到 ⚙️ 管理员设置 → 外部连接 → OpenAI。
  3. 点击 ➕ 添加连接。
  4. 输入以下内容：
设置项值
URLhttp://localhost:18789/v1
API Key您的 OpenClaw 网关 Bearer Token
  1. 点击 ✅ 勾选进行验证，然后点击 保存。
在 Docker 中运行 Open WebUI？

将 localhost 替换为 host.docker.internal：

http://host.docker.internal:18789/v1

步骤 5：开始对话！​

您的 OpenClaw 智能体现在应该会出现在模型下拉菜单中。选择它并开始对话。该智能体将能够直接通过 Open WebUI 的界面完全访问其配置的所有工具。

针对特定智能体

OpenClaw 使用模型字段路由到不同的智能体：

模型 ID路由到
openclaw/default您配置的默认智能体
openclaw/<agentId>一个特定的命名智能体

如果您配置了多个智能体，它们将作为独立的“模型”分别呈现在下拉菜单中。

方法 2：频道（Channels）插件​

社区插件

频道（Channels）插件是一个由社区贡献的集成，并不由 Open WebUI 或 OpenClaw 团队进行维护。使用风险自担，如需获取支持请参考 插件仓库。

想要让您的 OpenClaw 智能体作为机器人用户加入 Open WebUI 频道，阅读消息、回复并与人类用户进行互动？您可以使用社区开发的频道插件。

步骤 1：在 Open WebUI 中创建一个 Bot 账号​

  1. 以 管理员 身份登录 Open WebUI。
  2. 转到 管理员面板 → 用户管理。
  3. 为机器人创建一个新用户账户（例如 openclaw-bot@yourdomain.com）。
  4. 将该机器人用户添加到您希望它监听的频道中。
备注

确保在您的 Open WebUI 实例中启用了 频道 功能（管理员设置 → 通用）。

步骤 2：安装插件​

在与您的 OpenClaw 智能体进行的安全对话会话中（通过其内置的仪表盘或终端），输入：

"I want to use the Open WebUI Channels plugin: https://github.com/skyzi000/openclaw-open-webui-channels"

OpenClaw 会自动下载并安装该插件。

步骤 3：配置连接​

告诉您的 OpenClaw 智能体：

"I want to connect to Open WebUI Channels."

它会提示您输入以下内容：

设置项输入什么
Base URL您的 Open WebUI URL (例如 http://localhost:3000)
Email步骤 1 中为 Bot 账号配置的邮箱
PasswordBot 账号密码
Channel IDs(可选) 要监控的具体频道 ID，留空表示监控所有
安全提示

请务必在私密的对话环境中配置凭证。该插件会将凭证保存在 ~/.openclaw/openclaw.json 下的 channels.open-webui 部分中。

步骤 4：验证​

在 Open WebUI 中打开连接的频道，并通过用户名提及机器人（例如 @openclaw-bot）。如果它做出了响应，就说明您已全部配置成功！

OpenClaw 内置仪表盘​

OpenClaw 还包含一个零安装的 Web 仪表盘，用于管理智能体、查看日志以及监控系统资源：

openclaw dashboard

默认在 http://localhost:18789 开启。这是 Open WebUI 的绝佳伴侣。您可以使用仪表盘进行智能体管理，并使用 Open WebUI 进行对话。

故障排除​

连接被拒绝​

  • 确保网关正在运行：openclaw gateway status
  • 验证端口（默认是 18789，而不是 8000 或 11434）
  • 确认您在 URL 末尾附加了 /v1

验证失败且模型不加载​

URL 必须完全是 http://localhost:18789/v1。末尾的 /v1 后缀对于模型发现是必需的。

Docker 网络问题​

如果 Open WebUI 在 Docker 中运行，localhost 将指向容器本身。请改用 host.docker.internal。在没有 Docker Desktop 的 Linux 系统上：

docker run --add-host=host.docker.internal:host-gateway ...

频道 Bot 无响应​

  • 验证机器人用户已被添加到目标频道中
  • 检查在 管理员设置 → 通用 中是否启用了频道功能
  • 确保 OpenClaw 插件配置 (~/.openclaw/openclaw.json) 中机器人的凭证是正确的

了解更多​

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.