# huggingfaceOpenclaw

**Repository Path**: web/huggingface_openclaw

## Basic Information

- **Project Name**: huggingfaceOpenclaw
- **Description**: huggingface搭建OpenClaw文件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenClaw 免费部署指南 集成微信渠道

## 概述

本项目提供了一套完全免费的 OpenClaw 部署方案，利用 Nvidia NIM 的免费 API 和 HuggingFace 的基础设施，让你轻松拥有一个 7x24 小时在线的 OpenClaw 实例，并且数据永久保存。

**核心特性：**
- 🚀 完全免费部署，无需服务器成本
- 🤖 集成 Nvidia NIM 免费 AI 模型
- 💾 数据持久化，支持 WebDAV 备份
- 📱 多渠道集成：支持微信、飞书、QQ 等主流 IM 平台
- 🔒 私有化部署，确保数据安全

**特别集成：**
- **微信渠道**：通过专用脚本一键安装微信插件，支持微信扫码登录和消息交互，让 AI 助手直接在微信中工作。

## 项目文件说明

- `Dockerfile`：容器构建文件，基于 Node.js 环境安装 OpenClaw
- `start-openclaw.sh`：启动脚本，负责数据恢复、配置生成和 OpenClaw 服务启动
- `sync_webdav.py`：WebDAV 备份脚本，实现数据的备份和恢复（当设置 WebDAV 环境变量时自动使用）
- `sync.py`：HuggingFace Dataset 备份脚本，实现数据的备份和恢复（默认方案）
- `install-weixin.sh`：微信插件安装脚本，一键安装和配置微信渠道
- `readme_cn.md`：中文使用指南（本文件）

## 部署步骤

### 1. 免费领取 Nvidia NIM API 密钥

