AionClaw通过标准OpenAI兼容接口调用本地大模型服务。需确保模型服务（如Ollama、llama.cpp或vLLM）已启动并暴露/v1接口，再在AionClaw设置中填写Base URL、API Key和严格匹配的Model ID，测试连接成功后保存重启即可生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让AionClaw桌面客户端能调用本地运行的大模型，但不需要为客户端和模型各自单独配置两套系统——AionClaw本身不内置模型，它只负责调度；而本地模型（比如Ollama、llama.cpp或vLLM托管的服务）必须对外暴露标准OpenAI兼容接口，AionClaw才能识别并连接。关键在于打通「客户端→模型服务」这一条链路，不是分别配置两个孤立模块。
确认本地模型已启动并提供OpenAI兼容API
先确保你的本地模型服务已运行，并监听在类似 http://localhost:11434/v1（Ollama）、http://localhost:8080/v1（llama.cpp）或 http://localhost:8000/v1（vLLM）这样的地址。打开浏览器访问该地址，如果返回 {"error":"Unauthorized"} 或 JSON 格式错误提示，说明服务已启动且接口可达；若显示“无法连接”或超时，则模型服务未运行或端口被占用。
这一步跳过会导致后续所有配置失败，因为AionClaw在初始化时会主动探测该地址是否响应。
在AionClaw中填写模型接入参数
打开AionClaw客户端 → 点击右上角齿轮图标进入【设置】→ 左侧选择「大模型服务」→ 右侧切换为「自定义模型」模式。
填入三项必填字段：【Base URL】（如 http://localhost:11434/v1）、【API Key】（多数本地模型无需密钥，此处可填任意非空字符串如 sk-xxx 或留空，但AionClaw界面校验要求不为空，建议填 ollama）、【Model ID】（如 qwen2:7b、phi3:mini 或 llama3.2:3b，必须与你本地实际加载的模型名称完全一致）。
注意：Model ID 大小写敏感，且不能带空格或路径符号；填错会导致“模型不存在”报错，且不会自动修正。
验证连通性并保存配置
点击「测试连接」按钮 → 等待2～5秒 → 出现绿色「连接成功」提示即表示AionClaw已能正常调用本地模型。
此时点击右下角「保存并重启服务」，客户端将重新加载模型配置。重启后可在主界面左下角看到当前激活的模型名称，以及实时Token消耗状态。
这一步完成后，AionClaw就正式接管了本地模型的调用权，后续所有技能、数字专家、定时任务都将通过该接口执行，无需再手动干预模型进程。
