1. 为什么要在 OpenClaw 里把 OpenWebUI 的 endpoint 换掉OpenWebUI 是一个基于 Web 的对话界面你可以把它理解成「自己电脑上的 ChatGPT 网页版」它本身不产出模型能力只负责把输入框里的文字打包成请求发给后面配置好的模型服务再把返回的流式内容渲染成对话气泡。适合谁用适合想给团队或自己搭一个统一入口、又不想被单一厂商绑死的开发者。默认情况下OpenWebUI 会去连本地 Ollama或者让你填一个 OpenAI 兼容地址。问题就出在这个「兼容地址」上很多人第一次部署完界面能打开、账号能注册但一发消息就报错或者模型列表空空如也。我在 OpenClaw 环境里跑 OpenWebUI 时最常遇到的场景是容器起来了端口也通了但OPENAI_API_BASE_URL没配对导致前端一直转圈日志里刷Connection refused或者401。这时候要做的不是重装而是把 endpoint 指向一个稳定的统一通道。TaoToken 提供的就是这样一个 OpenAI 兼容入口你只需要改 Base URL、Key 和 Model ID 三件套OpenWebUI 就能把请求发出去并拿到模型列表。这篇指南聚焦 OpenClaw 环境下的完整配置从 docker-compose 到 .env再到一次真实的对话请求验证。核心检索词就是「OpenWebUI 部署指南」和「endpoint 改到 TaoToken」你跟着做就能复现。下面所有配置我都实测过路径和变量名与 OpenWebUI 官方镜像保持一致不会出现「文档写一套、实际跑另一套」的情况。先说清楚一个前提OpenWebUI 的模型接入走的是 OpenAI 兼容协议所以任何支持/v1/chat/completions和/v1/models的服务都能接。TaoToken 的 API 地址是https://taotoken.net/api注意这里不带任何多余路径OpenWebUI 会自动拼/v1。如果你填成https://taotoken.net/api/v1有些版本会重复拼接变成/v1/v1这是后面排障章节要重点讲的坑。2. TaoToken 前置准备Key、Base URL 与模型 ID 三件套在动 OpenWebUI 之前先把「三件套」准备好否则你会在容器里反复重启却不知道错在哪。所谓三件套就是 Base URL、API Key、Model ID。OpenWebUI 的 OpenAI 连接配置里这三项缺一不可而且名字必须对得上。Base URL 填https://taotoken.net/api。这是 OpenAI 兼容层的根地址OpenWebUI 内部会调用${BASE_URL}/v1/models来拉模型列表调用${BASE_URL}/v1/chat/completions来发对话。你不需要手动加/v1加了反而容易出错。API Key 需要你去控制台生成。打开https://taotoken.net/console登录后进入 API Keys 页面新建一个 Key 并复制。这个 Key 只显示一次建议直接写进.env文件而不是贴在聊天记录里。如果你还没注册先走官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content完成账号创建再回到 console 拿 Key。Model ID 是很多人忽略的一步。OpenWebUI 的模型列表是从/v1/models动态拉取的但你在界面上选择模型时实际发送的是模型 ID 字符串。TaoToken 的模型 ID 通常形如claude-sonnet-4-5、gpt-4o这类具体以你账号下/v1/models返回的id字段为准。你可以先用一条 curl 命令确认curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY | head -c 800返回的 JSON 里data数组每一项都有id把它记下来后面填进 OpenWebUI 的模型白名单。如果你只想先跑通不限制模型OpenWebUI 默认会展示所有拉取到的模型。这里有个细节OpenWebUI 的「连接」设置里有一个开关叫「仅显示已配置的模型」或者模型过滤。如果你在.env里写了OPENAI_MODEL_LIST它就会覆盖动态拉取的结果。新手建议先不写这个变量让界面自动展示全部等确认连通后再做白名单收敛。另外TaoToken 的 Coding Plan 适合长期编码和 Agent 场景如果你打算把 OpenWebUI 当成日常编码助手的前端可以了解https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。但本篇只聚焦部署与接入不展开套餐对比。准备好三件套后把它们写进一个临时文件或密码管理器下一步直接进 docker-compose。3. 可复制配置docker-compose 与 .env 完整片段这一节是全文的核心所有片段都可以直接复制。我建议用 docker-compose 而不是docker run因为环境变量多起来之后命令行会变得难以维护而且改一个参数就要重建容器。compose 文件把配置和镜像分离改.env即可。先建目录结构mkdir -p ~/openclaw/openwebui cd ~/openclaw/openwebui然后创建.env文件内容如下。注意OPENAI_API_BASE_URL的值是https://taotoken.net/api不要带尾部斜杠也不要带/v1# .env OPENAI_API_BASE_URLhttps://taotoken.net/api OPENAI_API_KEYsk-你的TaoToken密钥 WEBUI_SECRET_KEY换成一串随机字符串 WEBUI_NAMEOpenClaw-OpenWebUI ENABLE_OPENAI_APItrue OPENAI_API_CONFIGS_JSON{}WEBUI_SECRET_KEY用于加密会话官方镜像不填会自动生成但容器重建后旧会话会失效所以生产环境务必固定。ENABLE_OPENAI_APItrue是显式打开 OpenAI 兼容连接避免某些版本默认关闭。接着创建docker-compose.ymlservices: open-webui: image: ghcr.io/open-webui/open-webui:main container_name: open-webui restart: always ports: - 3000:8080 env_file: - .env volumes: - open-webui-data:/app/backend/data extra_hosts: - host.docker.internal:host-gateway volumes: open-webui-data:这里有几个关键点。env_file把.env注入容器OpenWebUI 启动时会读取OPENAI_API_BASE_URL和OPENAI_API_KEY。extra_hosts是为了在 Linux 上也能用host.docker.internal虽然本篇连的是公网地址但保留它方便你以后接本地服务。数据卷open-webui-data持久化用户、聊天记录和模型缓存删容器不丢数据。如果你更习惯用 JSON 形式在界面里配置OpenWebUI 的「设置 → 连接」里对应的字段是{ openai: { api_base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_ids: [] } }model_ids留空表示展示全部。这个 JSON 和.env二选一即可同时配置时界面值优先。我建议用.env因为容器重建后界面设置可能因为浏览器缓存或数据库状态丢失而.env是声明式的。启动命令docker compose up -d docker compose logs -f open-webui日志里看到Uvicorn running on http://0.0.0.0:8080就说明服务起来了。第一次启动会下载嵌入模型大概几十 MB耐心等一两分钟。4. 验证请求模型列表与一次真实对话容器起来后先别急着开浏览器用命令行验证连通性最直接。第一步验证模型列表这一步走的是 OpenWebUI 后端到 TaoToken 的链路能排除前端缓存干扰curl -s http://127.0.0.1:3000/api/models \ -H Authorization: Bearer 你的WEBUI_TOKEN不过 OpenWebUI 的/api/models需要登录态更简单的办法是直接看容器日志里有没有拉取模型的记录或者进界面看模型下拉框。如果你想要纯后端验证可以直接对 TaoToken 发一次对话请求确认 Key 和 Base URL 没问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字连通}], stream: false }返回里choices[0].message.content应该是「连通」。这一步过了说明三件套正确问题只可能在 OpenWebUI 的配置层。接下来进浏览器http://127.0.0.1:3000注册管理员账号登录后点左下角头像 → 设置 → 连接。你会看到 OpenAI 那一栏已经填好了 Base URL 和 Key来自.env。点旁边的刷新按钮模型下拉框应该出现一列模型 ID。如果没出现点「验证连接」它会实时请求/v1/models。然后新建对话在模型选择器里选一个输入「用一句话解释什么是 OpenWebUI」发送。正常情况下你会看到流式输出逐字出现。如果卡住不动打开浏览器开发者工具的 Network 面板看/api/chat/completions这个请求的响应状态码。401 是 Key 问题404 是 Base URL 路径问题500 通常是模型 ID 不存在。实测下来从docker compose up到发出第一条消息顺利的话五分钟内能完成。慢的地方主要在首次拉镜像和下载嵌入模型。如果你在 OpenClaw 的机器上磁盘 IO 较慢嵌入模型下载可能拖到几分钟这不影响对话功能只是 RAG 相关功能会等它就绪。5. 常见报错排查401、local proxy failed 与 reading choices这一节按真实报错来每个都给出定位方法和修复动作。第一个高频错误是401 Unauthorized。日志里通常长这样open-webui | ERROR: OpenAI API error: 401 - {error:{message:Invalid API key}}原因有三种Key 复制时带了空格或换行.env里变量名写成了OPENAI_API_KEY尾部有空格或者你用的是旧 Key 已被吊销。修复方法是进容器确认环境变量docker exec open-webui env | grep OPENAI输出里OPENAI_API_KEY的值应该和你 console 里的一致。如果不一致改.env后docker compose up -d重建容器注意restart不会重新读取.env必须up -d。第二个错误是local proxy failed或Connection error。这通常出现在你把 Base URL 填成了http://localhost:11434这类本地地址但容器内的 localhost 指向容器自己不是宿主机。本篇连的是公网https://taotoken.net/api一般不会触发。但如果你之前配过 Ollama残留的OLLAMA_BASE_URL可能干扰。检查.env里有没有多余的OLLAMA_BASE_URL有就删掉或注释。第三个错误是reading choices或Cannot read properties of undefined (reading choices)。这是 OpenWebUI 拿到了非预期响应常见于 Base URL 多写了/v1导致请求打到https://taotoken.net/api/v1/v1/chat/completions返回 404 的 HTML 而不是 JSON前端解析choices就崩了。修复把OPENAI_API_BASE_URL改回https://taotoken.net/api不带/v1。第四个是 OAuth 相关报错比如OAuth callback error。如果你没启用第三方登录可以忽略如果启用了检查WEBUI_URL是否和实际访问地址一致。这个和模型接入无关但会挡住登录流程。还有一个隐蔽的坑模型 ID 大小写。TaoToken 返回的id是精确字符串你在界面里手动输入模型名时如果大小写不一致会返回model not found。解决办法是直接从模型下拉框选不要手打。排查顺序建议固定为先docker exec open-webui env | grep OPENAI确认三件套再curl直连 TaoToken 确认 Key 有效最后看浏览器 Network 面板确认请求 URL。三步走完九成问题能定位。6. 把入口固定下来后续维护与接入文档跑通之后建议把.env纳入版本管理Key 用占位符这样换机器时直接docker compose up -d就能复现。数据卷open-webui-data记得定期备份命令在官方文档里有核心就是docker run --rm -v open-webui-data:/data -v $(pwd):/backup ubuntu tar czf /backup/openwebui-$(date %F).tar.gz /data。如果你要接 Claude Code 或做更复杂的 Agent 编排OpenWebUI 只是前端后端通道还是 TaoToken 的 API。API Keys 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各语言的调用示例和错误码说明。想先在线试模型效果可以用模型对话页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里的对话入口确认模型行为符合预期再写进配置。最后提醒一句OpenWebUI 的版本迭代很快main标签每次拉取都可能是新构建。如果你追求稳定把镜像 tag 固定到某个 digest比如ghcr.io/open-webui/open-webuisha256:...这样不会因为上游更新导致配置字段改名。升级时先docker compose pull再up -d数据卷不受影响。 
长河君 · 2026/10/18 21:10:57 · 阅读 1.2k OpenClaw 部署 OpenWebUI 指南：把 endpoint 改到 TaoToken 的完整配置
1. 为什么要在 OpenClaw 里把 OpenWebUI 的 endpoint 换掉OpenWebUI 是一个基于 Web 的对话界面你可以把它理解成「自己电脑上的 ChatGPT 网页版」它本身不产出模型能力只负责把输入框里的文字打包成请求发给后面配置好的模型服务再把返回的流式内容渲染成对话气泡。适合谁用适合想给团队或自己搭一个统一入口、又不想被单一厂商绑死的开发者。默认情况下OpenWebUI 会去连本地 Ollama或者让你填一个 OpenAI 兼容地址。问题就出在这个「兼容地址」上很多人第一次部署完界面能打开、账号能注册但一发消息就报错或者模型列表空空如也。我在 OpenClaw 环境里跑 OpenWebUI 时最常遇到的场景是容器起来了端口也通了但OPENAI_API_BASE_URL没配对导致前端一直转圈日志里刷Connection refused或者401。这时候要做的不是重装而是把 endpoint 指向一个稳定的统一通道。TaoToken 提供的就是这样一个 OpenAI 兼容入口你只需要改 Base URL、Key 和 Model ID 三件套OpenWebUI 就能把请求发出去并拿到模型列表。这篇指南聚焦 OpenClaw 环境下的完整配置从 docker-compose 到 .env再到一次真实的对话请求验证。核心检索词就是「OpenWebUI 部署指南」和「endpoint 改到 TaoToken」你跟着做就能复现。下面所有配置我都实测过路径和变量名与 OpenWebUI 官方镜像保持一致不会出现「文档写一套、实际跑另一套」的情况。先说清楚一个前提OpenWebUI 的模型接入走的是 OpenAI 兼容协议所以任何支持/v1/chat/completions和/v1/models的服务都能接。TaoToken 的 API 地址是https://taotoken.net/api注意这里不带任何多余路径OpenWebUI 会自动拼/v1。如果你填成https://taotoken.net/api/v1有些版本会重复拼接变成/v1/v1这是后面排障章节要重点讲的坑。2. TaoToken 前置准备Key、Base URL 与模型 ID 三件套在动 OpenWebUI 之前先把「三件套」准备好否则你会在容器里反复重启却不知道错在哪。所谓三件套就是 Base URL、API Key、Model ID。OpenWebUI 的 OpenAI 连接配置里这三项缺一不可而且名字必须对得上。Base URL 填https://taotoken.net/api。这是 OpenAI 兼容层的根地址OpenWebUI 内部会调用${BASE_URL}/v1/models来拉模型列表调用${BASE_URL}/v1/chat/completions来发对话。你不需要手动加/v1加了反而容易出错。API Key 需要你去控制台生成。打开https://taotoken.net/console登录后进入 API Keys 页面新建一个 Key 并复制。这个 Key 只显示一次建议直接写进.env文件而不是贴在聊天记录里。如果你还没注册先走官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content完成账号创建再回到 console 拿 Key。Model ID 是很多人忽略的一步。OpenWebUI 的模型列表是从/v1/models动态拉取的但你在界面上选择模型时实际发送的是模型 ID 字符串。TaoToken 的模型 ID 通常形如claude-sonnet-4-5、gpt-4o这类具体以你账号下/v1/models返回的id字段为准。你可以先用一条 curl 命令确认curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY | head -c 800返回的 JSON 里data数组每一项都有id把它记下来后面填进 OpenWebUI 的模型白名单。如果你只想先跑通不限制模型OpenWebUI 默认会展示所有拉取到的模型。这里有个细节OpenWebUI 的「连接」设置里有一个开关叫「仅显示已配置的模型」或者模型过滤。如果你在.env里写了OPENAI_MODEL_LIST它就会覆盖动态拉取的结果。新手建议先不写这个变量让界面自动展示全部等确认连通后再做白名单收敛。另外TaoToken 的 Coding Plan 适合长期编码和 Agent 场景如果你打算把 OpenWebUI 当成日常编码助手的前端可以了解https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。但本篇只聚焦部署与接入不展开套餐对比。准备好三件套后把它们写进一个临时文件或密码管理器下一步直接进 docker-compose。3. 可复制配置docker-compose 与 .env 完整片段这一节是全文的核心所有片段都可以直接复制。我建议用 docker-compose 而不是docker run因为环境变量多起来之后命令行会变得难以维护而且改一个参数就要重建容器。compose 文件把配置和镜像分离改.env即可。先建目录结构mkdir -p ~/openclaw/openwebui cd ~/openclaw/openwebui然后创建.env文件内容如下。注意OPENAI_API_BASE_URL的值是https://taotoken.net/api不要带尾部斜杠也不要带/v1# .env OPENAI_API_BASE_URLhttps://taotoken.net/api OPENAI_API_KEYsk-你的TaoToken密钥 WEBUI_SECRET_KEY换成一串随机字符串 WEBUI_NAMEOpenClaw-OpenWebUI ENABLE_OPENAI_APItrue OPENAI_API_CONFIGS_JSON{}WEBUI_SECRET_KEY用于加密会话官方镜像不填会自动生成但容器重建后旧会话会失效所以生产环境务必固定。ENABLE_OPENAI_APItrue是显式打开 OpenAI 兼容连接避免某些版本默认关闭。接着创建docker-compose.ymlservices: open-webui: image: ghcr.io/open-webui/open-webui:main container_name: open-webui restart: always ports: - 3000:8080 env_file: - .env volumes: - open-webui-data:/app/backend/data extra_hosts: - host.docker.internal:host-gateway volumes: open-webui-data:这里有几个关键点。env_file把.env注入容器OpenWebUI 启动时会读取OPENAI_API_BASE_URL和OPENAI_API_KEY。extra_hosts是为了在 Linux 上也能用host.docker.internal虽然本篇连的是公网地址但保留它方便你以后接本地服务。数据卷open-webui-data持久化用户、聊天记录和模型缓存删容器不丢数据。如果你更习惯用 JSON 形式在界面里配置OpenWebUI 的「设置 → 连接」里对应的字段是{ openai: { api_base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_ids: [] } }model_ids留空表示展示全部。这个 JSON 和.env二选一即可同时配置时界面值优先。我建议用.env因为容器重建后界面设置可能因为浏览器缓存或数据库状态丢失而.env是声明式的。启动命令docker compose up -d docker compose logs -f open-webui日志里看到Uvicorn running on http://0.0.0.0:8080就说明服务起来了。第一次启动会下载嵌入模型大概几十 MB耐心等一两分钟。4. 验证请求模型列表与一次真实对话容器起来后先别急着开浏览器用命令行验证连通性最直接。第一步验证模型列表这一步走的是 OpenWebUI 后端到 TaoToken 的链路能排除前端缓存干扰curl -s http://127.0.0.1:3000/api/models \ -H Authorization: Bearer 你的WEBUI_TOKEN不过 OpenWebUI 的/api/models需要登录态更简单的办法是直接看容器日志里有没有拉取模型的记录或者进界面看模型下拉框。如果你想要纯后端验证可以直接对 TaoToken 发一次对话请求确认 Key 和 Base URL 没问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字连通}], stream: false }返回里choices[0].message.content应该是「连通」。这一步过了说明三件套正确问题只可能在 OpenWebUI 的配置层。接下来进浏览器http://127.0.0.1:3000注册管理员账号登录后点左下角头像 → 设置 → 连接。你会看到 OpenAI 那一栏已经填好了 Base URL 和 Key来自.env。点旁边的刷新按钮模型下拉框应该出现一列模型 ID。如果没出现点「验证连接」它会实时请求/v1/models。然后新建对话在模型选择器里选一个输入「用一句话解释什么是 OpenWebUI」发送。正常情况下你会看到流式输出逐字出现。如果卡住不动打开浏览器开发者工具的 Network 面板看/api/chat/completions这个请求的响应状态码。401 是 Key 问题404 是 Base URL 路径问题500 通常是模型 ID 不存在。实测下来从docker compose up到发出第一条消息顺利的话五分钟内能完成。慢的地方主要在首次拉镜像和下载嵌入模型。如果你在 OpenClaw 的机器上磁盘 IO 较慢嵌入模型下载可能拖到几分钟这不影响对话功能只是 RAG 相关功能会等它就绪。5. 常见报错排查401、local proxy failed 与 reading choices这一节按真实报错来每个都给出定位方法和修复动作。第一个高频错误是401 Unauthorized。日志里通常长这样open-webui | ERROR: OpenAI API error: 401 - {error:{message:Invalid API key}}原因有三种Key 复制时带了空格或换行.env里变量名写成了OPENAI_API_KEY尾部有空格或者你用的是旧 Key 已被吊销。修复方法是进容器确认环境变量docker exec open-webui env | grep OPENAI输出里OPENAI_API_KEY的值应该和你 console 里的一致。如果不一致改.env后docker compose up -d重建容器注意restart不会重新读取.env必须up -d。第二个错误是local proxy failed或Connection error。这通常出现在你把 Base URL 填成了http://localhost:11434这类本地地址但容器内的 localhost 指向容器自己不是宿主机。本篇连的是公网https://taotoken.net/api一般不会触发。但如果你之前配过 Ollama残留的OLLAMA_BASE_URL可能干扰。检查.env里有没有多余的OLLAMA_BASE_URL有就删掉或注释。第三个错误是reading choices或Cannot read properties of undefined (reading choices)。这是 OpenWebUI 拿到了非预期响应常见于 Base URL 多写了/v1导致请求打到https://taotoken.net/api/v1/v1/chat/completions返回 404 的 HTML 而不是 JSON前端解析choices就崩了。修复把OPENAI_API_BASE_URL改回https://taotoken.net/api不带/v1。第四个是 OAuth 相关报错比如OAuth callback error。如果你没启用第三方登录可以忽略如果启用了检查WEBUI_URL是否和实际访问地址一致。这个和模型接入无关但会挡住登录流程。还有一个隐蔽的坑模型 ID 大小写。TaoToken 返回的id是精确字符串你在界面里手动输入模型名时如果大小写不一致会返回model not found。解决办法是直接从模型下拉框选不要手打。排查顺序建议固定为先docker exec open-webui env | grep OPENAI确认三件套再curl直连 TaoToken 确认 Key 有效最后看浏览器 Network 面板确认请求 URL。三步走完九成问题能定位。6. 把入口固定下来后续维护与接入文档跑通之后建议把.env纳入版本管理Key 用占位符这样换机器时直接docker compose up -d就能复现。数据卷open-webui-data记得定期备份命令在官方文档里有核心就是docker run --rm -v open-webui-data:/data -v $(pwd):/backup ubuntu tar czf /backup/openwebui-$(date %F).tar.gz /data。如果你要接 Claude Code 或做更复杂的 Agent 编排OpenWebUI 只是前端后端通道还是 TaoToken 的 API。API Keys 管理页在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里面有各语言的调用示例和错误码说明。想先在线试模型效果可以用模型对话页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content里的对话入口确认模型行为符合预期再写进配置。最后提醒一句OpenWebUI 的版本迭代很快main标签每次拉取都可能是新构建。如果你追求稳定把镜像 tag 固定到某个 digest比如ghcr.io/open-webui/open-webuisha256:...这样不会因为上游更新导致配置字段改名。升级时先docker compose pull再up -d数据卷不受影响。