# HiEuler_PI_XClaw

**Repository Path**: hieulerpi/HiEuler_PI_XClaw

## Basic Information

- **Project Name**: HiEuler_PI_XClaw
- **Description**: 海鸥派基于XClaw家族的应用示例仓库
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-16
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">HiEuler_PI_XClaw 🦞</h1>

<p align="center">
  <strong>海鸥派XClaw，可开箱即食。🍤</strong>
</p>

## 📢支持列表

快速基准对比请查看ZeroClaw或PicoClaw的项目开源地址。

| 官网地址                                 | 项目开源地址                                                 | 介绍                                                         | 应用文档                                       |
| ---------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------------------------------- |
| [ZeroClaw](https://www.zeroclawlabs.ai/) | [GitHub - zeroclaw-labs/zeroclaw](https://github.com/zeroclaw-labs/zeroclaw) | Rust 原生的"性能怪兽"，追求极致性能，低内存占用，启动速度快；适用于生产环境，安全稳定；但配置复杂，前期投入大，不适合快速原型验证，需要丰富生态。 | [ZeroClaw应用指南](./docs/ZeroClaw应用指南.md) |
| [PicoClaw](https://www.zeroclawlabs.ai/) | [GitHub - sipeed/picoclaw](https://github.com/sipeed/picoclaw) | Go 语言的"轻量之王"，低内存占用，启动速度快，跨平台编译方便；适用于嵌入式/边缘设备方案，嵌入式场景的不二之选；但高级功能不完善，需要丰富生态。 | [PicoClaw应用指南](./docs/PicoClaw应用指南.md) |

## 简介

XClaw——AI智能体，该仓库是海鸥派基于XClaw家族的应用示例，仅对适用于嵌入式的XClaw在海鸥派进行应用。主要内容是对于XClaw的编译、部署、应用以及控制硬件外设的例程，目前支持ZeroClaw和PicoClaw。

在使用前，请按照下方列表准备板端环境。

- 准备海鸥派开发板，[海鸥派淘宝购买链接](https://gitee.com/link?target=https%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fabbucket%3D13%26id%3D755989596567%26skuId%3D5948917988054)。
- 下载[【易百纳】Euler Pi 2.0](https://gitee.com/link?target=https%3A%2F%2Fpan.baidu.com%2Fs%2F1GwvuEjbLGsMLyX8kkG8dlQ%3Fpwd%3Ds7hs)资料并烧录Linux系统，固件目录为`03. 开发板镜像烧录说明/01.出厂固件包/02.Linux`。

## 目录

```
├── docs			# XClaw应用文档
├── LICENSE
├── README.md
└── skills			# 示例skill
```

## 使用说明

- 全面教程从应用文档开始，点击👆[支持列表](#📢支持列表)相应的应用文档即可开始；如追求快速应用、使用方便，建议使用PicoClaw。😄
- 支持开箱即食，移步至👇[快速开始](#🚀快速开始)章节即可开始。😋
- 对于频道，均选择对国内环境友好的QQ。

## 🚀快速开始

1. QQ官方推出了对接XClaw的官方[页面](https://q.qq.com/qqbot/openclaw/index.html)，创建QQ机器人。**需记住ID和Secret，后面会用到。**

   ![image-20260319180151256](./pic/image-20260319180151256.png)

2. 跳转发行版[v0.1.2](https://gitee.com/hieulerpi/HiEuler_PI_XClaw/releases/tag/v0.1.2)下载相应固件和配置文件并拷贝至板端。

   - ZeroClaw：拷贝`zeroclaw`文件到`/root`目录下，拷贝`config.toml`文件到`/root/.zeroclaw`目录下，如果没有相应目录请创建。

   - PicoClaw：拷贝`picoclaw`文件到`/root`目录下，拷贝`config.json`文件到`/root/.picoclaw`目录下；拷贝拥有CA证书的服务器的证书文件到板端的`/etc/ssl/certs`目录下，x86_64的服务器CA证书一般在`/etc/ssl/certs/ca-certificates.crt`，如果没有相应目录请创建。

     为避免CA证书因时间不符合生效日期而失效，请设置RTC时钟为当前时间。

     ```shell
     # 如当前时间为2026.03.31，根据情况修改
     date -s "2026-03-31 19:30:00"
     hwclock -w
     ```

3. 修改配置文件添加API key和QQ的ID、Secret；**【注意】这里以MiniMax-M2.7为例**。

   - ZeroClaw：修改`/root/.zeroclaw/config.toml`文件

     ![image-20260320185553903](./pic/image-20260320185553903.png)

   - PicoClaw：修改`/root/.picoclaw/config.json`文件

     ![image-20260320185955512](./pic/image-20260320185955512.png)

4. 启动。

   - ZeroClaw：

     ```shell
     #本地交互
     ./zeroclaw agent
     
     #长期运行模式
     ./zeroclaw daemon
     ```

     本地交互，**Ctrl+C退出**。

     ![image-20260320155428418](./pic/image-20260320155428418.png)

     长期运行模式，**Ctrl+C退出**。

     ![image-20260320155514123](./pic/image-20260320155514123.png)

     此时QQ可发消息交流。

     ![image-20260319184318006](./pic/image-20260319184318006.png)

   - PicoClaw：

     ```shell
     #本地交互
     ./picoclaw agent
     
     #网关运行模式
     ./picoclaw gateway
     ```

     本地交互，**Ctrl+C退出**。

     ![image-20260320182720784](./pic/image-20260320182720784.png)

     网关运行模式，**Ctrl+C退出**。

     ![image-20260320182905963](./pic/image-20260320182905963.png)

     此时QQ可发消息交流。

     ![image-20260320182953036](./pic/image-20260320182953036.png)

5. 后台运行，需添加环境变量，如下。

   - ZeroClaw：

     ```shell
     #!/bin/sh
     
     export PATH=/usr/local/bin:/usr/local/sbin:$PATH
     export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
     export HOME=/root
     export USER=root
     export SHELL=/bin/sh
     
     /root/zeroclaw daemon > /dev/null 2>&1 &
     ```
   
   - PicoClaw：
   
     ```shell
     #!/bin/sh
     
     export PATH=/usr/local/bin:/usr/local/sbin:$PATH
     export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
     export HOME=/root
     export USER=root
     export SHELL=/bin/sh
     
     /root/picoclaw gateway > /dev/null 2>&1 &
     ```
     

## 进阶案例

| 案例                                                         | 介绍                                                         |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| [XClaw ECHO 智能外设协同控制系统](./docs/xclaw_echo/README.md) | ECHO 智能外设协同控制系统是一款基于 **XClaw 异构计算架构**的嵌入式机器人外设控制底座，实现从云端（QQ 机器人）到核心算力平台（SS928V100），再到边缘控制平台（Hi3516CV610）的全链路指令透传与硬件驱动。 |
| [XClaw ARM智能机械臂控制](./docs/xclaw_arm/README.md)        | ARM 智能机械臂控制系统是一款基于 **XClaw 异构计算架构**的嵌入式机器人外设控制底座，实现从云端（QQ 机器人）到核心算力平台（SS928V100），再到SO-ARM101机械臂的全链路指令透传与硬件驱动。 |