必须将openclaw与本地ollama服务对接，通过向导式、命令行或手动修改yaml三种方式配置模型地址、id及api密钥，并确保所选模型支持tool calling，方可实现完全离线、数据不出设备的安全运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在完全离线、数据不出设备的环境中运行OpenClaw智能体，并确保敏感文档、交互记录、系统操作等全部隐私信息不上传至任何远程服务器，则必须将其与本地Ollama服务完成可靠对接。以下是实现该目标的多种配置路径：
一、向导式配置（推荐新手）
该方式通过交互式命令行自动引导用户完成全部参数输入，避免因YAML缩进错误、字段遗漏或地址格式不规范导致的连接失败，适用于首次部署且未修改过默认配置的用户。
1、在终端（macOS/Linux）或 PowerShell（Windows）中执行初始化命令：openclawonboard。
2、根据屏幕提示，使用方向键选择 Ollama 作为模型提供方（Provider）。
3、在服务地址栏中准确输入本地 Ollama 的监听接口：http://localhost:11434。
4、从已下载模型列表中，仅选择明确标注支持 tool calling 的模型，例如：qwen2.5:7b 或 gemma4:e2b。
5、API Key 字段可任意填写非空字符串，如：ollama-local，该值不参与真实鉴权。
6、确认后选择 Local 模式，系统将自动写入配置并重启 OpenClaw 服务。
二、命令行逐项配置（适用于脚本化部署）
该方式将全部配置参数拆解为独立的 openclaw config set 命令，便于集成至自动化部署脚本或批量初始化多台设备，所有设置即时写入运行时配置系统，无需手动编辑文件。
1、设置 Ollama 身份标识字段：openclaw config set models.providers.ollama.apiKey "ollama-local"。
2、指定 Ollama 服务基础地址（若部署在非本机需替换IP）：openclaw config set models.providers.ollama.baseUrl "http://localhost:11434"。
3、设定默认调用模型标识符，格式须为 ollama/模型ID：openclaw config set models.default "ollama/qwen2.5:7b"。
4、执行重启指令使新配置立即生效：openclaw restart。
三、手动修改 YAML 配置文件（适用于高级定制）
此方式允许用户精确控制模型元信息、推理温度、最大输出长度、上下文窗口等底层参数，特别适用于需适配特定硬件资源（如显存受限设备）或启用高级技能插件的场景。
1、定位配置文件路径：macOS/Linux 用户打开 ~/.openclaw/config.yaml；Windows 用户打开 C:\Users\用户名\.openclaw\config.yaml。
2、在文件末尾插入以下结构化配置块（注意：缩进必须为两个空格，不可使用Tab）：
models:
default: ollama/qwen2.5:7b
providers:
ollama:
baseUrl: "http://localhost:11434"
apiKey: "ollama-local"
api: "ollama"
models:
- id: "qwen2.5:7b"
name: "Qwen2.5 7B"
max_tokens: 2768
temperature: 0.7
3、保存文件后，在终端执行 openclaw restart 以加载新配置。
四、Ollama服务监听地址修正（跨设备/容器场景必查）
当OpenClaw与Ollama部署于不同设备（如OpenClaw在笔记本、Ollama在NAS）或Docker容器中时，Ollama默认仅监听 127.0.0.1，导致连接被拒绝。必须显式开放网络接口并重新启动服务。
1、在运行Ollama的设备上，临时设置监听地址为局域网IP（例如 192.168.1.100）：export OLLAMA_HOST=192.168.1.100:11434。
2、停止当前Ollama进程：pkill -f "ollama serve"。
3、重新启动服务：ollama serve。
4、在OpenClaw配置中，将 baseUrl 改为 http://192.168.1.100:11434 并重启OpenClaw。
五、工具调用模型验证与替换（Skills功能启用前提）
OpenClaw的Skills（技能）模块依赖模型原生支持函数调用（Function Calling）能力，若所选模型不支持，将导致邮件发送、PDF解析、代码生成等自动化任务静默失败。必须通过Ollama命令行验证并切换可用模型。
1、列出本地所有已下载模型及其功能标签：ollama list。
2、检查目标模型是否含 tool 或 function-calling 标识（部分模型需加 :latest 后缀才启用该能力）。
3、若当前模型无工具调用支持，立即拉取经验证的兼容模型：ollama pull qwen2.5:7b 或 ollama pull gemma4:e2b。
4、在OpenClaw配置中将 default 模型更新为新拉取的ID，并执行 openclaw restart。
