OpenClaw 安装前检查清单：Node、pnpm、模型 Key 和渠道 Token

OpenClaw 这种 Agent Gateway 项目，安装失败通常不是因为项目本身，而是环境、变量和渠道配置没准备好。

下面这张表适合安装前逐项确认。

1. 本地环境

检查项	要求	检查命令
Node.js	官方文档要求 Node 24 或 Node 22.14+	node -v
pnpm	用于安装依赖	pnpm -v
Git	拉取项目	git --version
端口	本地服务不能冲突	lsof -i :3000

如果 Node 版本不够，先升级，不要继续安装。

2. 模型 Key

至少准备一个模型供应商 Key。常见变量可能包括：

变量	用途	风险
OPENAI_API_KEY	OpenAI 模型	泄露会产生费用
ANTHROPIC_API_KEY	Claude 模型	注意额度和地区
GOOGLE_GENERATIVE_AI_API_KEY	Gemini	注意模型可用性
GROQ_API_KEY	Groq	注意速率限制

不要把 Key 写进前端公开变量，不要提交到 Git。

3. 渠道 Token

接不同聊天工具，需要不同 Token：

渠道	你要准备什么
Telegram	Bot Token
Slack	Bot Token、App 权限
Discord	Bot Token、服务器权限
WhatsApp	Access Token 和平台配置

建议先接 Telegram 测试，因为个人验证成本低。不要一开始接公司主 Slack。

4. .env 检查表

安装前建一张表：

变量名	是否必填	当前状态	说明
模型 Key	是	已填/未填	至少一个
渠道 Token	看渠道	已填/未填	先只填一个
服务端口	看项目	已确认	避免冲突
日志级别	建议	已确认	方便排错

5. 最小运行路线

不要一次把所有渠道都打开。

安装依赖 -> 配一个模型 Key -> 本地启动 -> 测试一次回复 -> 接一个测试 Bot -> 查看日志 -> 再接其他渠道

每一步都要有验收标准。

6. 常见报错排查

现象	可能原因
安装依赖失败	Node/pnpm 版本不匹配
启动提示缺变量	.env 没配完整
模型无回复	Key 无效、额度不足、模型名不对
Bot 收不到消息	渠道 Token 或 webhook 配置问题
本地能跑，线上不行	端口、防火墙、环境变量不同

7. 问 AI 排错时这样问

我在安装 OpenClaw。下面是 Node 版本、pnpm 版本、执行命令、.env 变量名列表和完整报错。
请按“可能原因 / 验证命令 / 修复方法 / 风险”输出，不要让我盲目重装。

资料依据

• OpenClaw 官方文档：https://docs.openclaw.ai/

安装 OpenClaw 的目标不是“命令不报错”，而是跑通一个低风险消息入口，并确认模型、渠道、日志和权限都可控。