Hugging Face's logo

Spaces:
acpr123
/
clawdbot
Sleeping

App Files Community
2
clawdbot / README.md
Hugging Face Deploy
Initial ClawDBot Docker space
0ddba4e
preview code
|
Raw
History Blame
4.58 kB
metadata 
title: ClawDBot Gateway on Hugging Face (Docker)
emoji: 🦞
colorFrom: red
colorTo: yellow
sdk: docker
pinned: false

ClawDBot 在 Hugging Face 上的 Docker 部署

这个目录包含一个最小化的 Docker 配置，用来在 Hugging Face Spaces 上运行 ClawDBot Gateway。

你可以：

  • 本地用 Docker 启动并访问 ClawDBot 网页控制台
  • 将本目录推送到 Hugging Face spaces 仓库（如 acpr123/clawdbot）并在线运行

注意：请不要把任何私密 Token（例如 Hugging Face Token、OpenAI / Anthropic API Key 等）提交到 Git 仓库，而是通过 Hugging Face 的 Secrets 或本地环境变量注入。

1. 本地构建与运行

在 0126project 目录下：

cd /home/luck/xzy/0126project

docker build -t clawdbot-hf .

docker run \
  -p 7860:7860 \
  -e CLAWBOT_GATEWAY_TOKEN="your-gateway-token" \
  --name clawdbot-hf \
  clawdbot-hf

然后在浏览器打开：

http://localhost:7860

首次启动时，容器会：

  • 使用 npm install -g clawdbot@latest 安装最新版 ClawDBot
  • 在容器内部启动 Gateway（Web UI + WebSocket）
  • 监听 PORT（默认 7860，对应 Hugging Face Spaces 的默认端口）

如需持久化配置和会话，可以绑定本地目录到容器的 /data：

docker run \
  -p 7860:7860 \
  -e CLAWBOT_GATEWAY_TOKEN="your-gateway-token" \
  -v "$PWD/data:/data" \
  --name clawdbot-hf \
  clawdbot-hf

2. 推送到 Hugging Face Spaces（以 acpr123 为例）

  1. 在 Hugging Face 网页上创建一个新的 Space：

    • Owner：acpr123
    • Space 名称：例如 clawdbot
    • SDK：选择 Docker

  2. 在本机初始化 Git 仓库（在 0126project 下）：

    cd /home/luck/xzy/0126project
git init
git add .
git commit -m "Initial ClawDBot Docker space"

  3. 将 Hugging Face Space 作为远程仓库添加（URL 示例）：

    git remote add origin https://huggingface.co/spaces/acpr123/clawdbot

  4. 使用你的 Hugging Face 账户凭证（用户名 + Token）推送代码：

    git push -u origin main  # 或 master，视你本地默认分支而定

    推送时会提示输入用户名和密码：

    • 用户名：acpr123
    • 密码：你的 Hugging Face Access Token（形如 hf_...）

    不要在本仓库的任何文件中明文写入 Token；仅在 Git 推送认证或 HF 控制台的 Secrets 中使用。

  5. 推送完成后，Hugging Face 会自动根据 Dockerfile 构建镜像并启动 Space。构建完成后，访问 Space 页面即可打开 ClawDBot 控制台。

3. 在 Hugging Face 配置环境变量 / Secrets

在 Space 的 Settings → Variables and secrets 中添加：

  • CLAWDBOT_GATEWAY_TOKEN（Secret）

    • 用作 Gateway 控制台登录 Token
    • 建议设置为随机长字符串

  • 模型相关 API Key（按需）：

    • ANTHROPIC_API_KEY
    • OPENAI_API_KEY
    • GOOGLE_API_KEY（Gemini）
    • 其他你计划使用的模型提供商 Key

在容器内，ClawDBot 会自动读取这些环境变量，无需修改代码。

提示：Hugging Face 上设置为 Secrets 的变量不会出现在构建日志中，也不会存入仓库。

4. .env 示例（本地开发可选）

如果你想在本地用 docker run --env-file .env 的方式启动，可以在本目录下创建 .env 文件，例如：

PORT=7860

# ClawDBot Gateway 安全 Token（用于控制台登录）
CLAWDBOT_GATEWAY_TOKEN=your-gateway-token

# 可选：模型提供商配置
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-openai-...
GOOGLE_API_KEY=AIza...

再次强调：不要提交实际的密钥到任何公共仓库。

5. 目录说明

当前仓库仅包含运行 ClawDBot Gateway 所需的最小 Docker 配置：

  • Dockerfile：构建使用最新 npm 版本 ClawDBot 的镜像
  • README.md：本说明文档

ClawDBot 自身的代码和 UI 由 npm install -g clawdbot@latest 在镜像构建时自动获取，无需手动拷贝源码。

6. 后续可扩展方向

  • 在 /data/workspace 中挂载自定义 AGENTS.md / SOUL.md / USER.md / MEMORY.md 等，打造专属 Lobster Personality
  • 通过 ClawDBot 控制台配置 WhatsApp / Telegram / Slack / Discord 等消息渠道
  • 配置本地模型或其他托管模型，实现多模型路由

如果你需要，我也可以在本目录中再补一份：

  • 一页式部署速查表（中文版）
  • 或按 Windows / macOS / Linux 分平台的推送与调试说明