OpenClaw 安装踩坑实录：这些坑我都帮你填了

背景

帮客户安装 OpenClaw 时踩了几个坑，记录下来，帮你避坑。

坑 1：Node.js 版本

❌ 问题：

Error: Node.js 14.x is not supported

✅ 解决：

# 安装 Node.js 18+
brew install node@18

# 或用 nvm
nvm install 18
nvm use 18

坑 2：权限问题

❌ 问题：

EACCES: permission denied

✅ 解决：

# 不要用 sudo
# 修复 npm 权限
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

坑 3：API Key 配置

❌ 问题：

Error: OpenAI API key not found

✅ 解决：

# 方法 1：环境变量
export OPENAI_API_KEY=sk-xxx

# 方法 2：配置文件
openclaw configure
# 按提示输入 API Key

# 方法 3：.env 文件
echo "OPENAI_API_KEY=sk-xxx" > ~/.openclaw/.env

坑 4：Channel 配置

OpenClaw 支持多种渠道：Telegram、Discord、WhatsApp、Signal 等。

❌ 问题：

Channel not configured

✅ 解决（以 Telegram 为例）：

1. 找 @BotFather 创建 Bot，获取 Token
2. 找 @userinfobot 获取你的 Chat ID
3. 配置：

openclaw configure
# 选择 Telegram
# 输入 Bot Token 和 Chat ID

坑 5：Skills 安装

❌ 问题：

Skill not found

✅ 解决：

# 搜索 Skill
clawhub search "你的关键词"

# 安装
clawhub install skill-slug

# 查看已安装
clawhub list

坑 6：代理问题（中国大陆）

❌ 问题：

Error: connect ETIMEDOUT

✅ 解决：

# 设置代理
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

# 或在配置文件中设置

完整安装流程

# 1. 安装 Node.js 18+
brew install node@18

# 2. 安装 OpenClaw
npm install -g openclaw

# 3. 配置
openclaw configure

# 4. 测试
openclaw chat "你好"

# 5. 安装 Skills
clawhub search "效率"
clawhub install clawmart-quick-proposal

安装服务

不想折腾？我可以帮你远程安装：

套餐	价格	内容
基础安装	¥99	远程安装 + 基础配置
完整配置	¥299	+ Channel 配置 + 5 个 Skills
企业定制	¥999	+ 自定义 Skills + 培训

落地页：yang1002378395-cmyk.github.io/clawmart

---

有问题评论区留言。