企业官网建设流程全解析

1. OpenClaw 是什么？全平台安装前先搞懂这套 AI 助手工具

OpenClaw 是一套可以本地部署的 AI 助手运行框架，它能让你在自己的电脑上跑起一个带 Web 控制台的智能体网关，然后通过统一接口接入 GLM-4.6、Claude 等不同厂商的大模型，用来做代码辅助、自动化工作流、终端对话这类事情。说白了，它像是一个「本地 AI 调度中心」：模型不绑定在某一个客户端里，而是由 OpenClaw 统一管理，你在浏览器、VS Code 或者命令行里都能调用同一套配置。

它适合谁？三类人最值得装：一是想在自己机器上长期跑 AI 编码助手的开发者；二是需要多模型切换、不想被单一平台锁死的技术用户；三是想研究 Agent 工作流、把模型接进自己脚本里的折腾党。如果你只是偶尔问两句问题，网页版够用；但只要你开始追求「稳定、可配置、能接自己的 Key」，OpenClaw 这类本地框架就有价值。

这篇教程覆盖 Windows、macOS、Linux 三个平台，给你 Node.js 和 Docker 两条部署路径，并且把模型接入的配置片段直接写成可复制的形式。我试过在 macOS 和 Ubuntu 上各跑一遍，踩过的坑主要集中在 Node 版本、sharp 依赖和网关端口占用这三处，后面会逐个拆开讲。

安装前先确认环境底线：Node.js 必须 v20 以上，推荐 v22 LTS；系统方面 macOS 12+、Ubuntu 20.04+/Debian 11+/Fedora 38+、Windows 10/11 都可以。Docker 路线则要求 Docker Engine 20.10+，Windows 上建议用 WSL2 后端。把这几项对齐，后面基本不会卡在环境上。

核心检索词先记住三个：OpenClaw 安装教程、全平台部署、Node.js 与 Docker 双路径。下面从环境准备开始，一步步来。

2. 安装前的环境准备：Node.js v22 与 Docker 全平台配置

这一节解决「装之前要有什么」。很多人失败不是 OpenClaw 本身的问题，而是 Node 版本太旧或者 npm 全局目录权限没配好。先把地基打牢。

2.1 Node.js 安装（macOS / Linux / Windows）

macOS 用 Homebrew 最省事：

brew install node@22 brew link node@22 --force --overwrite node -v npm -v

Linux（Ubuntu/Debian）走 NodeSource 源：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs node -v && npm -v

Fedora 系可以用 dnf 装模块流：

sudo dnf module install nodejs:22/common node -v

Windows 直接去 nodejs.org 下载 v22 LTS 的 msi 安装包，一路下一步即可，安装时勾选「Add to PATH」。装完打开新的 PowerShell 验证：

node -v npm -v

如果node -v输出的是 v18 或更低，说明系统里有旧版本抢占 PATH，需要先卸载旧版或调整环境变量顺序。这一步不解决，后面openclaw启动会直接报语法错误。

2.2 npm 全局目录与权限

Linux/macOS 上如果npm install -g报 EACCES，不要无脑加 sudo，正确做法是把全局目录指到用户空间：

mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc

这样以后全局安装都不需要管理员权限，也不会污染系统目录。

2.3 Docker 环境（走容器路线才需要）

Ubuntu 安装 Docker：

curl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER newgrp docker docker version

macOS 和 Windows 装 Docker Desktop 即可，Windows 记得开启 WSL2 后端。验证：

docker run --rm hello-world

能打印出欢迎信息，说明容器运行时正常。到这里环境就绪，接下来进入正式安装。

3. OpenClaw 三种安装方式：一键脚本、npm 与 Docker 可复制配置

这一节是全文核心，给你三条路径，按需选一条即可，不要混着装。三条路最终都指向同一个openclaw命令或同一个容器。

3.1 方式一：一键安装脚本（新手首选）

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 需要管理员 PowerShell。先按 Win 键搜索 PowerShell，右键选择「以管理员身份运行」，然后执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass iwr -useb https://openclaw.ai/install.ps1 | iex

这两条策略命令只影响当前用户，作用是允许运行本地和下载的脚本，不会改动系统级安全设置。执行完脚本会自动拉取依赖并注册命令。

3.2 方式二：npm 手动安装（可控性最强）

macOS / Linux：

sudo npm install -g openclaw@latest

Windows：

npm install -g openclaw@latest

macOS 上如果卡在 sharp 依赖编译失败，用这个绕过系统 libvips：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

或者先装 vips 再装：

brew install vips npm install -g openclaw@latest

验证安装：

openclaw --version

能打印版本号就说明命令注册成功。

3.3 方式三：Docker 部署（隔离性最好）

docker run -d \ --name openclaw \ -p 3000:3000 \ -v ~/.openclaw:/root/.openclaw \ openclaw/openclaw:latest

三个参数含义：-p 3000:3000把容器端口映射到本机；-v ~/.openclaw:/root/.openclaw把配置目录挂出来，容器重建不丢配置；-d后台运行。查看状态：

docker ps | grep openclaw docker logs -f openclaw

3.4 模型接入配置片段（关键）

无论走哪条路，模型接入都靠配置文件。OpenClaw 的配置目录默认在~/.openclaw，主配置文件是config.json。下面是一份可直接复制的片段，把 Base URL、Key、Model ID 三件套写全：

