Back to Articles
Mar 5, 20261 week ago

A Step-by-Step Tutorial: Building Your First Lobster Army

泊舟@bozhou_ai

AI Summary

This article is a comprehensive, beginner-friendly guide to building a team of AI assistants, or a "Lobster Army," using the OpenClaw framework. It promises to take readers with zero prior experience from initial setup to managing a coordinated multi-agent system within a couple of hours. The guide demystifies the process by breaking it down into clear, sequential steps, starting with environment installation and the creation of a primary "manager" agent on Telegram, then progressively empowering it with memory, coding, and web search capabilities. The core of the tutorial moves beyond creating a single chatbot to explore the philosophy and practicalities of building an effective team. A key insight is the emphasis on designing agents based on distinct contexts and knowledge bases rather than just specific tools or output formats. The article advises against unnecessary fragmentation—like having separate agents for front-end and back-end programming—and instead promotes creating agents for coherent workflows, such as a dedicated research agent or a content creation agent. This approach ensures each member of your "army" develops specialized expertise and memory without redundant overlap. Finally, the guide walks you through the technical steps of deploying multiple agents to work together in a group chat, handling configuration, permissions, and launch commands. It concludes by framing the initial setup as merely the first step, encouraging ongoing interaction and training to cultivate truly capable digital assistants. For anyone curious about harnessing the collaborative power of AI agents without getting lost in complexity, this tutorial offers a compelling and actionable entry point to start building and experimenting today.

这是一篇从零开始搭建 OpenClaw AI Agent 军团的完整教程。你将学会:

安装和配置 OpenClaw 环境

创建第一个 AI Agent(大总管)

为 Agent 添加记忆、编程、搜索等核心能力

组建多个 Agent 协同工作的团队

适合人群:零基础小白,几乎不需要手动操作,跟着步骤走即可
预计时间:1-2 小时

目录

一、安装环境

二、创建 Telegram Bot

三、定义 Agent 人格

四、配置记忆方案

五、配置 Coding 方案

六、添加眼睛(浏览和搜索能力)

七、安装 Skills

八、安全守则

九、组建龙虾军团

十、后续优化

一、安装环境

1.1 准备工作

这里以 Mac 为例,首先打开终端:

1.2 安装步骤

第一步:安装 Homebrew

第二步:安装 Node.js

第三步:安装 OpenClaw

执行 openclaw --version 如果出现版本号,证明安装成功。如果没有,重新执行第三步。

二、创建 Telegram Bot

2.1 为什么选择 Telegram

接下来搭建第一个龙虾(大总管),首先需要一个通讯渠道。我们选择 Telegram,因为配置非常方便,对新手特别友好。

2.2 创建 Bot 步骤

打开 Telegram,搜索 @BotFather:

发送 `/start` 开始对话,然后按顺序操作:

1. 发送 `/newbot`(创建新机器人)

2. 输入 Bot 显示名称(例如:马斯克)

3. 输入 Bot 用户名(必须以 `_bot` 结尾,例如:`musk_bot`,注意不能与他人重复)

成功后,BotFather 会返回一个 Token,格式类似:

7691627338:AAHo9ix-evUZaz2FgmVAF9juHohsSSX3KOa

保存这个 Token,同时注意消息中的 `t.me/xxx` 链接,点击即可进入机器人对话页面。

2.3 初始化 OpenClaw

打开终端,输入命令:

进入安装向导后,按照以下步骤配置:

1. 第一步:选择 `yes`(使用方向键向左,因为默认是 `no`)

2. 第二步:选择 `QuickStart`

3. 第三步:选择模型

- 推荐使用最好的模型:Gemini、ChatGPT 或 Claude

- 这里选择 OpenAI,通过方向键选择,按回车确认

- 选择 Codex 进行认证

- 注意:需要将 VPN 开启 TUN 模式

4. 第四步:选择通讯频道

- 选择 Telegram(第一个选项),按回车

- 粘贴刚才保存的 Token

5. 第五步:选择 Skills

- 选择 `no`,后面手动安装

6. 第六步:填写 API Key

- 全部选择 `no`

7. 第七步:Enable hooks?

- 使用方向键选择 `Skip for now`,按空格,再按回车

8. 第八步:选择 UI 页面

- 选择 `Open the Web UI`,即可看到 UI 界面

2.4 配置代理

安装完成后,还需要配置代理才能发送消息。OpenClaw 需要通过代理访问 Telegram。

首先查看 VPN 工具的代理端口,例如 Clash Verge 的端口是 7897,如果不清楚的,可以去问一下网页端的AI,教你找出来(我现在电脑上开启了vpn,我想只知道我的代理端口是什么,怎么查找,我的代理软件是 xxx):

