🚀 龙虾新手指南

OpenClaw教程怎么用 龙虾AI框架安装配置与skill技能插件调用全指南如何设置

发布时间：2026-04-04 分类： 龙虾新手指南
摘要：导语这份OpenClaw教程覆盖三大平台安装（macOS/Linux/WSL）、API密钥配置、Gateway安全加固以及Skills调用全流程，适合刚接触OpenClaw安装的新手。不管你是AI开发者还是想搭个私人助手，跟着本文一步步来，半小时内能跑起来。1. 什么是OpenClaw？OpenClaw，也叫龙虾AI框架，是一个开源AI助手平台。它把多个AI功能模块（Skills）集成进来，...

封面

导语

这份OpenClaw教程覆盖三大平台安装（macOS/Linux/WSL）、API密钥配置、Gateway安全加固以及Skills调用全流程，适合刚接触OpenClaw安装的新手。不管你是AI开发者还是想搭个私人助手，跟着本文一步步来，半小时内能跑起来。

1. 什么是OpenClaw？

OpenClaw，也叫龙虾AI框架，是一个开源AI助手平台。它把多个AI功能模块（Skills）集成进来，支持跨平台运行，适合构建智能应用和自动化服务。

本篇OpenClaw教程专门为新手设计，目标只有一个：从零到跑通，不绕弯子。

2. 为什么选择OpenClaw？

  • 开源免费：不需要付许可证费用。
  • 跨平台：macOS、Linux、WSL三端通吃。
  • Skills丰富：功能模块覆盖对话、自动化、数据处理等场景。
  • 社区活跃：遇到问题基本能在社区里找到解答。

3. OpenClaw安装方法

3.1 系统要求

  • macOS：10.15 Catalina 及以上。
  • Linux：Ubuntu 20.04 LTS 及以上。
  • WSL：Windows 10+，需开启 WSL 2。

3.2 安装步骤

3.2.1 macOS

第一步：安装Homebrew

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

macOS上没有Homebrew很难受，装了之后包管理省心很多。

第二步：安装Node.js 22

brew install node@22

Node.js 22是官方推荐版本，装其他版本容易踩版本兼容坑。

第三步：OpenClaw安装

npm install -g openclaw

-g 全局安装，装完就能在任何目录直接用 openclaw 命令。

3.2.2 Linux

第一步：更新包列表

sudo apt update

第二步：安装Node.js 22

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

通过NodeSource安装，版本精准，省去手动编译的麻烦。

第三步：OpenClaw安装

sudo npm install -g openclaw

3.2.3 WSL

WSL上的安装步骤和Linux一致：

第一步：更新包列表

sudo apt update

第二步：安装Node.js 22

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

第三步：安装OpenClaw

sudo npm install -g openclaw

配图

Windows用户通过WSL跑OpenClaw，体验和原生Linux基本没差别。

4. OpenClaw配置

4.1 API密钥配置

第一步：获取API密钥

登录OpenClaw官网，进入开发者控制台复制密钥。

第二步：写入配置

openclaw config set api_key YOUR_API_KEY

把 YOUR_API_KEY 换成实际密钥。这步没做好，后面所有AI调用都会报错，是最容易忽略的坑。

4.2 Gateway安全配置

默认配置文件路径：~/.openclaw/config.yaml，找到Gateway部分：

gateway:
  host: 0.0.0.0
  port: 8080

把 host 改成 127.0.0.1：

gateway:
  host: 127.0.0.1
  port: 8080

0.0.0.0 对外开放所有网络接口，改成 127.0.0.1 只允许本地访问，安全性直接拉满。

5. OpenClaw使用指南

5.1 启动服务

openclaw start

启动后访问 http://localhost:8080，OpenClaw使用界面就出来了。

5.2 Skills安装与调用

安装Skills

去Skills排行挑选需要的模块，比如 chatbot：

openclaw install chatbot

在代码里调用

const openclaw = require('openclaw');
const chatbot = new openclaw.Skill('chatbot');

chatbot.process('你好！').then(response => {
  console.log(response);
});

调用 process() 方法，把输入传进去，AI回复就出来了。

6. 常见问题FAQ

6.1 安装时报权限错误？

在命令前加 sudo，或者确认当前账户有管理员权限。

6.2 API密钥报无效？

重新登录OpenClaw官网生成新密钥，然后重新跑配置命令。

6.3 Gateway启动失败？

检查8080端口是否被占用：lsof -i :8080。如果被占，改配置文件里的端口号就行。

7. 总结

本文覆盖了OpenClaw安装（macOS/Linux/WSL三平台）、API密钥配置、Gateway安全加固，以及OpenClaw使用的完整流程。这份OpenClaw教程能帮你绕开大部分新手常见坑，把环境搭起来直接开干。

更多Skills插件评测和排名，访问龙虾官网 yitb.com 查看，有详细的安装教程和使用案例持续更新。

推荐相关教程：

返回首页