{ "models": { "default": "glm-4.6", "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "models": ["glm-4.6", "claude-sonnet-4-5"] } } }, "gateway": { "port": 3000, "host": "127.0.0.1" } }

如果你用 Docker，这份文件放在宿主机的~/.openclaw/config.json，容器通过挂载卷读取，路径与上面-v参数一致。改完配置执行openclaw restart或docker restart openclaw生效。

注意：Base URL 填https://taotoken.net/api，不要带多余斜杠；Model ID 必须和平台上的模型名完全一致，大小写敏感。

4. 初始化与验证：openclaw onboard 跑通并确认安装成功

装完不等于能用，必须走一遍初始化，再发一次真实请求确认链路通。

4.1 执行 onboard 向导

openclaw onboard

向导会依次问几件事。第一步是风险告知，用方向键选 Yes 回车确认。第二步选 QuickStart 模式。第三步配置模型 API Key，把上一节config.json里的 Key 填进去，或者直接让它读配置文件。第四步问是否连接通讯平台，暂时选skip for now。第五步 Skills 选 NO，Hooks 选skip for now。全部走完会提示启动服务。

4.2 启动网关与控制台

开两个终端窗口。窗口 A 保持前台运行网关：

openclaw gateway

窗口 B 启动控制台：

openclaw dashboard

浏览器会自动打开http://localhost:3000。如果没自动跳，手动访问即可。

Windows 用户嫌每次开两个窗口麻烦，可以建一个 bat 脚本，桌面新建 txt 粘贴下面内容，改后缀为OpenClaw网关启动.bat，双击运行：

@echo off echo Starting OpenClaw Gateway... openclaw gateway start

4.3 验证请求是否成功

最直接的验证是发一条对话请求。用 curl 打网关接口：

curl -X POST http://localhost:3000/api/chat \ -H "Content-Type: application/json" \ -d '{"model":"glm-4.6","messages":[{"role":"user","content":"你好，回复一个字"}]}'

返回 JSON 里如果choices数组有内容，说明模型链路完全打通。如果返回 401，是 Key 问题；返回连接拒绝，是网关没起来；返回reading 'choices'这类报错，通常是上游返回结构异常，多半是 Base URL 或模型名写错。

再检查一次版本和进程：

openclaw --version openclaw status

status显示 gateway running、model connected，就算彻底装好了。此时你可以在 Web 控制台里直接对话，也可以把 VS Code 指向http://localhost:3000作为本地模型端点。

5. 常见报错排查：401、sharp 失败、端口占用与 OAuth 问题

这一节按真实报错对照处理，遇到哪个查哪个。

5.1 401 Unauthorized

现象：请求返回 401，日志里出现invalid api key。原因九成是 Key 写错、过期，或者配置文件里 Key 带了引号外的空格。处理：打开~/.openclaw/config.json，确认apiKey字段是完整字符串，没有换行和多余空格；确认 Base URL 是https://taotoken.net/api。改完openclaw restart。

5.2 local proxy failed / 连接被拒绝

现象：local proxy failed或ECONNREFUSED 127.0.0.1:3000。这是网关没启动或端口被占。先查端口：

lsof -i :3000

有别的进程占用就换端口，改config.json里gateway.port为 3001，重启。Windows 用：

netstat -ano | findstr :3000

5.3 sharp 安装失败（macOS 高频）

现象：npm 安装阶段报sharp编译错误、libvips找不到。处理方案二选一：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

或

brew install vips npm install -g openclaw@latest

5.4 reading 'choices' of undefined

现象：请求返回但解析报Cannot read properties of undefined (reading 'choices')。这是上游响应不是标准 OpenAI 格式，常见于 Base URL 指错或模型名不存在。核对三件套：Base URL、Key、Model ID。用 curl 直接打上游确认模型名有效，再回填配置。

5.5 OAuth 与 Codex auth.json 相关

如果你同时用 Codex 类工具，认证信息存在~/.codex/auth.json。OpenClaw 与它互不干扰，但如果你把 OpenClaw 的 Base URL 指向了需要 OAuth 的端点，会报OAuth token missing。处理：OpenClaw 走 API Key 模式，不要复用 OAuth 端点；确认config.json里没有残留的oauth字段。

5.6 权限不足

macOS/Linux 报EACCES，按 2.2 节把 npm 全局目录指到用户空间，不要长期用 sudo。Windows 报权限错误，用管理员终端重跑安装命令。

5.7 参数对照速查

排查完重启一次，再跑 4.3 的 curl 验证，通了就收工。

6. 装好之后怎么用：模型对话、Coding Plan 与接入文档

安装只是起点，真正提效在于把 OpenClaw 接进日常流程。Web 控制台适合快速验证模型和调试提示词，直接打开模型对话页面就能切换 GLM-4.6、Claude 等模型对比输出，不用改代码。

如果你打算长期用它做编码助手或跑 Agent 工作流，建议开通 Coding Plan，把额度、并发和模型权限一次配好，避免频繁换 Key 打断节奏。配置入口在控制台里，按提示绑定即可。

所有接入细节、参数说明和最新模型列表，以官方接入文档为准，遇到配置项不确定时先查文档再改文件，比反复试错快得多。API Key 的创建和管理在 API Keys 页面完成，建议给 OpenClaw 单独建一个 Key，方便按项目追踪用量。

最后给一个实用习惯：把~/.openclaw/config.json纳入你的 dotfiles 备份，换机器时复制过去改个 Key 就能跑，省掉重新 onboard 的时间。装完这一套，本地 AI 调度中心就算真正立起来了。