1. 问题现象与初步排查
上周我在搭建一个基于本地Ollama模型的Telegram聊天机器人时,遇到了一个相当诡异的问题。系统所有组件都显示运行正常,但机器人就是无法正常回复消息。具体表现为:
- 执行
openclaw models status命令显示默认模型已正确设置为ollama/gemma3:4b - 网关服务状态检查
openclaw gateway status返回RPC探测正常 - 通道状态
openclaw channels status确认Telegram连接已启用且运行中 - 但实际向机器人发送消息时,却收到错误回复:"unknown model: ollama/gemma3:4b"
这个现象特别令人困惑,因为模型明明已经成功加载,系统各组件也都显示正常,为什么还会报"未知模型"错误?我开始怀疑是不是遇到了OpenClaw的某个隐藏Bug。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与问题复现
为了彻底搞清楚这个问题,我决定在我的M1 Mac mini上完整复现这个场景。以下是详细的复现步骤:
2.1 基础环境搭建
首先确保系统环境满足要求:
- macOS Ventura 13.4 (M1芯片)
- 已安装Homebrew作为包管理器
- Docker Desktop已安装并运行(用于Ollama容器)
bash复制# 安装OpenClaw
brew tap openclaw/tap
brew install openclaw
2.2 Ollama环境配置
Ollama的安装和模型下载:
bash复制# 使用Docker运行Ollama
docker run -d -p 11434:11434 --name ollama ollama/ollama
# 拉取Gemma3 4B模型
docker exec ollama ollama pull gemma3:4b
2.3 OpenClaw基础配置
创建并编辑配置文件~/.openclaw/openclaw.json:
json复制{
"agents": {
"defaults": {
"model": "ollama/gemma3:4b"
}
},
"channels": {
"telegram": {
"enabled": true,
"token": "YOUR_TELEGRAM_BOT_TOKEN"
}
}
}
2.4 服务启动与验证
启动网关服务并检查状态:
bash复制openclaw gateway start
openclaw gateway status # 应显示RPC probe: ok
openclaw models status # 应显示默认模型为ollama/gemma3:4b
3. 问题分析与诊断
当按照上述步骤配置完成后,向Telegram机器人发送消息确实会返回"unknown model"错误。通过深入分析日志和系统行为,我发现了几处关键点:
3.1 权限验证缺失
在检查openclaw models status输出时,注意到一个容易被忽略的提示:
code复制Missing auth
ollama Run openclaw configure or set an API key env var.
这个提示暴露了一个关键问题:虽然Ollama作为