执行以下命令配置代理:

然后执行:

给 Bot 发送第一条消息时,会提示进行放行,按照消息内容在终端执行即可。

三、定义 Agent 人格

3.1 介绍自己

首先向 Agent 介绍自己:

- 如何称呼你

- 你的背景

- 所在时区

3.2 定义人格和行为规则

编辑 `~/.openclaw/workspace/SOUL.md` 文件,这是最重要的配置。参考示例:

3.3 配置工具权限

定义好后,让 Agent 更新配置。如果提示没有权限,打开 UI 界面:

1. 点击左侧的配置

2. 点击 Tools

3. 选择 `exec tool`

4. 点击 `raw` 进行文件修改

修改为:

完成后,你就拥有了一个可以对话并完成任务的聊天机器人。

四、配置记忆方案

4.1 记忆方案选择

市面上有多种记忆方案:

- calicastle 三层架构(社区方案)

- openclaw-memory(官方 Skill)

- openclaw-engram(社区插件)

- Supermemory / Mem0(云服务方案)

这里不深入技术理论,最终采用的方案是 MemOS,我个人整体体验最好,且有官方插件。

4.2 安装 MemOS

告诉 AI:

然后在 https://memos-dashboard.openmem.net/cn/apikeys 申请一个密钥,填入配置。与 AI 沟通改好后,让 AI 关闭原先的记忆处理。

五、配置 Coding 方案

5.1 为什么需要 Coding 能力

要让龙虾干好事情,Coding 能力非常重要。推荐使用 Codex 或 Claude Code 来进行编码,让小龙虾把任务委托给这些 Coding Agent,而不是自己做。

5.2 配置编程任务规则

首先让大总管帮你安装好 Claude Code 和 Codex,然后将下面的规则给到你的龙虾,让他参考修改编程任务的规则:

六、添加眼睛(浏览和搜索能力)

6.1 浏览器插件

推荐使用 Browserwing 插件,告诉 AI:

帮我安装下 browserwing,根据 https://raw.githubusercontent.com/browserwing/browserwing/main/INSTALL.md

6.2 搜索能力配置

简单搜索 - Tavily或者exa

每月 1000 次免费额度

申请地址:Tavily API Platform

如果担心用完,可以使用 Agent Reach 的 Exa 进行语义搜索

深度调研 - Codex

让 Codex 调用 websearch 功能进行调研

网页抓取 - Agent Reach

支持全网语义搜索

支持小红书、推特、YouTube、Reddit、B站、RSS 等平台

Tavily 是自带的,只需申请 API Key。Codex 前面已经安装好了。Agent Reach 需要单独安装,告诉 AI:

六、添加眼睛(浏览和搜索能力)

6.1 浏览器插件

推荐使用 Browserwing 插件,告诉 AI:

帮我安装下 browserwing,根据 https://raw.githubusercontent.com/browserwing/browserwing/main/INSTALL.md

6.2 搜索能力配置

简单搜索 - Tavily

每月 1000 次免费额度

申请地址:Tavily API Platform

如果担心用完,可以使用 Agent Reach 的 Exa 进行语义搜索

深度调研 - Codex

让 Codex 调用 websearch 功能进行调研

网页抓取 - Agent Reach

支持全网语义搜索

支持小红书、推特、YouTube、Reddit、B站、RSS 等平台

Tavily 是自带的,只需申请 API Key。Codex 前面已经安装好了。Agent Reach 需要单独安装,告诉 AI:

帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

6.3 搜索规则总结

将以下规则写到 Agents.md:

L1 快速搜索 — Exa 语义搜索,秒级,用于事实查询、单点问题
L2 平台抓取 — Agent Reach 上游工具(xreach/yt-dlp/gh/Jina/mcporter),用于指定平台或 URL 的内容提取
L3 深度调研 — 将任务指派给 Codex 让其调用 websearch 功能进行调研,交付结构化报告

选择:有 URL/指定平台 → L2|一句话能答 → L1|多源对比/"帮我调研" → L3
原则:默认 L1 起步,不够再升级;L3 必须注明来源;平台内容优先原生工具

七、安装 Skills

7.1 注册 ClawHub

访问 clawhub.ai 注册账号,然后:

点击头像

选择设置

点击 Create Token

保存 Token

7.2 安装必备 Skills

打开终端,执行以下命令:

Skills 非常多,推荐两个必装的:

self-improving-agent:总结经验自动学习

find-skills:查找 Skills

skill-creator: 创建skill

后面需要什么功能,直接让 AI 调用 Skills 帮你查找即可。

八、安全守则

我对这块确实研究不多,这部分建议直接参考余弦大佬@evilcos整理的文档,把下面的这个文档直接发给你的龙虾 ,让他自查一下:

