OpenClaw教程：覆盖多平台安装及配置，避开Anthropic管控坑

摘要：这篇OpenClaw 教程讲什么OpenClaw（也叫龙虾 AI 框架、龙虾助手平台）是目前 AI 开发者用得最多的开源工具之一。这篇OpenClaw教程手把手带你完成OpenClaw安装，覆盖 macOS、Linux、Windows WSL 三个平台。2026 年 Anthropic 收紧了 OAuth 管控，不按官方流程装很容易踩坑。下面会讲三种官方认可的OpenClaw安装方式，再教你配...

这篇OpenClaw教程讲什么

OpenClaw（也叫龙虾 AI 框架、龙虾助手平台）是目前 AI 开发者用得最多的开源工具之一。这篇OpenClaw教程手把手带你完成OpenClaw安装，覆盖 macOS、Linux、Windows WSL 三个平台。

2026 年 Anthropic 收紧了 OAuth 管控，不按官方流程装很容易踩坑。下面会讲三种官方认可的OpenClaw安装方式，再教你配好 Node.js 22、API 密钥和 Gateway，最后上手 Skills（技能插件）。

读完你能搞定这些：

第一步：三种官方安装方法方法一：官方安装脚本（推荐）

下载脚本

打开终端（macOS/Linux）或 WSL（Windows），跑这条命令：

curl -O https://yitb.com/install_openclaw.sh

加执行权限

chmod +x install_openclaw.sh

跑安装脚本

./install_openclaw.sh

脚本会自动拉依赖、配环境变量，整个过程不用手动干预。这是OpenClaw安装最省事的方式，新手首选。

方法二：Homebrew（仅 macOS）

装 Homebrew（没装过的话）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

一行命令装 OpenClaw

brew install openclaw

Homebrew 管版本很方便，后续升级直接 brew upgrade openclaw 就行。

方法三：手动下载安装包打开 GitHub 仓库

浏览器访问下载最新 Release

点 "Releases" 标签，下最新版压缩包。

解压安装

tar -xzf openclaw-x.x.x.tar.gz
cd openclaw-x.x.x
./install.sh

这种方式适合需要装特定版本、或者前两种方法跑不通的情况。

第二步：配置 Node.js 22 和 API 密钥装 Node.js 22

OpenClaw 运行依赖 Node.js 22，版本不对会报错。

用 nvm 安装

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

nvm 是 Node 版本管理器，装多个版本也不冲突。

验证版本

node -v

输出 v22.x.x 就对了。

设置 API 密钥拿到密钥

上龙虾官网，登录后进 "API Keys" 页面生成。

写入配置

openclaw config set api_key YOUR_API_KEY

把 YOUR_API_KEY 换成你实际拿到的密钥。

API 密钥是身份验证凭证，没配好的话OpenClaw使用过程中所有功能调用都会报 401。

第三步：Gateway 安全配置

Gateway 负责 OpenClaw 的内外通信，配错了有安全风险。

改监听地址

编辑 config.yaml，找到 gateway 段：

gateway:
  host: 0.0.0.0
  port: 8080

0.0.0.0 表示接受所有 IP 连接。如果只在本地用，建议改成 127.0.0.1。对外暴露的话，务必套防火墙或反向代理。

启动 Gateway

openclaw gateway start

配防火墙

Ubuntu 用 ufw，CentOS 用 firewalld。以 ufw 为例：

sudo ufw allow 8080

防火墙能挡掉未授权访问，生产环境别跳过这步。

Skills 使用教程

OpenClaw 最强的地方在于 Skills 生态。这套技能插件体系让你按需扩展功能，不用自己造轮子。

1. 搜索 Skills

上 Skills排行页面，按热度或分类找你要的插件。

2. 安装 Skills

openclaw skills install skill_name

skill_name 换成实际插件名。

3. 配置 Skills

装完后按插件文档改配置。比如编辑 skills/skill_name/config.yaml：

skill:
  name: skill_name
  description: "A description of the skill"
  enabled: true

4. 重启生效

openclaw restart

5. 跑测试

openclaw skills test skill_name

确认输出正常就可以正式用了。这是OpenClaw使用 Skills 的标准流程。

常见问题 FAQ1. 安装时遇到权限报错？

用 sudo 提权，或者 chmod 改文件权限。nvm 装的 Node 一般不需要 sudo，如果需要，说明路径配置有问题。

2. API 密钥丢了怎么办？

登录龙虾官网，进 "API Keys" 页面重新生成一个。旧密钥会自动失效。

3. Gateway 起不来？

先查 config.yaml 格式有没有写错（YAML 对缩进敏感），再用 lsof -i :8080 看端口是不是被占了。

写在最后

这篇OpenClaw教程从安装到配置到 Skills 上手，把新手最容易卡住的环节都过了一遍。三种OpenClaw安装方式选适合自己的就行，脚本安装最省心，Homebrew 适合 Mac 用户，手动安装灵活度最高。

配好 Node.js 22 和 API 密钥之后，Gateway 安全别偷懒，防火墙一定要开。Skills 生态是 OpenClaw 的核心竞争力，多逛逛龙虾官网的排行榜，好用的插件能省大量开发时间。

百易AI博客

OpenClaw教程：覆盖多平台安装及配置，避开Anthropic管控坑

推荐文章