Initial ClawDBot Docker space

Dockerfile

@@ -0,0 +1,31 @@
+FROM node:22-bookworm
+
+WORKDIR /app
+
+# Enable modern package managers (optional but harmless)
+RUN corepack enable
+
+# Install Clawdbot CLI (includes Gateway + Web UI)
+RUN npm install -g clawdbot@latest \
+    && mkdir -p /data/config /data/workspace /data/state
+
+# Runtime directories for config and state
+ENV CLAWDBOT_CONFIG_DIR=/data/config
+ENV CLAWDBOT_WORKSPACE_DIR=/data/workspace
+ENV CLAWDBOT_STATE_DIR=/data/state
+
+# Default environment (Hugging Face Spaces overrides PORT)
+ENV NODE_ENV=production
+ENV PORT=7860
+
+# Clawdbot honors CLAWBOT_GATEWAY_PORT for the Gateway HTTP/WebSocket port
+ENV CLAWBOT_GATEWAY_PORT=${PORT}
+
+# Expose HTTP port for Spaces / local Docker
+EXPOSE 7860
+
+# Start Gateway bound to LAN, using PORT (or 7860) and allowing first-run
+# without a prewritten config file. Auth/token should be configured via
+# env vars or config once the Space is up.
+CMD ["sh", "-c", "export CLAWBOT_GATEWAY_PORT=${PORT:-7860}; clawdbot gateway --bind lan --port ${PORT:-7860} --allow-unconfigured --verbose"]
+

README.md

@@ -0,0 +1,164 @@
+---
+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` 目录下：
+
+```bash
+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
+```
+
+然后在浏览器打开：
+
+```text
+http://localhost:7860
+```
+
+首次启动时，容器会：
+
+- 使用 `npm install -g clawdbot@latest` 安装最新版 ClawDBot
+- 在容器内部启动 Gateway（Web UI + WebSocket）
+- 监听 `PORT`（默认 7860，对应 Hugging Face Spaces 的默认端口）
+
+如需持久化配置和会话，可以绑定本地目录到容器的 `/data`：
+
+```bash
+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` 下）：
+
+   ```bash
+   cd /home/luck/xzy/0126project
+   git init
+   git add .
+   git commit -m "Initial ClawDBot Docker space"
+   ```
+
+3. 将 Hugging Face Space 作为远程仓库添加（URL 示例）：
+
+   ```bash
+   git remote add origin https://huggingface.co/spaces/acpr123/clawdbot
+   ```
+
+4. 使用你的 Hugging Face 账户凭证（用户名 + Token）推送代码：
+
+   ```bash
+   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` 文件，例如：
+
+```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** 分平台的推送与调试说明
+