- name
- vps-agent-migration
- description
- 将本地 OpenClaw 子 Agent 迁移到 VPS 上运行。包括：rsync 复制文件、配置 Discord Bot、添加 bindings 路由、禁用本地账号避免冲突。使用场景：当需要将本地的 creative/dev/qa/strategist/pojun 等子 Agent 迁移到远程 VPS 时使用此 skill。
VPS Agent Migration
将本地 OpenClaw Agent 迁移到 VPS 上运行。
前提条件
- VPS 已安装 OpenClaw
- 本地已配置好要迁移的 Agent（workspace、SOUL.md 等）
- 需要迁移的 Agent 名称（如 creative, dev, qa 等）
- SSH 访问 VPS（sshpass 或配置 SSH key）
迁移步骤
Step 1: 连接 VPS 并复制文件
# 连接 VPS
sshpass -p 'VPS密码' ssh -o StrictHostKeyChecking=no root@VPS_IP
# 复制 Agent 文件（排除 sessions、.DS_Store、memory.md）
rsync -avz --exclude='sessions' --exclude='.DS_Store' --exclude='memory.md' \
~/.openclaw/agents/[agent名]/ root@VPS_IP:/root/.openclaw/agents/[agent名]/Step 2: 获取本地 Discord Token
从本地 ~/.openclaw/openclaw.json 中查找对应 Agent 的 token：
cat ~/.openclaw/openclaw.json | grep -A5 '"[Discord_ID]":'Step 3: 在 VPS 上添加 Discord 账号
在 VPS 上使用 Python 更新配置：
sshpass -p 'VPS密码' ssh -o StrictHostKeyChecking=no root@VPS_IP 'python3 -c "
import json
with open(\"/root/.openclaw/openclaw.json\") as f:
data = json.load(f)
data[\"channels\"][\"discord\"][\"accounts\"][\"[Discord_ID]\"] = {
\"name\": \"[Agent名字]\",
\"enabled\": True,
\"token\": \"[Token]\",
\"groupPolicy\": \"allowlist\",
\"streaming\": \"off\"
}
with open(\"/root/.openclaw/openclaw.json\", \"w\") as f:
json.dump(data, f, indent=2)
"'Step 4: 更新 Bindings
sshpass -p 'VPS密码' ssh -o StrictHostKeyChecking=no root@VPS_IP 'openclaw config set bindings \"[{\\\"agentId\\\":\\\"[agentId]\\\",\\\"match\\\":{\\\"channel\\\":\\\"discord\\\",\\\"accountId\\\":\\\"[Discord_ID]\\\"}}]\"'Step 5: 重启 VPS Gateway
sshpass -p 'VPS密码' ssh -o StrictHostKeyChecking=no root@VPS_IP "openclaw gateway restart"Step 6: 禁用本地账号
# 禁用本地账号
openclaw config patch --json '{"channels": {"discord": {"accounts": {"[Discord_ID]": {"enabled": false}}}}}'
# 重启本地 Gateway
openclaw gateway restart关键坑点
- requireMention: 默认
true会导致 Agent 不自动回复，需要在guilds中设为false - 多账号配置:
channels.discord.token是默认账号，channels.discord.accounts[id].token是多账号模式 - SSH 连接: 偶尔会断开，多试几次即可
- Token 获取: Discord Bot Token 在 openclaw.json 的
channels.discord.accounts[id].token中
常见 Discord ID 格式
- 频道 ID: 18位数字（如 1475374006226915434）
- 用户/Bot ID: 18位数字（如 1475676302215221278）