OpenClaw教程怎么用 龙虾AI框架安装配置指南 如何设置技能插件和API密钥

这篇OpenClaw教程讲什么

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

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

读完你能搞定这些：

• macOS、Linux、Windows WSL 上合规完成OpenClaw安装
• Node.js 22 环境配置和 API 密钥设置
• Gateway 安全配置
• Skills 技能插件的安装和OpenClaw使用

第一步：三种官方安装方法

方法一：官方安装脚本（推荐）

1. 下载脚本
   打开终端（macOS/Linux）或 WSL（Windows），跑这条命令：

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

2. 加执行权限

   chmod +x install_openclaw.sh

3. 跑安装脚本

   ./install_openclaw.sh

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

方法二：Homebrew（仅 macOS）

1. 装 Homebrew（没装过的话）

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

2. 一行命令装 OpenClaw

   brew install openclaw

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

方法三：手动下载安装包

1. 打开 GitHub 仓库
   浏览器访问 https://github.com/openclaw/openclaw
2. 下载最新 Release
   点 "Releases" 标签，下最新版压缩包。

3. 解压安装

   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，版本不对会报错。

1. 用 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 版本管理器，装多个版本也不冲突。

2. 验证版本

   node -v

   输出 v22.x.x 就对了。

设置 API 密钥

1. 拿到密钥
   上 龙虾官网 yitb.com，登录后进 "API Keys" 页面生成。

2. 写入配置

   openclaw config set api_key YOUR_API_KEY

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

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

第三步：Gateway 安全配置

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

1. 改监听地址
   编辑 config.yaml，找到 gateway 段：

   gateway:
     host: 0.0.0.0
     port: 8080

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

2. 启动 Gateway

   openclaw gateway start

3. 配防火墙
   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 的标准流程。

常见问题 FAQ

1. 安装时遇到权限报错？

用 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 的核心竞争力，多逛逛龙虾官网 yitb.com 的排行榜，好用的插件能省大量开发时间。

相关教程推荐：

• OpenClaw 技能插件排行榜
• OpenClaw 高级配置指南