企业官网建设流程全解析

1. 先搞清楚 OpenClaw 到底装了什么

OpenClaw 是一个跑在本地的 AI 助手运行时，你可以把它理解成一个「常驻后台的调度中枢」：它对外暴露一个 Gateway 端口（默认 18789），对内管理多个 agent、渠道和技能。你平时用命令行、Web 控制台或者消息渠道跟它对话，真正干活的是它背后调用的模型服务。

它适合谁？三类人最合适：一是想在自己电脑上跑一个私有 AI 助手的开发者；二是需要把 AI 能力接进现有脚本、定时任务的自动化玩家；三是想研究 agent 编排、渠道接入的技术同学。如果你只是想随便聊两句，用网页版就够了，不必折腾本地部署。

环境搭建之所以是第一步，是因为 OpenClaw 对运行时版本、系统权限、网络端口都比较敏感。Node.js 版本低一个小版本，openclaw命令可能直接报ERR_REQUIRE_ESM；端口被占用，Gateway 起不来；API Key 没配好，对话一直转圈。这篇就把 Windows、macOS、Linux 三平台的安装命令、依赖清单、config.toml骨架一次讲清，并且用 TaoToken 统一 Key 和 API 通道完成接入，最后跑一次真实启动加报错排查。

先给一张三平台依赖对照表，方便你对照自己的系统：

注意：Node.js 22 是硬门槛，别用 18 或 20 凑合，OpenClaw 的部分依赖用了较新的 ESM 特性，低版本会在启动阶段就挂掉。

2. 用 TaoToken 统一 Key 与 API 通道

OpenClaw 本身不生产模型能力，它需要连一个兼容 Anthropic 协议的 API 端点。这里我用 TaoToken 来做统一通道，好处是：一个 Key 走通所有模型调用，不用在多个平台之间来回切换配置，config.toml里只维护一份base_url和api_key就行。

TaoToken 官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=openclaw_setup

API 端点固定为：https://taotoken.net/api （这个地址不加 UTM 参数，直接写进配置）。

你需要先去控制台创建一个 API Key，然后把它填进 OpenClaw 的配置里。Key 的创建入口在控制台的 API Keys 页面，拿到形如sk-xxxx的字符串后先存好，后面三平台的配置都会用到它。

提示：不要把 Key 直接写进会提交到 Git 的文件里。推荐用环境变量注入，或者放在~/.openclaw/config.toml这种本地配置文件中，并确保该目录不被版本控制。

如果你后面要长期跑编码类任务或者 Agent 编排，可以关注 Coding Plan 方案，它更适合高频调用场景；只是验证模型连通性的话，用模型对话页面手动测一次就够了。

3. 三平台可复制配置

3.1 Windows：WSL2 方案（推荐）

以管理员身份打开 PowerShell，先装 WSL2 和 Ubuntu：

wsl --install -d Ubuntu

重启后从开始菜单进入 Ubuntu，更新系统并装基础工具：

sudo apt update && sudo apt upgrade -y sudo apt install -y curl git wget build-essential

装 Node.js 22：

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

装 OpenClaw CLI：

npm install -g openclaw@latest openclaw --version

如果你确实不能用 WSL2，原生 Windows 用 winget 装 Node 也行：

winget install OpenJS.NodeJS.LTS npm install -g openclaw@latest

3.2 macOS：Homebrew 原生安装

先装 Xcode 命令行工具和 Homebrew（已装可跳过）：

xcode-select --install brew install node node --version

Apple Silicon 机器建议确认走的是 arm64 原生版本：

arch -arm64 npm install -g openclaw@latest openclaw --version

3.3 Linux：Ubuntu / Debian 与 CentOS

Ubuntu / Debian 系：

sudo apt update sudo apt install -y curl git build-essential curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs npm install -g openclaw@latest

CentOS / RHEL 系：

sudo yum install -y epel-release curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - sudo yum install -y nodejs npm install -g openclaw@latest

3.4 config.toml 骨架（三平台通用）

OpenClaw 的配置文件默认在~/.openclaw/config.toml。下面这份骨架把 Gateway、模型通道、agent 默认参数都写好了，你只需要替换api_key：

[gateway] port = 18789 host = "127.0.0.1" max_connections = 100 timeout_ms = 30000 [provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key = "sk-你的Key" model = "claude-sonnet-4-20250514" [agents.defaults] max_memory = "4GB" timeout_ms = 30000

Windows 原生环境下路径是C:\Users\你的用户名\.openclaw\config.toml，WSL2 里则跟 Linux 一致。改完配置后建议用openclaw config validate检查一遍语法，避免 TOML 写错导致启动失败。

4. 启动验证与成功结果

配置写好后，先做一次健康检查：

openclaw status openclaw health

然后启动 Gateway：

openclaw gateway --port 18789 --verbose

看到类似下面的输出就说明起来了：

[gateway] listening on 127.0.0.1:18789 [provider] taotoken connected, model=claude-sonnet-4-20250514 [health] all checks passed

浏览器打开http://127.0.0.1:18789/能看到 Web 控制台，随便发一条消息，如果模型正常返回内容，说明 Key 和 API 通道都通了。这一步是整个环境搭建的验收动作，过了这关，后面接渠道、写技能才有意义。

Linux 上如果要用 systemd 常驻，可以建一个服务文件：

[Unit] Description=OpenClaw Gateway After=network.target [Service] Type=simple Environment=TAOTOKEN_API_KEY=sk-你的Key ExecStart=/usr/bin/openclaw gateway --port 18789 Restart=on-failure RestartSec=10 [Install] WantedBy=multi-user.target

保存到/etc/systemd/system/openclaw.service后执行sudo systemctl daemon-reload && sudo systemctl enable --now openclaw。

5. 本篇常见报错排查

报错一：ERR_REQUIRE_ESM或Cannot find module基本是 Node.js 版本不对。用node --version确认是 22 以上，Windows 上可以用 nvm-windows 切换：nvm install 22 && nvm use 22。

报错二：EADDRINUSE: address already in use :18789端口被占了。Linux/macOS 用lsof -i :18789找到进程再 kill；Windows 用netstat -ano | findstr :18789查 PID，然后taskkill /PID <PID> /F。或者干脆在config.toml里换个端口。

报错三：对话一直转圈或返回 401Key 没配对，或者base_url写错了。检查config.toml里base_url是不是https://taotoken.net/api，api_key有没有多余空格。改完记得重启 Gateway。

报错四：macOS 上launchctl服务起不来先launchctl list | grep openclaw看状态，再launchctl unload后重新load。日志在/tmp/openclaw.err，里面通常有具体原因。

报错五：Linux 上 npm 全局安装权限不足别用 sudo 硬装，配置用户级前缀更干净：

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

报错六：WSL2 里 localhost 访问不到WSL2 的网络是隔离的，Windows 侧访问要用 WSL 的 IP，或者直接在 WSL 内部用curl http://127.0.0.1:18789验证。新版 WSL2 支持 localhost 转发，如果不行就wsl --update升级一下。

6. 接下来怎么走

环境跑通之后，下一步通常是接渠道和写技能。如果你要长期跑编码任务或 Agent 编排，建议直接上 Coding Plan，省得每次手动配 Key；只是偶尔验证模型效果，用模型对话页面手动测就行。API 相关的细节和接入文档都在文档页，遇到配置问题优先翻那里。

我自己的习惯是：每换一台机器，先把config.toml骨架复制过去，改 Key，跑openclaw health，三步确认环境没问题再动别的。这套流程在三平台上都验证过，最省时间。