OpenClaw部署配置与接口验证
本文说明 openclaw部署的安装、Ollama 模型配置与 Gateway 启动，并给出 gateway.mode=local 配置和 openclaw health 连通检查。
完成这篇 openclaw部署后，你会在自己的机器上装好 OpenClaw，把默认模型设为本地 Ollama 模型，启动 Gateway，并完成健康检查。开始前按 OpenClaw 入门文档 准备 Node.js 24.16+ 或 26.1+（官方推荐 Node.js 26）以及可用的 AI 接入方式：复用已有的 Claude Code/Codex CLI 登录，或在选择需要认证的 provider 时使用 API key；使用 key 时只把它保存在环境变量中。
准备条件
先确定运行终端：macOS、Linux、WSL2 使用 shell，Windows 使用 PowerShell。采用 Ollama 时，还要确定可访问的主机地址和已经可用的模型；API key 不要写进命令、终端历史或代码仓库。
操作步骤：openclaw部署
- 安装 OpenClaw。 以下安装器命令来自 OpenClaw 安装文档。
macOS、Linux 或 WSL2 运行：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
这条命令启动安装器；安装器会检测操作系统、在需要时安装 Node、安装 OpenClaw，并进入 onboarding。
Windows PowerShell 运行：
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
这条 PowerShell 命令运行对应的 OpenClaw 安装器。
- 配置 Ollama 模型。 模型选择、发现规则和默认模型命令按 Ollama 设置文档 执行。
bash
openclaw onboard
在配置流程中选择 Ollama，再选择 Cloud + Local、Cloud only 或 Local only。
对 loopback、private network、.local 和裸主机名 URL，不需要创建真实 bearer token；OpenClaw 会使用 ollama-local marker。
bash
openclaw models list
这条命令列出当前可见的模型。
bash
openclaw models set ollama/YOUR_VALUE
这条命令把默认模型设为 ollama/YOUR_VALUE，其中 YOUR_VALUE 要替换为实际模型名。
自动发现还会检查模型是否已加载以及能力信息：
text
/api/ps
/api/show
/api/ps 用于确认模型已加载，/api/show 用于确认工具支持和至少 16K 上下文；不满足这些条件时，自动发现可能看不到该模型。
OpenClaw 与 Ollama 的接口规则见 Ollama 提供商文档：
text
/api/chat
baseUrl: "http://YOUR_VALUE:11434"
YOUR_VALUE 要替换为 Ollama 主机地址，并且不要给 baseUrl 追加 /v1；OpenClaw 使用原生 /api/chat，使用 /v1 会破坏工具调用，模型还可能把原始 tool-call JSON 当作普通文本输出。
- 配置并启动 Gateway。 启动条件、绑定模式和前台运行方式见 Gateway 运行文档。
text
~/.openclaw/openclaw.json
gateway.mode=local
Gateway 未设置 gateway.mode=local 时会拒绝启动；默认 bind mode 是 loopback，其他枚举值为 lan、tailnet、auto 和 custom，超出 loopback 且没有认证的绑定会被阻止。
bash
openclaw gateway
这条命令在前台启动 Gateway，便于先完成接口连通检查。
怎么确认成功
Gateway 的连通检查按 Health CLI 文档 执行：
openclaw health
正确结果是命令通过 WebSocket RPC 从正在运行的 Gateway 取得 health snapshot；如果无法取得快照，应返回检查 gateway.mode、本地配置和前台启动命令。
常见出错点
- Gateway 拒绝启动：检查
~/.openclaw/openclaw.json中的gateway.mode=local。需要超出 loopback 访问时，不能在缺少认证的情况下直接绑定。 - 模型没有出现在列表中：按前述自动发现条件检查
/api/ps、/api/show、工具支持以及至少16K上下文。 - 工具调用结果异常：删除
baseUrl中的/v1，恢复为 Ollama 原生 API 地址，并保留/api/chat接线方式。 - 本地地址被要求填写 token：loopback、局域网、
.local或裸主机名 URL 不需要真实 bearer token，不要自行编造凭据。
这些步骤按正文链接的官方文档整理，未在本网站自有机器上运行，请按当前版本复核。