WorkBuddy 无法调用本地模型服务的根本原因是 API 网关未正确暴露服务或内网通信未打通，需依次完成五步：一、配置 Ollama 监听 0.0.0.0:11434；二、WorkBuddy 中添加 OpenAI 兼容 API 模型并填对 endpoint 与 model ID；三、放行系统防火墙端口 11434；四、启用 Claws Background Service 并确保网关端口（如 8080）可用；五、逐层验证 curl 连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在本地成功运行 Ollama 或 llama.cpp 等模型服务，但 WorkBuddy 无法调用或出现连接超时、404、拒绝连接等错误，则很可能是 API 网关未正确暴露本地模型服务，或内网通信路径未打通。以下是实现 WorkBuddy 自定义模型本地部署与 API 网关内网互通的具体操作步骤：
一、确认本地模型服务已监听内网地址
Ollama 默认仅绑定 127.0.0.1（localhost），导致 WorkBuddy 从外部（如企业微信回调、远程 Claws 请求）无法访问。必须显式配置其监听所有网络接口，使服务可被同一局域网内其他设备或本机非 loopback 客户端识别。
1、停止当前运行的 Ollama 服务：执行 ollama serve 进程并终止（macOS/Windows 可通过活动监视器或任务管理器结束 ollama 进程）。
2、启动 Ollama 并强制绑定 0.0.0.0：在终端中运行 OLLAMA_HOST=0.0.0.0:11434 ollama serve。
3、验证监听状态：执行 lsof -i :11434（macOS/Linux）或 netstat -ano | findstr :11434（Windows），确认输出中包含 *:11434 或 0.0.0.0:11434，而非仅 127.0.0.1:11434。
二、在 WorkBuddy 中配置自定义模型为 HTTP API 模式
WorkBuddy 支持将任意兼容 OpenAI API 格式的本地服务（如 Ollama、vLLM、llama.cpp 的 server 模式）注册为模型。关键在于关闭“本地文件直连”路径，启用标准 REST 调用，并确保 endpoint 地址可达。
1、打开 WorkBuddy 设置界面，进入左侧导航栏的 「模型」→「添加模型」。
2、模型类型选择 「OpenAI 兼容 API」，而非「GGUF 文件」或「Ollama 内置」。
3、填写以下字段：
– 模型名称：例如 Qwen3.5-4B-Ollama
– API Endpoint：http://127.0.0.1:11434/v1（若 WorkBuddy 与 Ollama 同机）或 http://192.168.x.x:11434/v1（若部署在另一台局域网设备）
– API Key：留空（Ollama 无需密钥）
– 模型 ID：填写 qwen3.5:4b-q4_K_M（须与 ollama list 输出完全一致）
4、勾选 「启用此模型」，点击保存。
三、配置系统级防火墙放行模型端口
即使服务已监听 0.0.0.0，Windows Defender 防火墙或 macOS 防火墙仍可能拦截入站请求，导致 WorkBuddy 发起的 POST /chat/completions 请求被静默丢弃。
1、Windows 用户：打开「控制面板 → Windows Defender 防火墙 → 高级设置 → 入站规则 → 新建规则」，选择「端口」→ TCP → 特定本地端口 11434 → 允许连接 → 应用于所有配置文件 → 命名为 Ollama-API-Access。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
2、macOS 用户：前往「系统设置 → 隐私与安全性 → 防火墙 → 防火墙选项」，点击 「+」添加 /usr/local/bin/ollama，并确保勾选「允许传入连接」。
3、验证放行效果：在另一台局域网设备浏览器中访问 http://[本机IP]:11434/health，应返回 JSON 格式健康状态（如 {"status":"ok"}）。
四、启用 WorkBuddy 的 Claws Background Service 并校准通信协议
Claws 协议是 WorkBuddy 实现本地模型联动的核心通信层。若 Background Service 未启用或端口冲突，API 网关无法完成指令路由与模型响应聚合。
1、在 WorkBuddy 主界面点击右上角头像，进入 「Claw Settings」。
2、开启 「Enable Background Service」 开关。
3、记录显示的 Local API Endpoint（默认为 http://127.0.0.1:8080/claw），该地址即为 API 网关入口。
4、检查是否端口占用：若提示 8080 被占用，点击右侧 「Change Port」 修改为 8081 或其他可用端口，并同步更新所有依赖该 endpoint 的集成配置（如企微机器人 Webhook URL）。
五、验证内网互通链路完整性
需逐层确认数据流能否从 WorkBuddy 控制面抵达模型推理面，避免因 DNS 解析、代理设置或跨网段路由失败中断链路。
1、在 WorkBuddy 所在机器终端执行：curl -X POST http://127.0.0.1:11434/api/chat -H "Content-Type: application/json" -d '{"model":"qwen3.5:4b-q4_K_M","messages":[{"role":"user","content":"你好"}]}'，确认返回 streaming JSON 流。
2、在同一终端执行：curl http://127.0.0.1:8080/claw/health，确认返回 {"status":"healthy","models":["Qwen3.5-4B-Ollama"]}。
3、若使用局域网多机部署，从客户端机器执行：curl http://[WorkBuddy主机IP]:8080/claw/models，应列出已注册模型；再执行：curl http://[Ollama主机IP]:11434/health，确认模型服务可达。
