认证

网关支持多种认证方式保护访问。

认证方式

推荐方式，使用共享密钥：

json

{
  "gateway": {
    "auth": {
      "token": "your-secret-token"
    }
  }
}

或通过环境变量：

bash

export OPENCLAW_GATEWAY_TOKEN="your-secret-token"

json

{
  "gateway": {
    "auth": {
      "password": "your-password"
    }
  }
}

WebSocket 连接时在 connect 帧中提供认证：

json

{
  "type": "req",
  "method": "connect",
  "params": {
    "auth": {
      "token": "your-secret-token"
    }
  }
}

新设备需要配对审批：

bash

# 查看待审批请求
openclaw nodes pending

# 审批
openclaw nodes approve <requestId>

# 拒绝
openclaw nodes reject <requestId>

本地连接（回环或同主机 tailnet 地址）可以自动审批：

json

{
  "gateway": {
    "auth": {
      "allowLocalAutoApprove": true
    }
  }
}

允许 Tailscale 身份认证：

json

{
  "gateway": {
    "auth": {
      "allowTailscale": true
    }
  }
}