# OpenClaw 零成本部署攻略笔记（完整版）

本文整合自：

• 腾讯云：零成本搭建专属 AI 助手
• 知乎：永久免费 OpenClaw 部署（续）：踩坑记录和实操指南

---

# 核心目标

利用 免费 API + 免费基础设施，搭建一个：

• 7x24 小时在线
• 数据永久保存
• 完全免费

的 OpenClaw 私有 AI 助手实例。

---

# 一、免费 API 申领

# 1.1 NVIDIA NIM API（推荐）

1. 访问 NVIDIA NIM 官网 注册账号
2. 进入个人中心 → API Keys → 创建新的 API Key
3. 复制保存备用

请求地址： https://integrate.api.nvidia.com/v1

注意：免费版有速率限制 40RPM，白嫖多了可能被进一步限速。

# 1.2 硅基流动（国内推荐）

• 注册地址：https://cloud.siliconflow.cn/i/DrgxdqSF
• 免费额度：+16 元
• 请求地址： https://api.siliconflow.cn/v1
• 推荐模型：Pro / 系列

# 1.3 七牛云

• 注册地址：https://s.qiniu.com/YBVZ73
• 免费额度：+1000 万 Token
• 请求地址： https://api.qnaigc.com/v1

---

# 二、HuggingFace Spaces 部署

# 2.1 新建 Space

1. 登录 HuggingFace
2. 进入 Spaces 页面
3. 点击 Create new Space
4. 配置如下：

配置项	建议值
SDK	Docker
Template	Blank
Privacy	公开（私有空间只有登录时才能访问）

# 2.2 新建 Dataset（持久化存储）

用于保存 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 → Settings → Variables and secrets

Variables（变量）：

变量名	值
OPENAI_API_BASE	API 请求地址
MODEL	模型 ID，如 z-ai/glm4.7
HF_DATASET	用户名 / 数据集名

Secrets（密钥）：

变量名	值
OPENAI_API_KEY	API Key
HF_TOKEN	HuggingFace Access Token
OPENCLAW_GATEWAY_PASSWORD	自定义登录密码

# 2.5 创建核心文件

# Dockerfile

FROM node:22-slim

RUN apt-get update && apt-get install -y --no-install-recommends \
    git openssh-client build-essential python3 python3-pip \
    g++ make ca-certificates && rm -rf /var/lib/apt/lists/*

RUN pip3 install --no-cache-dir huggingface_hub --break-system-packages
RUN npm install -g openclaw@latest --unsafe-perm

WORKDIR /app
COPY sync.py .
COPY start-openclaw.sh .
RUN chmod +x start-openclaw.sh

ENV PORT=7860
EXPOSE 7860

CMD ["./start-openclaw.sh"]

# sync.py（数据同步脚本）

负责从 Dataset 拉取数据（启动时）和上传数据（定时）。

# start-openclaw.sh（启动脚本）

• 补全目录
• 恢复数据
• 生成配置
• 启动定时备份
• 运行 OpenClaw（后台运行，避免 gateway 重启导致容器挂掉）

# 2.6 验证启动

文件创建完成后：

1. 点击 Commit changes to main 提交
2. 在 Logs 标签查看构建进度
3. 看到 Gateway 启动日志表示成功

访问地址： https://{user}-{space}.hf.space

---

# 三、防止休眠

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

解决方案：UptimeRobot

1. 注册 UptimeRobot
2. 点击 Add New Monitor
3. 设置每 5 分钟访问一次你的 Space

---

# 四、消息通道接入指南

OpenClaw 的核心亮点：一个 Gateway 连接所有消息通道。

# 4.1 接入飞书

最新版 OpenClaw 已内置飞书支持，不需要额外安装插件。

1. 前往 飞书开发平台 创建应用
2. 获取 AppID 和 AppSecret
3. 在事件与回调中，采用长连接订阅事件
4. 给应用开通权限

踩坑记录：如果飞书无法接收图片，需添加图片上传权限。

# 4.2 接入企业微信

# 安装插件
openclaw plugins install @wecom/wecom-openclaw-plugin

# 添加渠道
openclaw channels add

注意：企业微信机器人只能在企业内部群中使用。

# 4.3 接入个人微信

通过企业自建应用接入：

# 安装插件
openclaw plugins install @openclaw-china/wecom-app

# 配置
openclaw china setup

---

# 五、技能系统接入指南

Skill 是将最佳实践代码化和文件化的机制。

# 5.1 Skill 安装方式

方式 1：复制粘贴（最简单）

把 skill 包放到 ~/.openclaw/skills/ 文件夹下。

方式 2：从技能市场安装

clawdhub install self-improving-agent

方式 3：Skills CLI 安装

npx skills add vercel-labs/skills@find-skills -g

# 5.2 推荐的 Skill

1. find-skills - 技能发现
2. self-improving-agent - 自我改进，记录经验教训
3. skill-vetter - 安全审查，安装第三方 skill 前检查
4. using-superpowers - 技能使用规则
5. agent-browser - 浏览器自动化
6. frontend-design - 前端界面设计
7. code-reader-v2-cn - 源代码深度理解

---

# 六、实战配置

# 6.1 首次登录

1. 打开前端页面
2. 输入 OPENCLAW_GATEWAY_PASSWORD
3. 点击连接，开始对话

# 6.2 设定人设（Persona）

在左侧菜单 Agent → main 中编辑：

• SOUL.md - AI 的个性、原则
• IDENTITY.md - AI 的身份信息
• USER.md - 用户信息

# 6.3 动态添加模型

直接在聊天中操作，AI 会自动修改配置。

---

# 七、常见问题

# Q1: UI 修改配置后重启被覆盖？

启动脚本每次都会重新生成配置文件。

# Q2: 登录前端提示 404？

检查 Space 构建状态、环境变量配置、端口。

# Q3: 配置文件重启后丢失？

确保 HF_DATASET 和 HF_TOKEN 已正确配置。

# Q4: 反应慢？

大概率是 LLM 请求被限速了。考虑更换 API 供应商。

---

# 八、注意事项

1. 免费服务不可控：适合个人试用，生产环境建议购买服务器
2. 数据安全：Dataset 设为 Private
3. 定期检查：UptimeRobot 监控
4. Space 要公开：私有空间只有登录时才能访问

---

# 相关资源

• OpenClaw 官方文档
• OpenClaw GitHub
• OpenClaw 社区
• 技能市场

---

整理时间：2026-04-06