必须通过官方配置向导完成OpenAI模型配置:先创建并授权宿主机~/.openclaw目录,再挂载该目录启动Docker容器,最后执行docker exec -it openclaw openclaw configure,严格按向导选择OpenAI、粘贴sk-开头密钥、留空Base URL、准确输入gpt-4o或o1-preview模型ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Ubuntu服务器上用Docker部署OpenClaw后,想让它调用OpenAI的GPT-4o或o1模型却始终报错“Unknown model”,根本原因是配置路径错、环境变量漏、模型ID写错三重叠加——必须绕过手动改JSON的陷阱,走官方配置向导这条唯一通路。
启动容器前:准备宿主机配置目录
执行mkdir -p ~/.openclaw创建隐藏目录。这一步不能跳过,否则容器内生成的openclaw.json会丢失,后续所有配置都白做。
确认目录权限:运行ls -la ~/.openclaw,输出中第一列应显示drwxr-xr-x,若为drw-------则需执行chmod 755 ~/.openclaw,否则容器无法写入配置。
启动容器:必须挂载配置目录
用以下命令启动容器,重点看-v ~/.openclaw:/home/node/.openclaw这一行:
docker run -d \--name openclaw \--network host \-v ~/.openclaw:/home/node/.openclaw \-v ~/openclaw/data:/app/data \--restart always \ghcr.nju.edu.cn/openclaw/openclaw:latest
【不挂载 /home/node/.openclaw 就等于没配置】 容器每次重启都会清空内部配置,你填的API Key和模型名全消失。
注入OpenAI配置:只用官方交互向导
容器启动后,立即执行:
完整的工作区安全套件:检测未授权修改,扫描提示注入模式,自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
docker exec -it openclaw openclaw configure
进入向导后按顺序操作:
① 在Select sections to configure界面,用方向键选中Model,按回车;
② Model/auth provider选OpenAI(不是Custom Provider);
③ API Key处直接粘贴你的sk-开头密钥,别加任何空格或换行;
④ API Base URL留空(默认https://api.openai.com/v1),填错会导致401错误;
⑤ Model ID必须严格填写gpt-4o或o1-preview,大小写、连字符一个都不能错——填GPT-4o或gpt4o都会触发Unknown model报错。

















