openclaw接入ollama接口错误需逐层排查：先确认ollama服务运行并监听11434端口，再验证curl http://localhost:11434/api/tags连通性；检查openclaw配置中ollama_base_url是否为http://localhost:11434且模型已通过ollama list确认存在；容器部署时需用host.docker.internal或内网ip并确保防火墙放行11434端口；最后结合日志中的http状态码（如404、500、connection reset）精准定位路径、协议或服务崩溃问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw接入Ollama时提示接口错误，说明请求未能成功抵达或被ollama服务正确响应，常见于地址配置错误、服务未启动、端口被占用或模型未加载等环节，需逐层排查验证。
确认Ollama服务是否正在运行
打开终端，执行 ollama serve 启动服务（若已后台运行则跳过）；若提示“address already in use”，说明端口被占，需先终止占用进程。
运行 curl http://localhost:11434/api/tags 测试基础接口连通性。返回 JSON 列表即表示服务正常；返回空、超时或 connection refused，则服务未就绪。
【必须确保 ollama 进程处于前台或 systemd 服务已启用，仅安装不等于自动启动】
检查OpenClaw中Ollama配置项
打开 OpenClaw 的配置文件（通常为 config.yaml 或环境变量配置），定位到 Ollama 相关字段：
确认 ollama_base_url 值为 http://localhost:11434（非 https，非 127.0.0.1 以外的 IP，除非跨主机部署）；
确认 ollama_model 指定的模型名（如 llama3）已在本地加载：执行 ollama list 查看输出中是否存在该模型名称及状态为 ok；
若模型未列出，运行 ollama pull llama3 下载并加载（首次拉取可能耗时数分钟，期间接口会返回 503 错误）。
验证OpenClaw与Ollama网络可达性
方法一：容器内直连测试（适用于 Docker 部署）
本次更新实现飞书插件 npm 独立分发，新增 Ollama 本地模型配置及 openclaw 命令别名。引入 SQLite 持久化队列，支持断点续传。全面集成飞书、钉钉、企业微信及 QQ 官方渠道，优化阿里云百炼模型选择。修复多 Agent 路由、定时任务校验及配对授权等关键问题，提升系统稳定性与兼容性。
进入 OpenClaw 容器：docker exec -it openclaw-app sh；
在容器内执行 curl -v http://host.docker.internal:11434/api/tags（Mac/Win Docker Desktop）或 curl -v http://172.17.0.1:11434/api/tags（Linux 默认 bridge 网关）；
若返回 200，说明网络通；若报 name lookup failed，说明容器无法解析 host.docker.internal，需在 docker run 时加 --add-host=host.docker.internal:host-gateway 参数。
方法二：宿主机防火墙放行
Ubuntu 执行 sudo ufw status 查看是否禁用了 11434 端口；若显示 deny，则运行 sudo ufw allow 11434；
CentOS 执行 sudo firewall-cmd --list-ports，未见 11434 则补加：sudo firewall-cmd --add-port=11434/tcp --permanent && sudo firewall-cmd --reload。
检查OpenClaw日志中的具体错误码
第一步：查看 OpenClaw 最近 20 行错误日志：docker logs openclaw-app --tail 20 | grep -i "ollama\|error\|failed"；
第二步：重点识别 HTTP 状态码——404 表示路径错（如误配成 /v1/chat/completions）；400 表示请求体格式非法（OpenClaw 发送了 OpenAI 格式但 Ollama 不认）；500 表示模型推理崩溃（需换更轻量模型如 phi3 测试）；
第三步：若日志出现 connection reset by peer，大概率是 Ollama 进程意外退出，立即执行 ps aux | grep ollama 并重启服务。
