OpenClaw 管理系统是一个 Web 管理面板，用于管理和监控 OpenClaw 多 Agent 协作系统。通过浏览器访问 http://服务器IP:15500 即可使用。

系统支持多实例部署，每个 OpenClaw 实例（如 ~/.openclaw、~/.openclaw-001）可以有独立的管理面板端口。

功能说明：展示 OpenClaw 系统中所有 Agent 的组织关系。

• CEO（驿骅） — 系统最高决策者，管理所有部门
• 事业群 — 按业务线划分（跨境电商、国内电商等），每个事业群有部门负责人
• 独立模块 — 不属于任何部门的独立 Agent

使用方式：进入页面自动加载组织架构树，点击部门可展开查看下属 Agent。

功能说明：编辑每个 Bot 的核心人格文件，决定 Bot 的行为模式和说话风格。

• Bootstrap — 启动配置，定义 Bot 的基本身份和能力
• Agents — Bot 可调用的子 Agent 列表和协作规则
• Heartbeat — 心跳任务，定义 Bot 定时执行的工作
• Identity — 身份描述，定义 Bot 的名字、角色、性格
• Soul — 灵魂文件，定义 Bot 的核心价值观和决策原则
• User — 用户画像，定义 Bot 服务的目标用户群体

使用方式：

1. 在下拉菜单中选择一个 Agent
2. 通过顶部标签页切换不同文件
3. 在编辑框中修改内容
4. 点击"保存"写入生效，点击"重载"放弃修改重新读取

功能说明：展示 Discord 频道与 Bot 的绑定关系。每个 Bot 被绑定到特定的 Discord 频道，只在该频道内响应消息。

使用方式：进入页面自动加载。每行显示一个 Bot 及其绑定的频道名称和 ID。频道名称从 Vault 中的"频道ID"分类读取。

功能说明：管理 AI 模型供应商、可用模型列表，以及各 Agent 使用的模型。

添加供应商：

1. 填写供应商名称（如 dondon、openai）
2. 填写 API Base URL（如 https://api.example.com/v1）
3. 填写 API Key
4. 点击"添加供应商"

从 API 拉取模型：

1. 点击"从API拉取模型"按钮
2. 选择供应商，点击"拉取模型列表"
3. 勾选要导入的模型（新增模型默认勾选）
4. 点击"导入选中模型"

模型连通性测试：

• 单个测试：点击模型行右侧的"测试"按钮
• 批量测试：勾选要测试的模型，点击"批量测试选中模型"
• 测试会发送一个简单请求到模型 API，显示响应延迟

修改 Agent 模型：点击 Agent 行的"编辑"按钮，在弹窗中选择新模型。

功能说明：为每个 Bot 配置六级故障转移模型。当主模型不可用时，系统会自动切换到下一级备用模型，确保 Bot 始终能正常响应。

• 第一模型（主） — 优先使用的模型
• 第二~四模型（备） — 按顺序依次降级
• 第五~六模型（兜底） — 最后保障，建议选择稳定可靠的模型

使用方式：

1. 在每个 Bot 行的各级模型下拉框中选择模型
2. 修改后行背景变为绿色标记
3. 点击顶部"保存"批量提交所有修改
4. 点击"重置"放弃所有修改

功能说明：加密存储敏感信息，如 Discord Token、API Key、服务器密码等。所有数据使用 AES-256-GCM 加密。

首次使用：

1. 输入密码，点击"初始化新Vault"创建加密存储
2. 初始化后用同一密码点击"解锁Vault"

日常使用：

1. 输入密码，点击"解锁Vault"
2. 点击分类查看其中的条目
3. 点击"添加条目"新增一条记录
4. 点击"复制"将值复制到剪贴板

内置分类：Discord Bot Tokens、频道ID、类别ID、阿里云OSS配置、GitHub配置、API Keys、账号密码、VPS服务器信息、其他。

功能说明：将 OpenClaw 数据自动备份到阿里云 OSS 对象存储，防止数据丢失。

配置步骤：

1. 开启"自动备份"开关
2. 选择执行周期（每天/每周/每月/N小时/N分钟）
3. 填写阿里云 Access Key ID 和 Access Key Secret
4. 填写 Endpoint（如 oss-cn-shenzhen.aliyuncs.com）
5. 填写 Bucket 名称
6. 设置备份路径和文件名前缀（可选，多台服务器建议用不同前缀区分）
7. 设置保留数量（超过后自动删除最旧的备份）
8. 点击"保存配置"

测试与执行：

• "测试备份" — 验证 OSS 配置是否正确
• "立即备份" — 立即执行一次完整备份

功能说明：将 OpenClaw 数据打包为 tar.gz 文件保存到本地磁盘。

配置步骤：

1. 开启"自动备份"开关
2. 选择执行周期
3. 设置备份目录路径
4. 设置文件名前缀和保留数量
5. 点击"保存设置"

备份历史：显示最近的备份文件列表，可点击"另存到"将备份文件复制到 Windows 目录（桌面、下载等）。

功能说明：管理 OpenClaw 系统级配置，包括版本升级、Gateway 服务和多实例切换。

