书接上一篇文章：Hermes Agent开启可视化仪表盘小白指南，老马总算是把Open WebUI跑起来了，因此这个坑也赶紧填上。

按照Hermes Agent的官方文档介绍，Open WebUI属于高级层次的可视化聊天界面方案，本身它是一个开源的大模型托管平台。

使用上跟Cherry Studio和Chatbox没什么区别，无非是把本地软件换成了网页版，在网页上操作对接各大模型，然后进行聊天交互。

对于不想使用Hermes终端，或者对接飞书、QQ、微信Clawbot等机器人进行聊天的小伙伴来说，本地网页版的Open WebUI算是一种不错的可视化选择。

下面直接开始实操，部分步骤跟上一篇文章相似，老马还是会重复介绍一遍。还是提前声明一下，老马的Hermes不是安装在Mac或Linux系统上。

而是原生Windows系统+WSL虚拟机的方式，同时没有在WSL上额外安装Linux系统，所以经常会有一些兼容性问题的出现。

这些问题你们不一定会遇到，尤其是在Mac和Linux系统上安装的。假如没有报错，那就可以跳过老马排错的部分，避免自己搞混淆。

安装Docker软件

按照Hermes官方文档介绍的安装方法，Open WebUI是运行在Docker容器上的，因此我们先要安装Docker软件。

Windows跟Mac的安装比较简单，都有对应的软件安装包，电脑浏览器打开Docker Desktop官网：
https://www.docker.com/products/docker-desktop进行下载，随后按正常软件去安装即可：

如果你安装的Linux系统是Ubuntu（乌班图）这类带桌面环境的，其实使用方式跟Windows也差不多，你同样可以下载软件安装包进行安装。

或者通过命令行窗口的方式，输入命令的形式去安装。老马将查询到的全新Linux系统安装Docker的方法列举如下：

1.设置Docker的apt仓库

# 更新包索引并安装依赖
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
# 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
# 设置稳定版仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

2.安装Docker Engine

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

3.配置非root用户权限

sudo usermod -aG docker $USER
newgrp docker

4.验证安装是否成功

sudo docker run hello-world

另外Linux系统安装Docker的方法，你问一下千问，都会有详细的方法。包括你在安装过程中，遇到什么报错问题，同样可以发给千问寻找答案。

豆包的话相对来说幻觉会多一些，千问还是比较好用的。安装Docker之后，以Windows系统为例，打开运行Docker Desktop软件：

如图所示就是正常在运行中了，我们保持Docker Desktop软件处于一直运行中的状态，因为等下要拉取镜像和启动容器。

然后，新开启一个Powershell的窗口，输入hermes命令后回车，启动hermes的终端窗口备用：

Open WebUI配置运行

接下来找到你的Hermes配置目录，以Windows 11系统为例，一般位于：C:\Users\你的用户名\AppData\Local\hermes，在此目录下有一个.env的环境变量配置文件，使用记事本或其它文件编辑器打开：

如上图所示，在文件内容的末尾，添加下面两行配置：

API_SERVER_ENABLED=true

API_SERVER_KEY=你设置的密钥

其中API_SERVER_KEY=你设置的密钥，比如老马这里设置的是12345678。密钥长度一定要超过8个字符，这点别搞错了。

添加完配置后，保存.env文件。然后打开一个新的Powershell窗口，运行以下命令：

hermes gateway run -vv

这行命令是为了启动Hermes网关和API服务器，正常来说Hermes是不会报错的，除非是一些Windows系统的兼容性问题。

如果有报错，你就把日志复制一下，通过刚才已经打开的Hermes终端窗口，发送过去，让它自己修复自己。

运行以上命令之后，网关正常启动，你就可以看到一行： http://127.0.0.1:8642 (model: hermes-agent)的字样：

这说明API服务器已经成功启动。接下来，我们继续回到Hermes的终端窗口，输入以下命令，要求Hermes去拉取Open WebUI的镜像，并启动相应的容器：

运行以下命令拉取open webui镜像，并启动运行open webui容器：

docker run -d -p 3000:8080 \

-e OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1 \

-e OPENAI_API_KEY=12345678 \

–add-host=host.docker.internal:host-gateway \

-v open-webui:/app/backend/data \

–name open-webui \

–restart always \

ghcr.io/open-webui/open-webui:main

千万记得，上面内容中的OPENAI_API_KEY=，要改成你自己设置的API密钥。前面提到过了，其实就是API_SERVER_KEY=，老马是设置成了12345678，你上面设置成什么，就改成什么。

如上图所示，镜像拉取成功，容器也已经成功启动。这里面有5个细节要点需要说明一下：

1.如果显示镜像一直正在拉取中，切记耐心等待。镜像文件比较大，大概两个G左右。一般都得下载十几分钟甚至半个小时，具体看你网络环境，不可能一下子就拉取完。

2.如果镜像提示拉取失败，不用着急，重新给Hermes发送命令，让它继续拉取下载。基本上多试几次，就能把镜像拉取完整成功。实在尝试了多次无法拉取的情况下，可以开启全局魔法代理试试。

3.只要镜像拉取成功，下一步就是启动容器。启动容器也有可能第一次启动不成功，还是老方法，继续让Hermes去尝试重启。

4.容器启动成功后，有些小伙伴用http://localhost:3000的地址打不开网页。那就换成http://127.0.0.1:3000这个地址去打开访问。

5.如果访问以上地址提示500: Internal Error，可以把这个错误提示通过终端发送给Hermes，让它自己去排查原因解决。

一般这种情况就是模型文件还未下载完成，得继续等待。你也可以要求Hermes跳过模型下载的任务，重新启动容器。

通过电脑浏览器打开访问http://127.0.0.1:3000后，第一次会让你设置一个用户的信息，这个就是管理员的账号信息，按提示去设置用户名、电子邮箱跟密码即可，设置完毕就直接登录Open WebUI：

第一次打开Open WebUI的网页之后，你会发现其实就跟网页版的豆包、千问，以及电脑桌面版本的Cherry Studio啥的没区别。

还有个问题，在左上角点击选择模型，可能默认是没有模型给你选择的：

你就点击管理连接，进入连接的设置页面，在OpenAI接口的最右边点击齿轮的按钮：

打开了编辑连接页面后，在底部找到添加模型ID的地方，输入hermes-agent，再点右边的+号按钮进行添加：

最后点击保存按钮进行保存，这样子模型就添加上去了。在左侧菜单栏中点击新对话，这个时候你就会发现，左上角的模型默认已经选择成hermes-agent：

下一步就可以在对话框中输入问题，跟Hermes进行聊天了。比如老马这里是发送了“你是谁”，很快就收到了Hermes的回复：

至此，你就成功搞定了Open WebUI的部署与开启。以后你想再次使用Open WebUI，就可以直接在终端里面告诉Hermes，启动Open WebUI的容器服务。

然后你再新开一个Powershell的窗口，输入上面提到的网关命令，开启Hermes的网关跟API服务器，最后访问Open WebUI的地址http://127.0.0.1:3000，登录自己的管理员账号就行了。

好了，以上就是今天的分享，欢迎关注、点赞、转发一键三连。有任何问题和需求，请在评论区留言，回见！