ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

rescue-gateway

为 OpenClaw 配置稳定可维护的 Rescue Gateway。适用于主 Gateway 已存在、需要第二个 Discord Rescue Bot、需要独立端口和独立 launchd label、需要避免主 gateway stop 误伤 rescue gateway、需要默认 full exec 权限且不走审核的场景。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/cchaojiejes/openclaw-rescue-gateway-skill
Or

Rescue Gateway 2.0

当主 Gateway 故障时,Rescue Gateway 提供独立入口。此版本的目标不是“能跑起来”,而是“能长期维护,不和主 Gateway 互相干扰”。

适用场景

  • 已安装 OpenClaw 主 Gateway
  • 需要第二个 Discord Bot,名称如 OpenClaw Rescue Bot
  • 需要 Rescue Gateway 独立运行在 19001
  • 需要默认 exec 全权限且不审核
  • 需要避免 openclaw gateway stop 把 rescue 一起停掉

结论先行

Rescue Gateway 的推荐落地方式是:

  • 配置目录使用官方 profile:~/.openclaw-rescue/openclaw.json
  • CLI 使用官方 profile:openclaw --profile rescue ...
  • 服务不用官方默认 label ai.openclaw.rescue
  • 服务改用独立 launchd label:ai.openclaw.gateway.rescue

原因:

  • profile 配置目录是对的,后续维护简单
  • 但在实际使用中,官方 profile service 的 gateway stop 可能和主 gateway 生命周期串扰
  • 独立 label 可以把 rescue 的启动/停止边界切干净

目录和端口

项目主 GatewayRescue Gateway
Config~/.openclaw/openclaw.json~/.openclaw-rescue/openclaw.json
State~/.openclaw~/.openclaw-rescue
Workspace~/.openclaw/workspace~/.openclaw-rescue/workspace
Port1878919001
launchd labelai.openclaw.gatewayai.openclaw.gateway.rescue

端口必须至少错开 20。OpenClaw 会派生浏览器和调试端口,不能重叠。

Rescue Config

优先做法:以主配置为模板,写入 ~/.openclaw-rescue/openclaw.json

关键要求:

  • channels.discord.token 使用 Rescue Bot token
  • gateway.port 使用 19001
  • agents.defaults.workspace 使用 ~/.openclaw-rescue/workspace
  • agents.list[0].agentDir 使用 ~/.openclaw-rescue/agents/rescue/agent
  • tools.exec.security = "full"
  • tools.exec.ask = "off"
  • agents.defaults.elevatedDefault = "full"
  • plugins.entries.acpx.enabled = true
  • plugins.entries.acpx.config.permissionMode = "approve-all"

最小关键片段:

{
  "agents": {
    "defaults": {
      "elevatedDefault": "full",
      "workspace": "/Users/YOUR_NAME/.openclaw-rescue/workspace"
    },
    "list": [
      {
        "id": "rescue",
        "workspace": "/Users/YOUR_NAME/.openclaw-rescue/workspace",
        "agentDir": "/Users/YOUR_NAME/.openclaw-rescue/agents/rescue/agent",
        "subagents": { "allowAgents": ["*"] }
      }
    ]
  },
  "bindings": [
    {
      "agentId": "rescue",
      "match": { "channel": "discord" }
    }
  ],
  "tools": {
    "profile": "full",
    "exec": {
      "security": "full",
      "ask": "off"
    }
  },
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_RESCUE_BOT_TOKEN"
    }
  },
  "gateway": {
    "port": 19001,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "YOUR_RESCUE_GATEWAY_TOKEN"
    }
  },
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "permissionMode": "approve-all"
        }
      }
    }
  }
}

Rescue Agent Auth

Rescue agent 使用独立 agentDir,不会自动继承主 agent 的认证。

如果 rescue bot 能登录 Discord,但回复时报:

  • No API key found for provider "anthropic"
  • No API key found for provider "kimi-coding"

就把主 agent 的认证复制过去:

cp ~/.openclaw/agents/main/agent/auth-profiles.json \
  ~/.openclaw-rescue/agents/rescue/agent/auth-profiles.json

Metadata

Stars4017
Views0
Updated2026-04-11
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-cchaojiejes-openclaw-rescue-gateway-skill": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.