龙虾AI · OpenClaw 中文教程与资料 OpenClaw 第三方中文资料站 · 非官方

教程 · 入门

AI智能体怎么搭建?零基础用龙虾AI(OpenClaw)搭第一个

搭一个 AI 智能体,不需要你会写代码。有了龙虾AI(OpenClaw)这类现成的开源框架,整个过程更接近“装软件 + 接插头”,一共四步:选框架 → 选模型当大脑 → 装好框架 → 接上工具。

搭建 AI 智能体封面

选搭建工具(框架)

搭智能体不需要从零写程序,你需要的是一个“智能体框架”——它已经把“调工具、循环执行、看结果再决定”这套逻辑写好了,你只管用。新手建议直接用 龙虾AI(OpenClaw):开源、免费、能装在自己电脑上。

它和 Hermes Agent、托管服务、开发框架这几类方案各看什么,见《OpenClaw 和 Hermes Agent 怎么选》。还没搞懂智能体本身是啥的,看 AI 智能体是什么。

选一个模型当“大脑”

框架本身不带智商,它得接一个大模型才能思考。两条路:

  • 接闭源 API(Claude、GPT、Gemini):按用量付费,花多少看模型和用量。第一次搭建建议走这条,不用先准备显卡和本地推理服务。
  • 本地跑开源模型(DeepSeek、Qwen):推理在本机完成,没有按量的 API 账单;但任务里一旦用到联网工具、云端回退或其他外部服务,数据照样会离开本机,显卡或大内存机器、电费和维护也都是成本。复杂任务的上限要看模型大小和量化,最好拿自己的任务实测。

具体哪个模型当龙虾的大脑更合适,可以按工具调用、长任务、中文表现和成本这几项需求去对照候选模型和官方资料,看 当龙虾的大脑:6 个模型选型方向与自测任务 和 模型选型。两条路怎么权衡,看 接 API 还是本地跑。

装上 OpenClaw:一行安装命令加引导向导

官方给了一键安装脚本,装完会接着进引导向导。按系统挑一条,在终端里执行:

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

向导先把模型接通:它会找这台机器上已经能用的 AI 接入,你从里面挑一个,或者另选一家模型服务商。上一节选了闭源 API 的,在这里选对应的服务商,把后台拿到的 key 填进去;向导拿一次真实请求试通了才保存。以后要换服务商或认证方式,再跑一遍向导:

openclaw onboard

向导走完,用下面三条看装没装好。第二条要显示 Gateway(龙虾的主进程)在运行,第三条会在浏览器里打开控制台:

openclaw --version
openclaw gateway status
openclaw dashboard

各系统的环境准备、npm 装法和手动改配置,见 本地部署 OpenClaw(三平台)。Windows 想走 WSL2 的看 Windows + WSL 安装,要用容器的看 用 Docker 部署,放服务器跑的看 云服务器部署。装的时候报错,对照 装不上报错对照 查原因。

看清它自带哪些工具,不够再接 MCP

装好的龙虾本身就带一批内置工具:读、写、编辑文件,执行命令,操作浏览器等,完整清单以 OpenClaw 官方工具页 为准。能不能用、能用到哪一步,还要看你给它的权限和工具策略。查法是在控制台的会话里发一条 /tools,回来的就是这个会话当前生效的工具列表。

内置工具不够、要接外部服务或别家工具时,才用到一套叫 MCP 的通用接口,相当于给智能体插插头。先看懂这套接口:MCP 是什么。文件类的外部方案看 文件系统 MCP,更多可接的工具在 常用 MCP 清单 和 MCP 生态。想让它会自动开网页操作,看 浏览器自动化。

第一条任务:在工作区里新建一个文件

/tools 的列表里有读写文件的工具,就给它一条最小的任务,看它是不是真的动了手:

在工作区新建一个 hello.txt,写一行“龙虾你好”,然后读出来念给我听

工作区是龙虾放文件的目录,默认在 ~/.openclaw/workspace,拿不准就用 openclaw config get agents.defaults.workspace 查。自己打开这个目录,看 hello.txt 在不在、里面是不是那一行字。文件在,说明模型、工具调用和文件权限这一条链是通的;只有一句“已完成”的回复、工作区里却没有文件,按 工具调用失败的排查清单 查。

这一条通了,再换稍大一点的低风险任务:整理一个文件夹、抓一个网页的列表、批量改文件名,例如「把桌面上的截图按月份分文件夹」。重要数据先别交给它。执行命令这一类操作默认不弹确认(tools.exec.ask 没设时是 off),想让白名单以外的命令先问你一声,改成下面这样再重启 Gateway:

openclaw config set tools.exec.security allowlist
openclaw config set tools.exec.ask on-miss
openclaw gateway restart

想找练手场景,看 自动回复消息 和 批量抓数据。

电脑要求:接 API 看 Node 版本,跑本地模型看显存

接云端 API 跑,模型不在本机算,OpenClaw 本体要的是 Node 24.16+ 或 26.1+;本地跑开源模型才看显存,还要给上下文留地方(Ollama 对智能体任务的建议值是 64k),按显存怎么判断见 跑 OpenClaw 要什么配置,只跑模型不接龙虾的看 本地部署 AI 大模型最低配置。