本指南将分层次、分场景进行说明

核心原则

1. 最小权限原则：只授予用户或服务完成其任务所必需的最小权限。
2. 纵深防御：在网络、主机、应用、数据等多个层面设置防护,不依赖单一控制点。
3. 默认拒绝：所有未明确允许的访问,均应被拒绝。

网络层访问控制

这是第一道,也是最重要的防线。

1. 防火墙配置

   • 限制源IP：如果OpenClaw仅供内部团队使用，在防火墙或安全组规则中，只允许来自公司内网IP段或VPN IP段的流量访问OpenClaw的服务端口（如Web的80/443，API的特定端口）。
   • 端口控制：
     • Web UI端口：仅开放HTTPS（建议443），将HTTP（80）重定向至HTTPS。
     • API端口：如果API与Web分离,同样仅对必要IP开放。
     • 管理端口：如SSH（22）、数据库端口（如MySQL的3306， Redis的6379）严禁对公网开放,仅允许通过跳板机或运维专用通道访问。
   • 云服务商安全组：如果在阿里云、AWS、腾讯云等平台部署,务必检查并加固安全组规则。

2. 反向代理与Web服务器配置

   • 使用Nginx/Apache作为反向代理：这不仅是性能优化,也是安全加固。
   • 在Nginx中设置访问限制：

     # 在server块或location块中，限制特定路径的访问
     location /admin/ {
         allow 10.0.1.0/24; # 只允许管理员网段
         deny all;
         proxy_pass http://openclaw_backend;
     }
     location /api/v1/ {
         # 可以在此处进行初步的IP限制或速率限制
         limit_req zone=api burst=10 nodelay;
         proxy_pass http://openclaw_backend;
     }

3. 部署环境选择

   • 纯内网部署：最高安全级别,服务完全不出公网。
   • VPN/零信任网关接入：对外网访问，要求先连接公司VPN或零信任网络（如Cloudflare Zero Trust, Tailscale）。
   • 公网部署：必须结合强身份认证、速率限制、WAF等更多措施。

应用层访问控制

1. 身份认证

   • 启用强认证：禁用默认或测试账号。
   • 支持多种登录方式：
     • LDAP/AD集成：与企业统一账户系统对接,方便管理。
     • OAuth 2.0 / SSO：支持通过Google、GitHub、企业微信等登录,实现单点登录。
     • 本地密码策略：如启用，必须强制要求密码复杂度、定期更换。
   • 多因素认证：为核心管理功能或所有登录启用MFA（如TOTP、短信/邮件验证码）。

2. 权限管理

   • 基于角色的访问控制：在OpenClaw管理后台中，清晰划分角色和权限。
     • 系统管理员：拥有全部权限，包括用户管理、系统配置、模型部署。
     • 项目/团队管理员：管理特定项目内的资源、成员和模型。
     • 开发者/数据科学家：可以使用平台进行模型训练、调试、部署API。
     • 普通用户/访客：只能使用已授权的公开API或查看特定项目结果。
   • API密钥管理：
     • 为程序调用提供API Key,而非使用用户密码。
     • 在管理界面允许用户创建、吊销、查看使用日志。
     • 为不同Key设置不同的权限范围和速率限制。

3. 会话管理

   • 设置合理的会话超时时间。
   • 提供“注销所有会话”功能。

API访问控制

1. 认证与鉴权

   • 所有API调用必须携带有效的认证令牌（如JWT）或API Key。
   • 在API网关或应用中间件中,验证令牌的有效性和权限。

2. 速率限制

   • 防止滥用和DDoS攻击，根据用户、IP或API Key设置调用频率上限。
   • 普通用户 60次/分钟，VIP用户 1000次/分钟。

3. 输入验证与输出过滤

   • 对所有API输入进行严格的验证和清理,防止注入攻击。
   • 对返回的数据进行过滤,确保用户只能看到其权限范围内的数据。

数据与资源层访问控制

1. 数据库权限

   • 为OpenClaw应用创建专用的数据库用户，并授予最小必要权限（通常是SELECT, INSERT, UPDATE, DELETE，而非DROP, GRANT）。
   • 定期审计数据库访问日志。

2. 文件存储与模型存储

   • 确保训练数据、模型文件等存储资源（如S3、MinIO、NAS）的访问权限被正确设置。
   • 使用预签名URL等技术进行临时授权访问,而非直接暴露存储桶。

3. 容器与宿主机

   • 如果使用Docker/K8s,以非root用户运行容器。
   • 限制容器的内核能力，避免使用--privileged模式。

审计与监控

1. 开启详细日志

   • 访问日志：记录所有登录尝试（成功/失败）、API调用、管理操作。
   • 操作日志：记录关键数据变更、模型部署、配置修改。
   • 确保日志包含：时间戳、用户/客户端IP、操作内容、结果。

2. 集中日志与分析

   • 将日志收集到ELK（Elasticsearch, Logstash, Kibana）、Loki或云日志服务。
   • 设置告警规则，
     • 同一IP短时间大量登录失败。
     • 管理员账号在非工作时间登录。
     • 高频的API调用错误。

3. 定期安全审查

   • 定期检查用户账户和权限分配。
   • 审查API Key的使用情况,吊销闲置Key。
   • 更新系统和依赖库的补丁。

配置清单

OpenClaw的访问控制是一个系统工程，需要从外到内层层设防，建议根据您的实际部署场景（纯内网、混合云、公有云）和团队规模，选择并实施上述最相关的措施。始终从“默认拒绝”开始，再逐步开放必要的访问路径。