1. 为什么本地开发需要给 AI 助手放开系统权限
OpenClaw 是一个可以跑在本地、通过对话驱动系统操作的 AI 助手框架，它能读写文件、执行 shell、管理容器，适合做本地自动化、脚本编排、环境巡检这类活儿。但默认配置下它被关在沙箱里，只能碰工作区目录，很多系统级操作会被直接拦掉。Docker Compose 开发者模式就是用来解决这个矛盾的：用容器把 OpenClaw 跑起来，同时通过特权配置和挂载，把宿主机的文件系统、Docker 套接字、进程信息都交给它。
我试过在纯沙箱模式下让它改一个/etc/hosts，结果返回的是权限拒绝，日志里写着sandbox: path not allowed。这不是 bug，是设计如此。问题在于，很多本地开发场景就是需要 AI 助手去动系统配置、重启服务、拉镜像、看进程。你不可能每次都手动去补一条挂载。
所以这篇要讲的是：怎么用一份可复制的docker-compose.yml，配合 OpenClaw 的开发者模式配置，让 AI 助手在容器里拿到接近宿主机的权限，同时保留容器带来的隔离和可回滚性。适合谁？适合在本地做 AI Agent 开发、需要助手执行系统命令、又不想把整个环境搞乱的人。核心检索词就是 OpenClaw、Docker Compose、开发者模式、系统权限，下面每一步都会围绕这几个点展开。
需要提前说明的是，这套配置只用于本地开发机，不要放到公网服务器或者生产环境。容器特权加宿主机根目录挂载，等于把整台机器的控制权交出去了，风险自己心里要有数。
2. TaoToken 前置准备：给 OpenClaw 接上模型能力
OpenClaw 本身只是执行框架，真正驱动它做决策的是背后的大模型。你需要一个能稳定调用、支持长上下文、并且方便在本地配置的模型入口。TaoToken 在这里的角色就是提供统一的 API 接入层，把模型对话、Coding Plan、API Keys 管理都收在一个控制台里，省得你在 OpenClaw 配置里到处填不同厂商的地址和密钥。
先做三件事。第一，打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册并登录。第二，进控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 创建一个 API Key，这个 Key 后面要写进 OpenClaw 的配置里。第三，如果你打算长期跑编码类任务，可以看一下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它更适合高频调用场景。
API 的基础地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，配置时直接填这个。模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，你可以先在那里试一下模型是否正常返回，确认 Key 有效再往下走。
这里有个容易踩的坑：OpenClaw 的模型配置字段和普通 OpenAI 兼容客户端不完全一样，它要求 Base URL 和 Model ID 分开写，而且对model字段的格式有要求。我建议先在模型对话页面确认你要用的模型 ID，比如claude-sonnet-4-5这类，然后原样填进配置。API Keys 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，Key 泄露了可以随时在那里吊销重建。
如果你用的是 Claude Code 或者类似的 Anthropic 风格客户端，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 Base URL、Key、Model ID 三件套的完整写法。OpenClaw 的配置逻辑类似，下面第三节会给出可直接复制的 JSON 片段。
3. 可复制的 Docker Compose 与 OpenClaw 开发者模式配置
这一节是全文的核心，所有片段都可以直接复制。先建目录，再写两个文件：docker-compose.yml和openclaw-developer.json。目录结构建议这样：
mkdir -p ~/openclaw-dev/workspace cd ~/openclaw-dev然后是openclaw-developer.json，这是 OpenClaw 的运行时配置，路径要挂到容器里的/root/.openclaw/openclaw.json：
{ "meta": { "deployment": "docker-developer-mode", "description": "Docker 容器内开发者模式配置" }, "gateway": { "port": 18789, "bind": "0.0.0.0", "mode": "local", "controlUi": { "allowInsecureAuth": true, "requireHttps": false } }, "agents": { "defaults": { "workspace": "/root/.openclaw/workspace", "sandbox": { "mode": "off", "workspaceAccess": "rw" }, "tools": { "elevated": { "enabled": true, "allowFrom": ["*"] } } } }, "tools": { "profile": "full", "allow": ["*"], "deny": [], "elevated": { "enabled": true, "allowFrom": { "*": ["*"] } } }, "security": { "sandbox": { "enabled": false }, "allowedPaths": ["/"], "blockedCommands": [], "readOnlyRoot": false }, "model": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "modelId": "claude-sonnet-4-5" } }注意model这一段，Base URL 填https://taotoken.net/api，Key 换成你在控制台生成的那个，Model ID 按你实际要用的填。这三件套缺一不可，少一个就会在启动时报模型不可用。
接着是docker-compose.yml：
version: '3.8' services: openclaw-developer: image: node:18-alpine container_name: openclaw-developer hostname: openclaw-developer privileged: true cap_add: - ALL security_opt: - seccomp=unconfined - apparmor=unconfined network_mode: host ports: - "0.0.0.0:18789:18789" volumes: - ./openclaw-developer.json:/root/.openclaw/openclaw.json:ro - ./workspace:/root/.openclaw/workspace:rw - /var/run/docker.sock:/var/run/docker.sock:rw - /:/host:rw environment: - OPENCLAW_DEVELOPER_MODE=true - DOCKER_HOST=unix:///var/run/docker.sock - NODE_ENV=development command: | sh -c " npm install -g openclaw@latest && openclaw gateway " restart: unless-stopped stdin_open: true tty: true几个关键点解释一下。privileged: true加cap_add: ALL是让容器拿到所有 Linux 能力，seccomp和apparmor设为unconfined是关掉安全模块的限制。/:/host:rw把宿主机根目录挂进来，AI 助手就能读写宿主文件。/var/run/docker.sock挂进去之后，容器里可以直接执行docker ps、docker run这类命令，等于把 Docker 控制权也交出去了。
启动命令：
docker compose up -d docker compose logs -f openclaw-developer看到openclaw gateway正常监听 18789 就说明起来了。如果日志里出现model auth failed，回去检查model那三件套，尤其是 Key 有没有多余空格。
4. 验证 AI 助手能否读写宿主目录
配置写完不算完，得实际验证权限是否生效。分三层来测：容器身份、宿主文件访问、Docker 控制。
第一层，确认容器内是 root：
docker exec openclaw-developer whoami docker exec openclaw-developer id预期输出root和uid=0(root) gid=0(root)。如果不是，说明privileged没生效，检查 compose 文件缩进。
第二层，验证宿主目录读写。先在宿主机建一个测试文件：
echo "host-test-$(date +%s)" > /tmp/openclaw-host-test.txt然后在容器里读它：
docker exec openclaw-developer cat /host/tmp/openclaw-host-test.txt能打印出内容就说明挂载成功。再测写入：
docker exec openclaw-developer sh -c 'echo "written-from-container" > /host/tmp/openclaw-write-test.txt' cat /tmp/openclaw-write-test.txt宿主机能看到written-from-container就对了。
第三层，验证 Docker 控制：
docker exec openclaw-developer docker ps能列出宿主机上的容器，说明套接字挂载生效。再让 AI 助手通过对话执行一次系统命令，比如在 OpenClaw 控制台里输入「列出 /host/etc 下的文件」，看它能不能返回结果。控制台地址是http://localhost:18789。
如果对话返回的是sandbox denied或者path not allowed，说明security.sandbox.enabled还是 true，或者allowedPaths没设成["/"]。这两个字段在openclaw-developer.json里，改完重启容器即可。
验证通过后，你可以让 AI 助手做一件真实的事，比如「读取 /host/etc/hostname 并告诉我宿主机名」，或者「在 /host/tmp 下创建一个目录并写入当前时间」。能完成就说明系统权限已经打通。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
这一节按真实报错来对，每个都给出定位方法和修复动作。
401 Unauthorized。最常见，出现在模型调用阶段。日志里通常是model request failed: 401。原因就三个：Key 写错、Key 被吊销、Base URL 填成了带路径的地址。检查openclaw-developer.json里的model.apiKey和model.baseUrl，Base URL 必须是https://taotoken.net/api，后面不要加/v1或者别的。Key 去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 重新生成一个换上。
local proxy failed。这个报错通常出现在容器网络配置有问题时。如果你把network_mode: host去掉又没配端口映射，容器里的 OpenClaw 访问不到外部 API，就会报 proxy failed。修复方式是保留network_mode: host，或者显式加ports映射并确认 DNS 可用。另外检查宿主机有没有本地代理软件占用端口，容器内curl -I https://taotoken.net/api能通才算网络正常。
reading choices 相关报错。典型信息是cannot read property 'choices' of undefined，意思是模型返回体里没有choices字段。这多半是 Model ID 填错了，或者用了不兼容的模型名。去 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 确认可用模型列表，把model.modelId改成列表里存在的那个。还有一种情况是返回了错误 JSON，比如{"error": "..."}，这时候日志里会同时有 401 或 429，按对应错误处理。
OAuth 相关报错。如果你在 OpenClaw 里配了需要 OAuth 的渠道，报OAuth token expired或者invalid_grant，说明令牌过期或权限范围不对。本地开发场景建议直接用 API Key 模式，不要走 OAuth，省掉刷新逻辑。如果必须用 OAuth，去接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 看最新的回调地址和 scope 要求。
容器启动即退出。docker compose logs里如果只有npm install没有后续，多半是openclaw安装失败或者命令拼写错误。确认command段里的openclaw gateway没有多余换行，npm install -g openclaw@latest能手动跑通。
权限验证失败但配置看着没错。检查挂载路径的冒号后面有没有:rw，只读挂载会导致写入失败。另外 SELinux 开启的系统上，挂载宿主机根目录可能需要加:z或:Z标签，否则容器内看不到文件。
排查顺序建议：先看docker compose logs，再看 OpenClaw 控制台里的错误提示，最后用docker exec手动跑命令复现。大部分问题都出在 Key、Base URL、Model ID 这三件套上。
6. 把模型入口固定下来，长期开发更省事
配置跑通之后，真正影响日常效率的是模型调用的稳定性。OpenClaw 在开发者模式下会频繁发起请求，尤其是让它做多步系统操作时，一次任务可能触发十几次模型调用。如果 Key 或者地址不稳定，整个流程会断在半路。
我的做法是把 TaoToken 的 API Key 单独放在一个环境变量文件里，不直接写进 JSON，这样换 Key 不用改配置。在docker-compose.yml同级建一个.env：
TAOTOKEN_API_KEY=sk-你的密钥然后 compose 里改成：
environment: - OPENCLAW_DEVELOPER_MODE=true - DOCKER_HOST=unix:///var/run/docker.sock - TAOTOKEN_API_KEY=${TAOTOKEN_API_KEY}OpenClaw 配置里用${TAOTOKEN_API_KEY}引用。这样密钥不进版本库，也不容易在日志里泄露。
另外，如果你后面要让 AI 助手做更复杂的编码任务，比如自动改代码、跑测试、提交，建议看一下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它的调用配额更适合这种高频场景。模型对话入口 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 可以随时用来验证某个模型是否可用，换模型前先去那里试一次，比直接改配置重启容器快得多。
最后提醒一句：开发者模式下的 OpenClaw 权限很大，/host挂载的是宿主机根目录，AI 助手一条命令就能删掉你的文件。建议在专门的开发机或者虚拟机里跑，重要数据提前备份。验证完权限后，如果暂时不用，docker compose down停掉容器，别让它一直挂着。
