openclawai需通过外部服务调用phi-3模型,支持四种方式:一、ollama本地运行phi3:mini;二、llama.cpp加载gguf量化模型;三、对接星图平台phi-3-vision api;四、python子进程调用transformers定制推理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在本地运行Phi-3系列模型,并借助OpenClawAI实现智能体能力(如文件操作、技能调用、记忆管理等),则需明确OpenClawAI本身不直接内置Phi-3模型权重,而是通过接入外部大模型API或本地推理服务来驱动其智能体逻辑。以下是部署Phi-3模型并使其与OpenClawAI协同工作的多种方法:
一、通过OpenClaw配置本地Ollama服务调用Phi-3-mini
此方法利用Ollama作为本地轻量级模型服务器,OpenClaw通过HTTP请求对接其API,无需CUDA手动配置,适合Windows/macOS/Linux普通用户。
1、确认已安装Ollama:在终端中执行ollama --version,若返回版本号(如0.3.12),说明已就绪。
2、拉取Phi-3-mini模型:ollama pull phi3:mini,该命令将自动下载约2.2GB的模型文件。
3、启动Ollama服务:ollama serve,保持该终端持续运行。
4、进入OpenClaw项目根目录,编辑config/openclaw.json文件,在llm节点下设置:
"provider": "ollama", "base_url": "http://localhost:11434", "model": "phi3:mini"
5、启动OpenClaw:npm start或按其文档方式运行,系统将通过Ollama接口调用Phi-3-mini进行推理。
二、使用OpenClaw对接本地Llama.cpp+Phi-3-GGUF量化模型
此方法适用于显存受限设备(如无独立GPU或仅集成显卡),通过llama.cpp加载GGUF格式的Phi-3模型,以纯CPU或Metal/ Vulkan后端运行,OpenClaw通过自定义LLM适配器通信。
1、从Hugging Face或Phi-3官方渠道获取Phi-3-mini-4k-instruct的GGUF量化版本(如Phi-3-mini-4k-instruct.Q4_K_M.gguf)。
2、下载对应平台的llama.cpp预编译二进制(Windows推荐使用llama.cpp releases中的llama-server.exe)。
3、启动llama-server并绑定端口:llama-server -m path/to/Phi-3-mini-4k-instruct.Q4_K_M.gguf -c 2048 --port 8080。
4、修改OpenClaw的config/openclaw.json,将llm.provider设为llamacpp,并配置base_url: "http://localhost:8080"。
5、确保skills目录中启用llamacpp_adapter插件,重启OpenClaw服务。
OpenClaw 基础设施心跳监控与自动恢复:部署/卸载心跳守护进程,配置主机监控(Gateway、磁盘、内存、CPU、进程),设置飞书告警,自动重启故障Gateway。适用关键词:心跳监控、heartbeat daemon、服务器告警、自动重启、健康检查、auto recovery。
三、通过OpenClaw直连星图GPU平台Phi-3-vision API(免本地部署)
此方法跳过本地硬件限制,利用星图平台已预装并优化的Phi-3-vision-128k-instruct实例,OpenClaw仅需配置API密钥与端点即可调用,适合需视觉理解能力的场景。
1、登录星图平台,开通Phi-3-vision镜像服务,获取专属API endpoint(如https://api.xingtu.ai/v1/chat/completions)和API Key。
2、在OpenClaw的config/openclaw.json中,将llm.provider设为openai兼容模式。
3、填写以下字段:
"base_url": "https://api.xingtu.ai/v1", "api_key": "sk-xxx", "model": "phi-3-vision-128k-instruct"
4、检查config/skills/image_analyzer.js是否启用——该技能依赖Phi-3-vision的多模态能力,可自动解析上传图片。
5、保存配置并重启OpenClaw,此时所有对话与图像分析请求将路由至星图云端Phi-3-vision实例。
四、在OpenClaw中嵌入Python子进程调用Transformers+Phi-3(高级定制)
此方法面向开发者,允许完全控制推理参数(如temperature、max_new_tokens)、加载LoRA微调权重,并与OpenClaw的记忆模块深度集成。
1、创建Python脚本phi3_inference.py,使用transformers库加载microsoft/Phi-3-mini-4k-instruct,暴露Flask HTTP接口。
2、在脚本中添加torch.compile()及bnb_4bit_quant_type="nf4"以降低显存占用。
3、启动该服务:python phi3_inference.py --host 0.0.0.0 --port 5001。
4、在OpenClaw配置中新增自定义provider:"provider": "custom", "base_url": "http://localhost:5001/invoke"。
5、确保OpenClaw的memory模块能将上下文摘要注入该Python服务的prompt前缀中,实现长期记忆联动。









