从零部署:基于 OpenClaw 的多用户 AI Agent 协同平台

OpenClaw MultiUser 部署教程

从零开始搭建你的多用户 AI Agent 协同平台

环境要求

依赖 版本 说明
Node.js 18+ 推荐 LTS 版本
OpenClaw 最新版 npm install -g openclaw
操作系统 Windows / Linux / macOS 本文以 Windows 为例

第一步:安装 OpenClaw

bash 复制代码
npm install -g openclaw
openclaw --version

首次运行需要配置 API Key(支持 Anthropic 官方或第三方代理):

bash 复制代码
openclaw onboard

按提示完成配置,确保能正常对话。

第二步:克隆项目

bash 复制代码
git clone https://github.com/beichuan-code/openclaw-multiuser.git
cd openclaw-multiuser

第三步:安装依赖

bash 复制代码
cd openclaw-server
npm install
cd ..

auth-server 依赖的包:

bash 复制代码
npm install jsonwebtoken http-proxy better-sqlite3

第四步:目录结构准备

创建工作目录:

bash 复制代码
mkdir -p workspace-prod/users
mkdir -p workspace-prod/canvas-prod
mkdir -p workspace-prod/template
mkdir -p workspace-prod/shared
mkdir -p workspace-prod/scripts

将文件放到对应位置:

bash 复制代码
# 前端
cp chat-prod.html workspace-prod/canvas-prod/

# 认证服务
cp auth-server.js workspace-prod/shared/auth-server-prod.js

# 团队同步脚本
cp scripts/sync-team.js workspace-prod/scripts/

# openclaw-server 保持在项目根目录

第五步:配置 Agent 模板

创建模板目录,新用户注册时会自动复制这些文件:

bash 复制代码
mkdir -p workspace-prod/template

创建 workspace-prod/template/openclaw.json:

json 复制代码
{
  "models": {
    "mode": "merge",
    "providers": {
      "default": {
        "baseUrl": "https://api.anthropic.com/",
        "apiKey": "YOUR_API_KEY",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 200000,
            "maxTokens": 16000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "default/claude-sonnet-4-6"
      }
    },
    "list": [
      {
        "id": "main",
        "name": "主Agent",
        "identity": { "name": "主Agent", "emoji": "🤖" }
      }
    ]
  },
  "tools": {
    "profile": "full",
    "agentToAgent": { "enabled": true }
  }
}

注意 :将 YOUR_API_KEY 替换为你的实际 API Key。支持 Anthropic 官方或第三方代理(修改 baseUrl)。

第六步:配置环境变量

bash 复制代码
# 必须修改!生产环境请使用强密码
export JWT_SECRET="your-strong-random-secret-here"

其他可选配置(auth-server-prod.js 顶部):

配置项 默认值 说明
PORT 19000 认证服务端口
BIND_HOST 0.0.0.0 绑定地址
GW_TOKEN 随机生成 Gateway 通信令牌
WORKSPACE_ROOT workspace-prod/users 用户数据目录
TEMPLATE_DIR workspace-prod/template 新用户模板目录

第七步:启动服务

需要启动两个服务:

1. 启动 auth-server(认证 + 代理)

bash 复制代码
node workspace-prod/shared/auth-server-prod.js

2. 启动 openclaw-server(头像 + 消息存储)

bash 复制代码
cd openclaw-server
node src/index.js

使用 PM2 管理(推荐)

bash 复制代码
npm install -g pm2

pm2 start workspace-prod/shared/auth-server-prod.js --name auth-server
pm2 start openclaw-server/src/index.js --name openclaw-server
pm2 save
pm2 startup  # 开机自启

第八步:访问系统

打开浏览器访问:

bash 复制代码
http://your-server-ip:19000/static/chat-prod.html

首次登录

系统会自动创建管理员账号:

  • 用户名:admin
  • 密码:首次访问时设置

创建普通用户

管理员登录后,在设置中可以创建新用户。每个新用户会自动:

  1. 从模板复制配置文件
  2. 启动独立的 OpenClaw Gateway 进程
  3. 获得完全隔离的工作空间

第九步:添加更多 Agent

在前端通讯录页面添加新 Agent,或直接编辑用户的 openclaw.json:

json 复制代码
{
  "agents": {
    "list": [
      { "id": "main", "name": "凌霄", "identity": { "name": "凌霄", "emoji": "🌤" } },
      { "id": "dev", "name": "开发", "identity": { "name": "开发", "emoji": "💻" } },
      { "id": "writer", "name": "写作", "identity": { "name": "写作", "emoji": "✍️" } }
    ]
  }
}

保存后系统会自动热重载 Gateway,无需手动重启。

常见问题

Q: Gateway 启动失败?

检查 OpenClaw 是否正确安装:

bash 复制代码
openclaw --version
openclaw gateway run --port 28000

Q: 端口被占用?

bash 复制代码
# Linux/Mac
lsof -i :19000
# Windows
netstat -ano | findstr :19000

Q: 多用户内存占用大?

每个用户一个 Gateway 进程,约占 200-500MB。100+ 用户建议:

  • 服务器至少 32GB 内存
  • 使用按需唤醒策略(不活跃用户暂停 Gateway)

Q: 如何使用第三方 API 代理?

修改模板中的 baseUrl:

json 复制代码
{
  "baseUrl": "https://your-proxy.com/",
  "apiKey": "your-proxy-key"
}

支持所有 Anthropic API 兼容的代理服务。

架构图

sql 复制代码
                    ┌─────────────────────────────────┐
                    │         用户浏览器 (chat-prod.html)        │
                    └──────────────┬──────────────────┘
                                   │ HTTP/SSE
                    ┌──────────────▼──────────────────┐
                    │     auth-server (:19000)         │
                    │   JWT 认证 + 反向代理 + 文件服务  │
                    └──┬───────┬───────┬──────────────┘
                       │       │       │
              ┌────────▼┐ ┌───▼────┐ ┌▼────────┐
              │ User-A   │ │ User-B │ │ User-C  │
              │ GW:28001 │ │ GW:28002│ │ GW:28003│
              └────┬─────┘ └───┬────┘ └────┬────┘
                   │           │            │
              ┌────▼─────┐    ...          ...
              │ 凌霄(main)│
              │ 砚池(dev) │
              │ 映川(video)│
              └──────────┘

更新升级

bash 复制代码
cd openclaw-multiuser
git pull origin master
pm2 restart all

如有问题,欢迎提 Issue:github.com/beichuan-co...

相关推荐
chh5637 小时前
从 BERT 到大模型:让模型从“会接龙”到“会回答
人工智能·深度学习·bert
TomEval8 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
ZhengEnCi8 小时前
AI 总模仿代码库里的过时写法怎么办:先清坏样例,再用类型与测试让 AI 无法犯错
人工智能·ai编程
一只爱撸猫的程序猿9 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
GitCode官方9 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
老金带你玩AI10 小时前
GPT-6.2更强更便宜了,为什么还有人骂?
人工智能
CyrusYiVPP10 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
泯泷10 小时前
OpenClaw 退潮背后,是 AI 圈“技术自嗨”的终结
人工智能·chatgpt·llm
罗西的思考10 小时前
【轻量化复刻大模型 / KIMI K3】Muon 优化器及 训练系统
人工智能·算法·机器学习
屿华AI10 小时前
AUTOSAR 实战-诊断工具 | 用 Claude Code 开发诊断测试工具:AI 协作开发实践
人工智能·测试工具