本地模型需已启动并暴露openai兼容接口;通过curl测试http://localhost:11434/api/tags确认服务就绪;配置时严格匹配model_name,测试连接后发送“你好”及工具调用指令验证功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

能直接连接本机运行的模型,无需经过任何云端网关或第三方API服务,只要模型已启动并暴露标准OpenAI兼容接口。
确认本地模型服务是否就绪
打开终端(Windows用CMD/PowerShell,macOS/Linux用Terminal)→ 执行 curl http://localhost:11434/api/tags → 若返回包含模型名称的JSON列表(如{"models":[{"name":"qwen:7b"}]}),说明Ollama等服务已在运行;若提示“Connection refused”,则需先启动Ollama或对应服务。
这一步不可跳过。AionClaw不会主动帮你拉起本地模型进程,它只连接已就绪的HTTP端点。
图形界面配置本地模型
方法一:通过设置页快速填写
打开AionClaw客户端 → 点击左下角「设置」图标 → 进入「模型设置」页 → 在「API接入方式」中选择「本地部署」→ 填入Base URL:http://localhost:11434(Ollama默认)或你实际使用的地址(如http://127.0.0.1:8000/v1对应vLLM)→ 输入Model ID:qwen:7b(必须与ollama list输出完全一致)→ 留空API Key(Ollama默认无需Key)→ 点击「测试连接」。
方法二:手动编辑配置文件(适合高级用户)
关闭AionClaw → 找到配置目录:%APPDATA%\AionClaw\config\model_config.yaml(Windows)或~/Library/Application Support/AionClaw/config/model_config.yaml(macOS)→ 用文本编辑器打开 → 修改base_url、model_name字段 → 保存后重启软件。
注意:model_name必须与本地服务返回的模型标识严格匹配,大小写、冒号、版本号都不能错,否则测试连接会失败且无明确报错提示。
验证模型调用是否生效
第一步:新建一个对话窗口 → 输入“你好”并发送。
第二步:观察右下角状态栏 → 出现「正在调用本地模型 qwen:7b」字样,且响应时间在2~8秒内(取决于硬件和模型大小)→ 表示连接成功。
第三步:执行一次带工具调用的任务 → 如输入“把桌面上的report.xlsx第一行读出来” → 若AionClaw能正确调用文件读取技能并返回结果,说明本地模型具备tool_calling能力,配置完整。
如果仅能响应简单问候但无法触发技能,大概率是所选模型不支持function calling,需换用qwen3、deepseek-v3等明确标注支持该能力的版本。











