OpenClaw 设置

本指南将说明如何在您的 RoqueOS 服务器上安装和配置 OpenClaw 代理。

---

先决条件

先决条件

• 已安装并正在运行 RoqueOS 服务器 (查看安装指南)
• 具有对套接字 (/var/run/docker.sock) 访问权限的 Docker
• 来自 AI 提供商（OpenAI 或 Anthropic）的 API 密钥
• 服务器上至少有 4 GB 的 RAM（推荐 8 GB）

---

1. 下载 OpenClaw 镜像

OpenClaw 作为一个独立的 Docker 容器运行。请下载官方镜像：

docker pull roqueribeiro1988/roqueos-openclaw:latest

该镜像包含：

• Ubuntu 22.04
• XFCE 桌面环境
• TigerVNC + noVNC
• Chromium 浏览器
• Node.js 20
• OpenClaw 代理

---

2. 配置 API 密钥

在您的 RoqueOS 服务器的 docker-compose.yml 文件中，添加您的 AI 密钥的环境变量：

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Shanghai
      - OPENAI_API_KEY=sk-your-key-here

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Shanghai
      - ANTHROPIC_API_KEY=sk-ant-your-key-here

安全警告

切勿将您的 API 密钥提交到公共存储库中。请使用 .env 文件来存储凭据，并在 docker-compose 文件中使用 env_file: .env 来引用它。

使用 .env 文件的示例：

# .env (不要将其提交到 git！)
OPENAI_API_KEY=sk-your-key-here

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. 验证配置

使用 docker compose down && docker compose up -d 重启服务器后，验证代理模块是否可访问：

curl http://localhost:27021/agent/sessions

预期响应：

[]

---

4. 在前端访问代理

1. 打开 RoqueOS 并确保您已连接到服务器。
2. 在启动台 (Launchpad) 中，寻找 AI 助手 (AI Agent) 应用程序（带有 OpenClaw 图标）。
3. 应用程序将打开，显示聊天界面和桌面预览面板。

---

使用的端口

端口	协议	描述
27021	HTTP/WS	RoqueOS 服务器 API 和 WebSocket
5901	VNC	OpenClaw 容器的桌面 VNC
6080	HTTP	noVNC（网页访问桌面）

端口 5901 和 6080 由服务器内部管理，不需要暴露在外部。

---

可用的环境变量

变量	描述	默认值
OPENAI_API_KEY	OpenAI API 密钥	—
ANTHROPIC_API_KEY	Anthropic API 密钥	—
AGENT_MAX_SESSIONS	最大并发会话数	3
AGENT_TIMEOUT	会话超时时间（分钟）	30

---

下一步

• 如何使用 OpenClaw — 实用指南和示例