Menu
Configure, deploy, and manage OpenClaw Team multi-agent deployment — model assignment, docker-compose config, remote deployment via SSH/Tailscale.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
macOS-specific automation: iMessage/SMS messaging and desktop control (screenshots, clicks, keyboard input).
Messaging platform integrations: email (IMAP/SMTP via Himalaya), X/Twitter (xurl CLI), and Yuanbao groups (@mentions, DMs).
Control creative software programmatically: ComfyUI (AI image/video generation via REST/WebSocket API) and TouchDesigner (real-time visual programming via MCP).
Systematic engineering disciplines: debugging (root cause investigation), TDD (test-first development), and exploratory QA (web app testing).
Creative coding: p5.js sketches, Manim animations, Pretext text layouts.
Create, read, edit .pptx decks, slides, notes, templates.
| name | openclaw-team-deploy |
| description | Configure, deploy, and manage OpenClaw Team multi-agent deployment — model assignment, docker-compose config, remote deployment via SSH/Tailscale. |
| version | 1.0.0 |
| author | Hermes Agent |
| license | MIT |
| metadata | {"hermes":{"tags":["openclaw","deployment","docker","model-config","devops"],"related_skills":["openclaw-troubleshooting"]}} |
~/WorkStation/mine/claw/openclaw/（本地），/opt/openclaw/（远程）~/WorkStation/mine/claw/ClawTeam/（本地），/opt/openclaw-team/（远程）~/.openclaw/，通过 LaunchAgent 管理root@ubuntu24.tailcc8506.ts.net（Tailscale）openclaw.service，EnvironmentFile=/opt/openclaw-team/.envTeam 使用两个主力模型：
| 模型 | 端点 | Agent（10个） |
|---|---|---|
| qwen3.6-plus | coding.dashscope.aliyuncs.com/v1 | orchestrator, dev, ads, project, qa, spatial, game, finance, hr, supply-chain |
| GLM-5.1 (astron-code-latest) | maas-coding-api.cn-huabei-1.xf-yun.com/v2 | pm, design, sales, marketing, support, expert, academic, legal |
qwen3.6-plus Agent：
environment:
- OPENAI_API_KEY=${ALIYUN_API_KEY}
- OPENAI_BASE_URL=${ALIYUN_BASE_URL}
- OPENAI_MODEL=qwen3.6-plus
GLM-5.1 Agent：
environment:
- OPENAI_API_KEY=${IFLYTEK_API_KEY}
- OPENAI_BASE_URL=${IFLYTEK_OPENAI_URL}
- OPENAI_MODEL=${IFLYTEK_MODEL}
# 阿里通义
ALIYUN_API_KEY=sk-sp-xxx
ALIYUN_BASE_URL=https://coding.dashscope.aliyuncs.com/v1
# 科大讯飞
IFLYTEK_API_KEY=app_id:api_secret
IFLYTEK_OPENAI_URL=https://maas-coding-api.cn-huabei-1.xf-yun.com/v2
IFLYTEK_ANTHROPIC_URL=https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic
IFLYTEK_MODEL=astron-code-latest
# 数据库
POSTGRES_PASSWORD=xxx
ORCHESTRATOR_DB_PASS=xxx
DEV_DB_PASS=xxx
# ... 各 Agent 独立 DB 密码
ClawTeam 仓库已配置自动 Git 同步（scripts/git-sync.sh）：
com.clawteam.git-sync，每 5 分钟运行一次2-59/5 * * * *），每 5 分钟运行一次git add 提交还是加入 .gitignore同步日志：
/tmp/git-sync-local.log/tmp/git-sync-remote.log手动触发同步：
# 本地
bash ~/WorkStation/mine/claw/ClawTeam/scripts/git-sync.sh local
# 远端
ssh root@ubuntu24.tailcc8506.ts.net "bash /opt/openclaw-team/scripts/git-sync.sh remote"
# 1. 本地编辑配置后提交
cd ~/WorkStation/mine/claw/ClawTeam
git add docker-compose.yml && git commit -m "feat(config): ..."
git add openclaw-secretariat/openclaw.json && git commit -m "feat(secretariat): ..."
git push
# 2. 远端自动同步（5分钟内生效），或手动触发
ssh root@ubuntu24.tailcc8506.ts.net "bash /opt/openclaw-team/scripts/git-sync.sh remote"
# 3. 如果 .env 有变更（.env 不在 git 中），单独 scp
scp .env root@ubuntu24.tailcc8506.ts.net:/opt/openclaw-team/.env
# 4. 重启受影响的容器（用 --no-deps 只重建变更的）
ssh root@ubuntu24.tailcc8506.ts.net "cd /opt/openclaw-team && docker compose up -d --no-deps openclaw-pm openclaw-design ..."
scp .env docker-compose.yml root@ubuntu24.tailcc8506.ts.net:/opt/openclaw-team/
ssh root@ubuntu24.tailcc8506.ts.net "cd /opt/openclaw-team && docker compose up -d --no-deps <affected-containers>"
# 检查容器状态（启动后需等 1-2 分钟 health check 才会变 healthy）
ssh root@ubuntu24.tailcc8506.ts.net "sleep 60 && docker ps --format 'table {{.Names}}\t{{.Status}}'"
# 如果容器在 Restarting 循环，立即查看日志排查
ssh root@ubuntu24.tailcc8506.ts.net "docker logs <container> --tail 30"
# 检查 Sentinel
ssh root@ubuntu24.tailcc8506.ts.net "systemctl status openclaw.service --no-pager"
# 查看状态
ssh root@ubuntu24.tailcc8506.ts.net "systemctl status openclaw.service --no-pager"
# 启动/停止/重启
ssh root@ubuntu24.tailcc8506.ts.net "systemctl start/stop/restart openclaw.service"
# 查看日志
ssh root@ubuntu24.tailcc8506.ts.net "journalctl -u openclaw.service --no-pager -n 50"
Sentinel 的 .env 可能被意外还原为占位符（FEISHU_SENTINEL_APP_ID=cli_xxxx），但长期运行的进程不受影响——只有系统重启或服务重启时才会暴露问题。
症状：
code: 1000040346, system busyGET /open-apis/bot/v3/info 返回 Bad Request排查：
# 确认实际加载的 App ID
ssh root@ubuntu24.tailcc8506.ts.net "grep FEISHU_SENTINEL_APP_ID /opt/openclaw-team/.env"
# 如果返回 cli_xxxx，说明是占位符
# 从备份中查找历史真实值
ssh root@ubuntu24.tailcc8506.ts.net "for f in /opt/openclaw-team/backups/env/.env.backup.*; do echo \"\$(basename \$f)\"; grep FEISHU_SENTINEL \$f; done"
修复：
/opt/openclaw-team/.env 填入真实值ssh root@ubuntu24.tailcc8506.ts.net "systemctl restart openclaw.service"| 错误码 | 含义 | 可能原因 |
|---|---|---|
1000040346, system busy | 飞书拒绝连接 | App ID/Secret 错误、应用被禁用、权限不足 |
Cannot read properties of undefined (reading 'PingInterval') | 代码 bug | WebSocket 连接失败后的错误处理缺陷（伴随出现） |
bot identity background retry N/5 failed | Bot 身份验证失败 | App ID/Secret 不匹配，或应用未发布 |
sk-sp-* 前缀的 Key 仅对 coding.dashscope.aliyuncs.com/v1 有效dashscope.aliyuncs.com/compatible-mode/v1 会返回 HTTP 401.env 中 ALIYUN_BASE_URL 和 openclaw.json 中 models.providers.qwen.baseUrl 必须保持一致OPENAI_API_KEY + OPENAI_BASE_URL + OPENAI_MODEL 三个变量必须匹配scp 前先用 ssh -o ConnectTimeout=5 测试连通性docker compose up 会被 Hermes 误识别为长驻进程，需使用 background=true + process(action='wait').env、运行时目录（.openclaw/）、日志（*.log）、密钥（*.key/*.pem）、缓存（__pycache__/、.venv/）等自动进入 .gitignoregit add 并提交.gitignorescripts/git-sync.sh），两边共用workspace-main/ 目录可能包含嵌套的 .git（早期 Agent 初始化遗留）git status 显示 ?? workspace-main/ 且无法纳入团队 git 管理find /opt/openclaw-team -maxdepth 3 -name ".git" -type d# 只删除嵌套 .git 目录，保留文件由 Team 统一管理
rm -rf /opt/openclaw-team/openclaw-design/workspace-main/.git
rm -rf /opt/openclaw-team/openclaw-support/workspace-main/.git
.gitignore 应只忽略 workspace-main/.openclaw/（运行时目录），不要忽略整个 workspace-main/git add -f workspace-main/ 纳入团队管理git status --short、git diff --name-status、git diff 查看具体变更，不要盲目 stash/resetgit reset --hard：会永久丢失未提交的本地修改。如必须对齐远端，先 git stash push --include-untracked 保存git pull --rebase，避免 merge commitscripts/git-sync.sh 或 .gitignore 的 auto-sync 冲突 → git rebase --skip（跳过重复提交）reset + clean + pull 等长命令拆成独立步骤，每步单独超时控制tailscale status 确认可达性，超时用 ConnectTimeout=10 + ServerAliveInterval=5sync(dirs): timestamp）env_file 不会展开 ${VAR} 变量引用.env 中写 ALIYUN_COMPAT_KEY=${ALIYUN_API_KEY} → 容器收到的是字面字符串 ${ALIYUN_API_KEY}，不是实际 Key.env 中每个变量必须写完整真实值，不能互相引用sed 替换为真实值后重启容器health: starting 状态会持续 1-2 分钟health: starting 或 unhealthy，查看日志排查编辑 ~/.openclaw/openclaw.json 添加新模型 provider：
{
"models": {
"providers": {
"iflytek": {
"baseUrl": "${IFLYTEK_OPENAI_URL}",
"api": "openai-completions",
"models": [{
"id": "astron-code-latest",
"name": "GLM-5.1",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 200000,
"maxTokens": 65536,
"api": "openai-completions"
}]
}
}
},
"auth": {
"profiles": {
"iflytek:default": {
"provider": "iflytek",
"mode": "api_key"
}
}
}
}
重启生效：launchctl stop ai.openclaw.gateway && launchctl start ai.openclaw.gateway
| Agent | Gateway 端口 | Web 端口 |
|---|---|---|
| orchestrator | 18001 | 13001 |
| dev | 18002 | 13002 |
| pm | 18003 | 13003 |
| design | 18004 | 13004 |
| ads | 18005 | 13005 |
| sales | 18006 | 13006 |
| marketing | 18007 | 13007 |
| project | 18008 | 13008 |
| qa | 18009 | 13009 |
| support | 18010 | 13010 |
| spatial | 18011 | 13011 |
| expert | 18012 | 13012 |
| game | 18013 | 13013 |
| secretariat（本地） | 18789 | — |