OpenClaw 版本：

• 显示当前安装版本和 npm 上的最新版本
• 点击"升级到最新版"自动执行 npm update -g openclaw

Gateway 服务管理：

• 显示 Gateway 运行状态（运行中/已停止）
• 可启动、关闭、重启 Gateway 服务

实例切换：

• 显示当前 OpenClaw 实例目录
• 点击"扫描"自动检测 ~/.openclaw* 目录
• 可手动输入实例目录路径添加
• 切换实例后管理服务自动重启

Q: 页面打不开？

A: 检查管理服务是否运行：systemctl --user status openclaw-admin，若未运行则 systemctl --user start openclaw-admin

Q: 模型测试全部失败？

A: 检查 API Key 是否正确，Base URL 是否可访问，服务器网络是否正常。可 SSH 登录后用 curl 手动测试。

Q: 云端备份失败？

A: 确认 ossutil64 已安装（which ossutil64），OSS 配置信息正确，且服务器可访问阿里云（检查是否有代理干扰）。

Q: 切换实例后页面无响应？

A: 切换实例会导致管理服务重启，等待 5-10 秒后刷新页面即可。

Q: Vault 密码忘了怎么办？

A: 可以点击"重置Vault"并输入 DELETE 确认，这会清除所有存储的敏感信息。之后重新初始化即可。

OpenClaw 支持在同一台机器上运行多个独立实例，每个实例拥有独立的配置、Agent 和 Discord Bot。通过 OPENCLAW_STATE_DIR 环境变量指定不同的配置目录来区分实例。

实例规划示例：

实例	配置目录	Gateway 端口	管理面板端口
默认	~/.openclaw/	18789	15500
001	~/.openclaw-001/	19001	15501
002	~/.openclaw-002/	19002	15502

步骤 1：创建配置目录

新建空白目录（推荐）：

mkdir -p ~/.openclaw-00X

或从现有实例复制（适合创建镜像实例）：

cp -r ~/.openclaw ~/.openclaw-00X

步骤 2：初始化配置

如果是新建空白目录，需要运行初始化向导：

OPENCLAW_STATE_DIR=~/.openclaw-00X openclaw setup

如果是从现有实例复制的，跳过此步骤，但需更新 credentials/ 目录下的 Discord Bot Token。

步骤 3：创建 Gateway systemd 服务

复制现有服务文件作为模板：

cp ~/.config/systemd/user/openclaw-gateway.service \
   ~/.config/systemd/user/openclaw-00X-gateway.service

编辑服务文件，修改以下内容：

[Unit]
Description=OpenClaw Gateway (openclaw-00X)

[Service]
ExecStart=/home/ubuntu/.nodejs/bin/node \
  /home/ubuntu/.nodejs/lib/node_modules/openclaw/dist/index.js \
  gateway --port 1900X
Restart=always
RestartSec=5
KillMode=process
Environment=HOME=/home/ubuntu
Environment=OPENCLAW_STATE_DIR=/home/ubuntu/.openclaw-00X
Environment=OPENCLAW_GATEWAY_PORT=1900X
Environment=PATH=/home/ubuntu/.local/bin:/usr/local/bin:/usr/bin:/bin

[Install]
WantedBy=default.target

注意：ExecStart 中的 node 路径请用 which node 确认实际路径。

步骤 4：启用并启动 Gateway

systemctl --user daemon-reload
systemctl --user enable openclaw-00X-gateway.service
systemctl --user start openclaw-00X-gateway.service
systemctl --user status openclaw-00X-gateway.service

步骤 5：部署管理面板

使用 install.sh 为新实例安装独立的管理面板服务：

cd ~/a002-openclaw-admin-system
bash install.sh ~/.openclaw-00X

install.sh 会自动完成以下操作：

• 根据实例名自动分配端口（如 00X 对应端口 1550X）
• 生成独立的 systemd 服务文件
• 安装必要工具（ossutil64 等）
• 配置 AI 模型接口
• 启动并启用服务

步骤 6：验证

# 查看所有 OpenClaw 服务
systemctl --user list-units --all | grep openclaw

# 查看 Gateway 日志
journalctl --user -u openclaw-00X-gateway.service -n 50 --no-pager

# 访问管理面板
curl http://localhost:1550X

必要的配置文件：

文件/目录	作用	必须
openclaw.json	主配置（models, agents, bindings）	是
credentials/	Discord bot tokens 等凭证	是
agents/	Agent 定义（人设文件等）	是
memory/	记忆存储	可选
vault/	密钥库（备份配置等）	可选

注意事项：

• 端口冲突：每个实例的 Gateway 端口和管理面板端口都必须不同
• Discord Token：复制配置时必须更新 credentials/ 下的 Bot Token，否则两个实例会冲突
• 代理配置：如果需要代理访问 Discord，需创建对应的 proxychains 配置文件并在 ExecStart 中添加 proxychains4 前缀
• 故障排查：服务启动失败时用 journalctl --user -u <服务名> -n 50 查看日志；端口冲突时用 ss -tlnp | grep <端口> 检查