Grok与Open WebUI整合教程:打造本地高颜值可视化对话界面
想用马斯克旗下Grok模型,又不想忍受命令行黑框或API裸调的繁琐体验?需要一个像ChatGPT那样丝滑、美观、支持文件上传和历史回溯的本地可视化对话界面?其实一套组合拳就能轻松实现。
确认Grok接入前提
打开浏览器无痕窗口,访问 x.ai 并登录账号。进入 Settings → API Keys → Create new key,复制生成的密钥(以 xai- 开头的32位字符串),保存到安全位置。这一步漏掉就没法后续验证了——【密钥仅显示一次,关闭页面即不可再查】,务必第一时间备份。
确保本地已安装 Docker Desktop(v24.0+)且服务正在运行。终端执行 docker info 命令若无报错,说明环境就绪。
Docker一键部署Open WebUI并绑定Grok
在终端中逐行执行以下命令:
第一步:拉取最新镜像
docker pull ghcr.io/open-webui/open-webui:main
第二步:启动容器并注入Grok配置
docker run -d
--name open-webui
-p 3000:8080
-v open-webui_data:/app/backend/data
-e OPENAI_API_BASE_URLS="https://api.x.ai/v1"
-e OPENAI_API_KEYS="xai-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
--restart always
ghcr.io/open-webui/open-webui:main
注意:OPENAI_API_KEYS 的值必须用双引号包裹,且不能有多余空格或换行。如果填错,容器虽能启动,但登录后无法调用模型,届时只能 docker rm -f open-webui 后重试。
首次访问与基础设置
浏览器访问 http://localhost:3000,页面自动跳转至注册页。输入邮箱、用户名、密码完成注册,系统会自动创建首个管理员账户。
登录后点击左下角 Settings → Models → Add Model,手动添加一条记录:
- Provider: OpenAI API
- Name: grok-beta
- Base URL: https://api.x.ai/v1
- API Key: xai-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
- Model Name: grok-beta
做完这一步,顶部模型切换栏就会出现 grok-beta 选项,点击即可开始对话。整个过程下来,本地就拥有了一套媲美ChatGPT体验的Grok交互界面。
