Botpress开发

技能简介

Botpress开发（botpress-adk）是使用 Botpress Agent Development Kit (ADK) 构建 AI 机器人的综合指南。ADK 是一个基于约定的 TypeScript 框架，文件结构直接映射到机器人行为。

能做什么

• 创建 Botpress AI 机器人项目
• 添加 AI 可调用的工具（Tools）
• 创建可复用的业务逻辑（Actions）
• 设计工作流（Workflows）处理后台任务
• 存储结构化数据（Tables）
• 处理事件（Triggers）
• 构建知识库（Knowledge Base）用于 RAG
• 集成外部服务（Slack、Chat 等）

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install botpress-adk

安装 ADK CLI：

macOS & Linux：

curl -fsSL https://github.com/botpress/adk/releases/latest/download/install.sh | bash

Windows PowerShell：

powershell -c "irm https://github.com/botpress/adk/releases/latest/download/install.ps1 | iex"

验证：adk --version

前置要求：Botpress 账号（https://app.botpress.cloud）、Node.js v22+、包管理器（bun 推荐）

快速开始：

adk init my-bot — 创建项目

cd my-bot && npm install — 安装依赖

adk login — 登录 Botpress Cloud

adk add chat — 添加聊天集成

adk dev — 启动开发服务器

adk chat — 在 CLI 中测试

adk deploy — 部署到生产

组件对应目录：

• 对话处理：src/conversations/
• AI工具：src/tools/
• 业务逻辑：src/actions/
• 工作流：src/workflows/
• 数据表：src/tables/
• 事件触发：src/triggers/
• 知识库：src/knowledge/

AI-Native 特点：不使用传统意图/实体，而是使用 execute() 让 AI 自然理解用户意图，通过 Tools 让 AI 自主调用函数，使用 zai.extract() 进行结构化数据提取。

输入与输出

见下方输入与输出表格。

风险提示

• 需要 Node.js v22+ 和 Botpress 账号
• 文件位置很重要，组件必须放在正确的 src/ 子目录
• ADK 不使用传统意图模式，请勿创建意图/实体/对话流
• 开发服务器运行在 http://localhost:3001/
• 原始页信息不足：缺少完整的代码示例和项目模板

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/yueranlu/botpress-adk/SKILL.md

来源类型：GitHub