项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4059
使用教程
环境要求
- 已安装 git、Node.js 与 npm(需能执行 npm install / node)
- 一个可用的模型 API key(写入 .env)
- 一个 Telegram Bot Token(agent 会以 Telegram 机器人形式上线)
- 网络可访问 GitHub 与 npm 源
安装与启动步骤
-
1克隆仓库
把模板仓库拉到本地,后续所有模板和 quickstart 目录都在这个仓库里。
git clone https://github.com/mergisi/awesome-openclaw-agents.git -
2进入快速启动目录
quickstart 目录内含 bot.js、package.json 和 .env.example,是零配置起步的入口。
cd awesome-openclaw-agents/quickstart -
3配置环境变量
复制示例环境文件后,填入你的 API key 和 Telegram token,否则机器人无法启动。
cp .env.example .env -
4挑一个模板当 SOUL
从 agents 分类目录里挑模板的 SOUL.md 复制到 quickstart 根目录,决定 agent 的角色与行为。
cp ../agents/marketing/echo/SOUL.md ./SOUL.md -
5安装依赖并启动
安装依赖后运行 bot.js,agent 即上线到 Telegram,可在聊天中直接对话测试。
npm install node bot.js
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API key | 是 | .env 中填写的大模型 API key,agent 调用模型时使用 | sk-xxxxxxxxxxxxxxxx |
Telegram token | 是 | .env 中填写的 Telegram Bot Token,用于让 bot 接入 Telegram | 123456789:AAxxxxxxxxxxxxxxxxxxxxxxxx |
SOUL.md | 是 | 放在 quickstart 目录下的 agent 角色配置,决定角色、行为与知识边界 | ./SOUL.md |
如何确认成功
node bot.js 运行无报错,并在 Telegram 中向该机器人发消息能收到回复,说明 agent 已上线。
常见问题
Q:要跑多久才能用上?
A:README 称 Quickstart 可在 5 分钟内跑起一个可用 agent,只要 API key 和 Telegram token 已准备好,无需其他配置。
Q:不想手动装环境怎么办?
A:可用 CrewClaw 生成完整部署包(Dockerfile + docker-compose + bot + README),每个模板都支持,属于第三方服务。
Q:支持 Docker 部署吗?
A:README 提到 quickstart 目录有完整 Quickstart Guide 并支持 Docker,但节选中未给出具体 Docker 命令。
Q:模板数量到底是多少?
A:README 中同时出现 205、187、100 三种说法,以仓库实际目录和 agents.json 为准。
Q:能用本地模型不接 Telegram 吗?
A:可以尝试 ollama 一键方式:ollama launch openclaw --model gemma4,会安装 OpenClaw、拉取模型并启动网关。
注意事项
- 上述命令均来自 README 的 Quickstart,README 未给出的包名、端口、路径一律不要凭空补全。
- .env 内含密钥与 Bot Token,不要提交到 Git 仓库或公开分享。
- README 中模板总数与分类数量前后不一致,以仓库实际文件为准。
- CrewClaw 是 README 中推广的付费/第三方服务,使用前请自行评估。
核心亮点
- 模板数量多且分类细,覆盖客服、编程、创作等 19 个领域,总有一款适合你
- 每个模板自带 SOUL.md 配置,明确角色设定和行为规范,上手快
- 社区活跃,持续接收新模板提交,内容保持更新
不足之处
- 模板质量参差不齐,部分模板可能缺乏深度定制
- 文档/社区待观察
适用场景
- 快速搭建特定角色的 AI 客服或助手
- 为编程项目配置智能编码辅助智能体
- 创建游戏 NPC 或虚拟角色对话系统
替代项目
awesome-ai-agents、superagent、agentgpts
上一篇:openagents
下一篇:Unity-MCP
同类项目推荐
E-commerce-Smart-Agent
开源
用 LangGraph 搭电商客服,能查知识库还能走退货流程
基于 LangGraph 和 FastAPI 的电商 AI Agent 框架。从 RAG 知识库到复杂的退货业务流的智能···
awesome-agents
开源
一张清单看全 AI 智能体生态,选型调研不迷路
Awesome list of AI Agents
carbon
开源
15章手把手从零搭编码智能体,每章都通过测试
Build a coding agent from scratch, one harness primitive at a time. 15 chapters (ch-···
ai-factory
开源
告别繁琐配置,用规范驱动快速构建 AI 智能体。
You want to build with AI, but setting up the right context, prompts, and workflows ···
eva
开源
一个文件搞定 AI 自动化,命令行直接跑,轻量又省心。
单文件智能体,Single-file zero-dependency AI agent for Linux/Windows ops
ToRA
开源
让大模型调用工具解数学题,准确率飙升
ToRA is a series of Tool-integrated Reasoning LLM Agents designed to solve challengi···
meta-ads-mcp
开源
让 AI 直接操控 Meta 广告,无需自建服务器
Meta Ads (Facebook/Instagram) MCP server for Claude, ChatGPT, Perplexity & Cursor —···
dotbot
开源
让团队 AI 开发有章可循,过程可审计
Structured, auditable AI-assisted development for teams. Zero-dependency MCP server,···
ai-crm-agents
开源
6个AI智能体自动搞定销售线索、邮件和客户跟进
Production-ready AI-powered CRM with 6 autonomous agents for lead qualification, ema···