OpenClaw 极简安全实践指南

九、组建龙虾军团

9.1 Agent 设计原则

在创建多个 Agent 之前,需要明确一个重要原则:根据上下文来区分 Agent,而不是根据职责。

不推荐的做法:

创建十几个 Agent,分别负责前端、后端、小红书、公众号、编导、镜头拆分等

推荐的做法:

编程功能统一委托给 Codex,所有 Agent 都具备这个能力,无需单独拆分

多平台写作对一个 Agent 来说只是不同的 Skills,上下文可以隔离清楚

什么是上下文?

上下文就是 Agent 完成任务所需的历史信息和背景知识。比如:

写一篇文章需要知道:主题、风格、目标读者、之前的讨论

调研一个技术需要知道:调研目的、已有信息、需要的深度

判断标准:什么时候该拆分 Agent?

应该拆分 Agent 的情况:

✅ 上下文会持续积累且互不干扰

例子:调研 Agent 积累行业知识,写作 Agent 积累写作风格

✅ 需要不同的"记忆"和"专业知识"

例子:技术调研 Agent vs 市场调研 Agent

✅ 工作流程完全独立

例子:内容创作流程 vs 代码开发流程

不应该拆分的情况:

❌ 只是工具不同,但上下文相同

错误:前端 Agent、后端 Agent(都是编程,上下文在 Codex)

❌ 只是输出格式不同

错误:小红书 Agent、公众号 Agent(都是写作,只是 Skills 不同)

❌ 任务之间需要频繁共享信息

错误:需求分析 Agent、架构设计 Agent(应该是一个 Agent 的不同阶段)

实际场景对比

场景 1:内容创作

❌ 错误做法:创建 5 个 Agent

选题 Agent、大纲 Agent、写作 Agent、配图 Agent、发布 Agent

✅ 正确做法:创建 2 个 Agent

内容 Agent(负责选题→大纲→写作→配图,上下文连贯)

发布 Agent(负责多平台发布,需要记住各平台的规则和历史数据)

场景 2:产品开发

❌ 错误做法:按技术栈拆分

React Agent、Node.js Agent、数据库 Agent

✅ 正确做法:按项目阶段拆分

产品 Agent(需求→设计→原型,积累产品理解)

开发 Agent(委托 Codex 编程,协调整体开发)

测试 Agent(测试用例→执行→报告,积累质量标准)

场景 3:数据分析

❌ 错误做法:按工具拆分

Python Agent、SQL Agent、可视化 Agent

✅ 正确做法:按分析类型拆分

业务分析 Agent(理解业务指标,积累业务知识)

技术分析 Agent(性能监控,积累系统知识)

决策流程

创建新 Agent 前问自己:

1. 这个任务需要独立的"记忆"吗?

是 → 继续

否 → 用现有 Agent + 新 Skill

2. 上下文会和其他 Agent 冲突吗?

是 → 创建新 Agent

否 → 继续

3. 任务之间需要频繁共享信息吗?

是 → 合并到一个 Agent

否 → 创建新 Agent

4. 只是工具或格式不同吗?

是 → 用 Skill 解决

否 → 创建新 Agent

9.2 创建多个 Agent

以创建两个 Agent 为例:

佩奇:负责调研

格雷厄姆:负责写作

步骤 1:创建 Bot Token

参照前面的方式,为两个 Agent 分别创建 Bot Token。

步骤 2:设置群聊权限

对 BotFather 输入:

/setprivacy

选择你的 Bot

选择 Disable

这样 Bot 就能读取群内消息了。

步骤 3:创建群组并获取 ID

点击 New Group 创建群组

输入群组名称

将你的 Bot 拉入群组

步骤 4:获取用户 ID 和群组 ID

搜索 @userinfobot 机器人

选择 user,点击自己的头像

选择 Group,点击你创建的群组

会获得两个 ID:一个以 -10 开头,一个以 56 开头

保存这两个 ID

9.3 配置 Agent

由于配置比较复杂,可以使用现成的提示词模板:

https://github.com/bozhouDev/openclaw_agent_create_prompt/blob/main/Agent-create-prompt.md

将模板内容修改后,把文件路径给到你的 Agent,让他来进行配置。

9.4 启动军团

配置完成后,执行:

openclaw gateway restart

然后就可以在群里 @ 机器人进行聊天了。

十、后续优化

搭建完成只是养虾的第一步。接下来需要:

多与 Agent 沟通,布置任务

总结技能和经验

将好的文章分享给龙虾学习

让 Agent 总结技能和经验

同时我们龙虾还是有很多的命令,可以帮我们解决很多事情,这里直接贴出来神老师的做的速查表 @berryxia

随着时间推移,你的龙虾会越来越强大。