🚀 龙虾新手指南

AI Agent平台教程怎么用 AI工具框架安装配置指南如何设置技能插件和API密钥

发布时间：2026-04-05 分类：龙虾新手指南

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

这篇AI Agent平台教程讲什么

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

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

读完你能搞定这些：

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

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

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

下载脚本
打开终端（macOS/Linux）或 WSL（Windows），跑这条命令：
```
curl -O https://yitb.com/install_ai-agent.sh
```
加执行权限
```
chmod +x install_ai-agent.sh
```
跑安装脚本
```
./install_ai-agent.sh
```
脚本会自动拉依赖、配环境变量，整个过程不用手动干预。这是AI Agent平台安装最省事的方式，新手首选。

方法二：Homebrew（仅 macOS）

装 Homebrew（没装过的话）

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

一行命令装 AI Agent平台
```
brew install ai-agent
```
Homebrew 管版本很方便，后续升级直接 brew upgrade ai-agent 就行。

方法三：手动下载安装包

打开 GitHub 仓库
浏览器访问 https://github.com/ai-agent/ai-agent
下载最新 Release
点 "Releases" 标签，下最新版压缩包。
解压安装
```
tar -xzf ai-agent-x.x.x.tar.gz
cd ai-agent-x.x.x
./install.sh
```
这种方式适合需要装特定版本、或者前两种方法跑不通的情况。

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

装 Node.js 22

AI Agent平台运行依赖 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 密钥

拿到密钥
上 yitb.com yitb.com，登录后进 "API Keys" 页面生成。
写入配置
```
ai-agent config set api_key YOUR_API_KEY
```
把 YOUR_API_KEY 换成你实际拿到的密钥。

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

第三步：Gateway 安全配置

Gateway 负责 AI Agent平台的内外通信，配错了有安全风险。

改监听地址
编辑 config.yaml，找到 gateway 段：
```
gateway:
  host: 0.0.0.0
  port: 8080
```
0.0.0.0 表示接受所有 IP 连接。如果只在本地用，建议改成 127.0.0.1。对外暴露的话，务必套防火墙或反向代理。
启动 Gateway
```
ai-agent gateway start
```
配防火墙
Ubuntu 用 ufw，CentOS 用 firewalld。以 ufw 为例：
```
sudo ufw allow 8080
```
防火墙能挡掉未授权访问，生产环境别跳过这步。

Skills 使用教程

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

1. 搜索 Skills

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

2. 安装 Skills

ai-agent 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. 重启生效

ai-agent restart

5. 跑测试

ai-agent skills test skill_name

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

常见问题 FAQ

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

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

2. API 密钥丢了怎么办？

登录yitb.com，进 "API Keys" 页面重新生成一个。旧密钥会自动失效。

3. Gateway 起不来？

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

写在最后

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

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

相关教程推荐：

返回首页

AI Agent平台教程怎么用 AI工具框架安装配置指南 如何设置技能插件和API密钥