vscode 要真正连接并操作 docker 容器，必须满足三个硬性前置条件：docker cli 可用、remote-containers 扩展已装、用户有免 sudo 的 docker 权限。
VSCode 要真正连接并操作 Docker 容器（不是只看列表、而是进终端、同步配置、调试、端口转发），必须满足三个硬性前置条件：Docker CLI 可用、Remote-Containers 扩展已装、用户有免 sudo 的 docker 权限。
Docker CLI 必须在 VSCode 终端里能直接运行 docker ps
VSCode 的 Docker 插件和 Remote-Containers 都依赖系统级 docker 命令，不是靠图形界面或 Web API。常见失败现象是插件显示“no containers found”，但终端里 docker ps 明明有输出——那大概率是 VSCode 启动时没读到你的 shell PATH。
- Linux/macOS：检查
which docker输出路径是否在$PATH中；若用 zsh/bash 配置了别名或函数，docker命令可能不被 VSCode 继承，建议在~/.bashrc或~/.zshenv里显式导出 PATH - Windows：Docker Desktop 安装后默认把
docker.exe加入系统 PATH，但如果你用的是 WSL2 后端，得确认 VSCode 是从 WSL 环境启动的（即用code .在 WSL 终端里执行），而不是 Windows 版 VSCode 直连 WSL2 的 Docker socket（会权限报错） - 验证方式：在 VSCode 内置终端里直接运行
docker version，客户端和服务端都应有输出；若报Cannot connect to the Docker daemon，说明 daemon 没跑，或 socket 路径不对（Linux 默认/var/run/docker.sock）
必须装 ms-vscode-remote.remote-containers，不是 Docker 插件
VSCode 自带的 Docker 插件（ms-azuretools.vscode-docker）只能浏览镜像/容器/日志，点“Attach Shell”进的是 root 用户的裸 shell，不加载你的 VSCode 配置、不装插件、不转发端口、不能调试。真要容器内开发，remote-containers 是唯一入口。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 装完后，打开一个本地文件夹，按
Ctrl+Shift+P输入Remote-Containers: Open Folder in Container...，才能触发 dev container 流程 - 它会自动检测项目根目录下的
.devcontainer/devcontainer.json，或帮你生成一个；手动docker run -v $(pwd):/workspace启的容器，不会被识别为 dev container - 如果扩展装了但命令不出现，重启 VSCode（尤其是从桌面图标启动的，可能没继承 shell 环境）
当前用户必须属于 docker 组，且不能用 root 启动 VSCode
Linux 下最常卡在这步：docker ps 终端里能跑，但 VSCode 里提示 permission denied on /var/run/docker.sock。这是因为 VSCode 桌面版默认以普通用户启动，但 socket 文件权限只允许 docker 组访问。
- 执行
sudo usermod -aG docker $USER，然后完全退出当前桌面会话（不只是关 VSCode），重新登录 - 检查生效：终端里运行
groups，输出中要有docker；再试docker info | head -n1 - 绝对不要用
sudo code启动 VSCode：容器内所有文件属主会变成 root，导致npm install报 EACCES、Git 提交失败、git status显示大量 modified - macOS/Windows 用户不用操心这个，Docker Desktop 自带权限代理层
最容易被忽略的是：VSCode 启动方式决定它能不能拿到正确的环境变量和用户组权限。从终端执行 code . 启动，比双击图标可靠得多；而远程开发（SSH + 容器）时，remote-containers 实际运行在远程服务器上，所以远程用户的 docker 组权限和 docker 命令可用性才是关键，本地只是个画面终端。