1. 访问 [Nvidia NIM 官网](https://build.nvidia.com/)，注册账号。
2. 进入个人中心，找到 `API Keys` 选项，创建一个新的 API Key。
3. 复制保存 API Key，后面配置要用。

**为什么选择 Nvidia NIM？**
- 免费且稳定，内置多个 SOTA 开源模型（如 GLM-5、Llama 等）
- 接口兼容 OpenAI，无缝接入 OpenClaw
- 无需担心额度，个人使用完全足够

### 2. 在 HuggingFace Spaces 上部署 OpenClaw

#### 2.1 新建一个 Space

1. 登录 HuggingFace，进入 [Spaces 页面](https://huggingface.co/spaces)
2. 点击 `Create new Space`
3. 填写 Space 名称（随意）
4. SDK：选择 Docker
5. Template：选择 Blank
6. Privacy：建议选择 Private（私有，防止他人访问你的实例）
7. 点击创建

#### 2.2 新建一个 Dataset （如果webdav则不需要）

用于保存 OpenClaw 的会话数据和配置，避免重启丢失。

1. 点击头像，选择 `+ New Dataset`
2. 同样设置 Private 私有
3. 命名后创建

#### 2.3 创建 Access Token

1. 点击头像 → `Access Tokens` → `+ Create new token`
2. Token Type 选择 Write（需要写入权限）
3. 生成后复制保存

#### 2.4 配置 Space 的环境变量

进入刚刚创建的 Space，点击右上角 `Settings`，拉到最下方 `Variables and secrets`，添加以下内容：

**Variables（变量）**
- `OPENAI_API_BASE`：Nvidia NIM 的接口地址，填 `https://integrate.api.nvidia.com/v1`
- `MODEL`：你想使用的模型 ID，例如 `z-ai/glm4.7`
- `HF_DATASET`：你刚才创建的 Dataset 的完整名称，格式为 `用户名/数据集名`

**Secrets（密钥）**
- `OPENAI_API_KEY`：第一步申请的 Nvidia API Key
- `HF_TOKEN`：2.3 步生成的 Access Token
- `OPENCLAW_GATEWAY_PASSWORD`：你自己设定的密码，用于登录 OpenClaw 前端界面
- `WEBDAV_URL`：WebDAV 服务器地址（如 `https://your-webdav-server.com/dav/`），注意末尾需要包含路径
- `WEBDAV_USERNAME`：WebDAV 用户名
- `WEBDAV_PASSWORD`：WebDAV 密码

**注意：**
- WebDAV 服务器需要支持 HTTPS 以确保数据传输安全
- 确保 WebDAV 服务器有足够的存储空间
- 备份文件会覆盖之前的备份，建议定期下载备份以防丢失
- **自动选择**：如果同时设置了 `WEBDAV_URL` 和 `WEBDAV_USERNAME`，系统将自动使用 WebDAV 方案；否则使用 HuggingFace Dataset 方案

#### 2.4.1 WebDAV 服务器设置建议

如果你还没有 WebDAV 服务器，可以考虑以下选项：

1. **自建 WebDAV 服务器**：
   - 使用 Nextcloud 或 ownCloud 等开源软件
   - 配置 HTTPS 证书
   - 创建专用用户和目录

2. **云存储 WebDAV 支持**：
   - 某些云存储服务提供 WebDAV 接口（如某些 NAS 或企业存储）
   - 确保服务稳定且支持大文件上传

3. **测试 WebDAV 连接**：
   - 在设置环境变量前，先在本地测试 WebDAV 连接
   - 可以使用工具如 `cadaver` 或浏览器插件验证连接

#### 2.5 创建三个核心文件

在 Space 的 `Files` 标签页，依次新建以下三个文件：

**文件 1：`sync.py` 或 `sync_webdav.py`** —— 数据同步脚本，定时备份和恢复

**文件 2：`start-openclaw.sh`** —— 启动脚本

**文件 3：`Dockerfile`** —— 容器构建文件


文件创建完成后，点击 `Commit changes to main` 提交。Space 会自动开始构建，可以在 `Logs` 标签查看进度。

当看到类似下面的日志时，说明启动成功：

```
◇  Gateway connection ────────────────────╮
│                                         │
│  Gateway target: ws://127.0.0.1:7860    │
│  Source: local loopback                 │
│  Config: /root/.openclaw/openclaw.json  │
│  Bind: lan                              │
│                                         │
├─────────────────────────────────────────╯
2026-03-09T00:45:37.365Z [canvas] host mounted at http://0.0.0.0:7860/__openclaw__/canvas/ (root /root/.openclaw/canvas)
2026-03-09T00:45:37.650Z [heartbeat] started
```

现在，你可以通过 `https://你的用户名-space空间名称.hf.space` 访问 OpenClaw 前端了。

#### 2.6 使用 UptimeRobot 防止休眠

HuggingFace 免费 Space 如果 48 小时内没有外部访问，会自动休眠。

注册 UptimeRobot 后，点击 `Add New Monitor`：

- Monitor Type：HTTP(s)
- URL：你的 Space 公网地址（如 `https://yourname-yourspace.hf.space`）
- Monitoring Interval：5 分钟

保存即可。这样 Space 就会持续活跃，不会进入休眠。

### 3. 实战：配置你的 AI 助手

#### 3.1 首次登录与连接

打开前端页面，此时状态是 `未连接`。

在输入框中填入你在环境变量中设置的 `OPENCLAW_GATEWAY_PASSWORD`，点击连接，状态变为 `正常` 即可开始对话。

#### 3.2 设定人设（Persona）

为了让 AI 更贴合你的需求，我们需要编辑几个关键文件。在左侧菜单找到 `Agent` → 进入 `main` 代理，你会看到 `SOUL.md`、`IDENTITY.md` 和 `USER.md`。

- **SOUL.md**：定义 AI 的个性、原则和行事风格。
- **IDENTITY.md**：定义 AI 的基本身份信息，AI 的身份证。
- **USER.md**：定义用户自己的信息，让 AI 了解你。

#### 3.4 集成微信渠道

本项目特别集成了微信渠道，让 AI 助手可以直接在微信中工作。你可以使用提供的 `install-weixin.sh` 脚本一键安装微信插件。

**安装步骤：**

1. 运行微信插件安装脚本：
   ```bash
   bash install-weixin.sh
   ```

2. 脚本会自动执行以下操作：
   - 安装 `@tencent-weixin/openclaw-weixin` 插件
   - 启用微信插件
   - 更新插件允许列表
   - 启动微信二维码登录流程

3. 按照终端提示，使用微信扫码登录绑定。

**注意事项：**
- 确保 OpenClaw 已正确安装
- 安装过程中会自动启动登录流程，请准备好微信扫码
- 安装完成后，微信频道会出现在可用频道列表中


### WebDAV 相关问题

1. **连接失败**：
   - 检查 `WEBDAV_URL` 是否正确，包含协议（https://）和路径
   - 确认用户名和密码正确
   - 确保 WebDAV 服务器支持 HTTPS

2. **上传/下载失败**：
   - 检查服务器存储空间是否足够
   - 确认网络连接稳定
   - 查看服务器日志了解具体错误

3. **备份文件丢失**：
   - WebDAV 实现会覆盖之前的备份
   - 建议定期从 WebDAV 服务器手动下载备份文件保存

4. **性能问题**：
   - 大文件备份可能需要较长时间
   - 考虑优化网络或使用更快的 WebDAV 服务器

## 参考资料

- [腾讯云开发者社区：零成本搭建专属AI助手：OpenClaw永久免费部署全攻略](https://cloud.tencent.com/developer/article/2636433)