快速入门指南将会向你展示最快速的安装、配置、启动方式。
完成本指南后,你将拥有一个可以自由集成不同 MCP 的服务,允许你可有控制提供给小智的 MCP 工具。
前期准备:
在开始之前,你至少需要有一个小智硬件设备,并已添加至小智官方服务端。
环境准备
请先安装好 node 与 pnpm。
如果你已经准备好 node & pnpm 可以跳过此步骤
安装Node
请前往 Node官方安装地址 进行安装,并验证安装是否成功。以下为 node:22(LTS) + pnpm 的安装方式# 下载并安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# 重启shell
\. "$HOME/.nvm/nvm.sh"
# 下载并安装 Node.js:
nvm install 22
# 验证 Node.js 版本:
node -v # 应该打印出 "v22.19.0".
# 下载并安装 pnpm:
corepack enable pnpm
# 验证 pnpm 版本:
pnpm -v
安装 xiaozhi-client 命令行工具
pnpm install -g xiaozhi-client
创建应用
# 创建应用
xiaozhi create my-app
# 进入应用目录
cd my-app
# 安装依赖
pnpm install
设置小智接入点
小智AI配置MCP接入点的 使用说明xiaozhi config set mcpEndpoint "<从小智服务端获取到的接入点地址>"
验证是否成功
最后,请前往小智服务端,检查对应的接入点,刷新后是否能获取到工具列表