夜雨聆风WindowsmacOSLinuxOllama
📑 目录
一、什么是 OpenClaw
二、环境准备
三、分平台安装步骤
四、交互式配置向导
五、Windows 常见问题及解决
六、对接本地 Ollama 模型
七、访问 Web Dashboard
一、什么是 OpenClaw
OpenClaw 是一款开源的 AI 智能体（Agent）工具，可以对接各类大语言模型——无论是云端 API（OpenAI、Kimi、MiniMax、通义千问等），还是本地部署的模型（Ollama、vLLM 等），它都能灵活集成。
简单来说，OpenClaw 就像一个"AI 管家"：你可以通过网页面板、飞书、钉钉、Telegram 等渠道与它对话，让它帮你处理文件、搜索信息、管理任务，甚至操控电脑执行自动化流程。
✅ 支持多模型切换 ✅ 本地私有化部署 ✅ 多渠道接入✅ 插件/技能扩展 ✅ Web Dashboard 管理
二、环境准备
⚠️ 关键前提：OpenClaw 基于 Node.js 运行，必须安装 Node.js 22.x LTS 版本。非 LTS 版本（如 23.x 奇数版）可能存在兼容性问题，强烈建议使用 LTS。
系统最低要求：
三、分平台安装步骤
🍎 macOS 安装
步骤 1：安装 Node.js
前往 Node.js 官网
https://nodejs.org/zh-cn/下载 22.x LTS 版本安装包，按引导完成安装。安装完成后打开终端验证：
node --version# 输出 v22.x.x 即为成功
npm --version# 输出对应版本号
步骤 2：安装 OpenClaw
npm install -g openclaw@latest --registry=https://registry.npmmirror.com💡 提示：使用 npmmirror 镜像源可大幅提升国内下载速度，避免网络超时。
步骤 3：验证安装
openclaw --version# 输出版本号（如 2026.3.2）即为成功
🪟 Windows 安装 踩坑重灾区
步骤 1：安装 Node.js
从官网下载 22.x LTS 的 .msi 安装包，全程默认下一步即可。
⚠️ 注意：安装过程中务必勾选 "Add to PATH"（添加到系统路径），否则命令行无法识别 node 命令。
安装完成后打开 CMD 验证：
node --versionnpm --version
步骤 2：以管理员身份安装 OpenClaw
🛡️ 必须以管理员身份运行！右键开始菜单 → 选择「终端管理员」或「管理员: Windows PowerShell」。
npm install -g openclaw@latest --registry=https://registry.npmmirror.com若遇到权限报错，可尝试手动指定 npm 全局路径：
npm config set prefix "C:\Users\你的用户名\AppData\Roaming\npm"步骤 3：验证安装
openclaw --version🐧 云服务器（Linux）安装
步骤 1：服务器基础配置
购买 Linux 服务器（Ubuntu / CentOS 均可），防火墙需开放端口： 22 (SSH)18789 (OpenClaw 网关)
通过 SSH 连接后，先更新系统：
# Ubuntu / Debiansudo apt update && sudo apt upgrade -y
# CentOS / RHELsudo yum update -y
步骤 2：通过 nvm 安装 Node.js 22
💡 推荐用 nvm：服务器上使用 nvm（Node 版本管理器）安装 Node.js，方便后续版本切换和升级。
# 安装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashsource ~/.bashrc# 安装 Node.js 22 LTSnvm install 22nvm use 22# 验证node --version步骤 3：安装 OpenClawnpm install -g openclaw@latest --registry=https://registry.npmmirror.comopenclaw --version# 验证安装
四、交互式配置向导（关键）
安装完成后，执行以下命令启动配置向导（Windows 下需管理员身份）：
openclaw onboard --install-daemon向导会逐步引导你完成初始化，以下是每一步的详细说明：
1安全警告确认界面显示安全提示（beta 版风险等），本地使用风险极低，选择 Yes 继续。
2初始化模式选 QuickStart（快速开始），后续可通过 openclaw configure 改配置。
3现有配置处理若提示 "Existing config detected"，选 Use existing values 保留已有配置。首次安装不会出现。
4模型/服务商选择• 云端模型（MiniMax / Kimi / OpenAI）：选对应服务商，填真实 API Key• 本地模型（Ollama）：先随便选一个占位，后续改配置文件（见第六章）
5API Key 填写选 Paste API key now，粘贴 Key。用 Ollama 的话随便填字符串即可。
6聊天渠道选 Skip for now，飞书/钉钉等后续需要时再配。
7技能配置选 No，跳过技能安装，后续按需添加。
8钩子功能选 Skip for now，扩展钩子是进阶功能，新手暂不需要。
ℹ️ 配置完成后，OpenClaw 会自动生成配置文件并尝试启动 Gateway 服务。如果启动失败（尤其是 Windows），别慌，接着看下面的踩坑章节。
五、Windows 常见问题及解决 踩坑实录
⚠️ 问题 1：配置向导按回车无反应
🐛 现象
选中 Skip for now 后按回车，界面毫无反应，卡住不动。
🔍 原因
命令行交互组件使用"先选中、再提交"的模式——方向键移动光标 ≠ 选中选项，需要额外按空格确认。
🔧 解决
① 用方向键 ↑↓ 将光标移到目标选项② 按 空格 打勾（选项前出现 [x]）③ 按 Enter 提交
❌ 问题 2：Gateway 服务启动失败（核心问题）
🐛 现象
执行 openclaw status 提示：
Gateway: unreachable (connect failed: connect ECONNREFUSED 127.0.0.1:18789)Gateway service: Scheduled Task installed · missing · unknown (系统找不到指定文件)
🔍 原因
Windows 计划任务适配问题，OpenClaw 默认的后台服务安装命令在部分 Windows 系统上失效。
🔧 解决
放弃系统服务，改为手动启动网关：
# 窗口 1：启动网关（保持窗口打开）openclaw gateway run# 窗口 2：新开 CMD，启动仪表盘openclaw dashboard
💡 长期方案：可以把 openclaw gateway run 放到 Windows "启动"文件夹中，实现开机自启。
🌐 问题 3：Dashboard 自动打开失败
🐛 现象
执行 openclaw dashboard 提示 "Copied to clipboard. Opened in your browser." 但浏览器并未弹出。
🔍 原因
Windows 默认浏览器未正确关联，OpenClaw 调用 open 命令失败。
🔧 解决
手动复制命令行输出中的 URL，粘贴到浏览器地址栏直接访问：
http://127.0.0.1:18789/#token=你的token值
六、对接本地 Ollama 模型（进阶）
如果你已经在本地跑了 Ollama，可以通过修改配置文件让 OpenClaw 直接调用本地模型，完全免费、完全离线。
步骤 1：找到配置文件
WindowsC:\Users\你的用户名\.openclaw\openclaw.jsonmacOS/Users/你的用户名/.openclaw/openclaw.jsonLinux~/.openclaw/openclaw.json
步骤 2：修改 model 配置段
用文本编辑器打开配置文件，找到 "model" 字段，替换为：
{"model": {"provider": "openai","name": "llama3", // 替换为你的模型名（qwen2、phi3 等）"apiBase": "http://localhost:11434/v1", // Ollama 兼容接口"apiKey": "ollama-local"// 随便填，不校验 }}
ℹ️ Ollama 从 0.1.14 版本起内置 OpenAI 兼容接口（/v1/chat/completions），所以 provider 填 "openai" 即可。
步骤 3：重启网关生效
# 关闭之前的网关窗口，然后重新启动openclaw gateway run
七、访问 Web Dashboard
🖥️ 本地部署：浏览器直接访问http://127.0.0.1:18789
☁️ 云服务器部署：确保 18789 端口已开放http://你的服务器IP:18789
⚠️ 生产环境建议配置 Nginx 反向代理 + HTTPS，避免 Token 在公网明文传输。
📋 常用命令速查表
如果本文对你有帮助，欢迎 点赞 + 在看 + 转发
