1. 为什么我选择在本地跑 OpenClaw 而不是云端OpenClaw 是一个开源的自主 AI 智能体框架能让你用自然语言指挥电脑完成文件整理、代码生成、网页抓取、邮件收发这类闭环任务。它最大的特点是本地部署、数据不出机器同时兼容 Claude、GPT-4o、Ollama、DeepSeek 等主流模型。适合谁适合想把 AI 智能体真正跑在自己机器上、又不想把隐私数据交给云端的开发者以及想研究 Agent 工具调用链路的技术爱好者。我一开始图省事直接在云主机上跑结果发现两个问题一是文件操作类技能在云端没有实际意义二是每次调试都要重新传配置。后来改成在本地用 Docker 加 Node.js 双环境部署既能隔离依赖又能随时切换模型通道。这篇文章就把我踩过的坑和最终跑通的配置完整写出来包括 Docker Compose 文件、Node.js 版本管理命令以及用 TaoToken 统一 Key 接入模型通道的验证步骤。整个流程分四块环境准备、容器与 Node 双方案、模型通道接入、请求验证与排障。你跟着做半小时内能在本地看到 OpenClaw 的 Web 控制台跑起来并且成功发出第一条模型请求。2. 部署前的环境准备与依赖版本选择2.1 系统与硬件底线OpenClaw 对系统要求不算高。Windows 10/11 64 位建议开 WSL2兼容性比原生 PowerShell 好很多macOS 12 以上 Intel 和 Apple Silicon 都支持Linux 用 Ubuntu 20.04、Debian 或 CentOS 都行。硬件最低双核 CPU、4GB 内存、200MB 空闲磁盘但如果你要跑本地模型或者同时开多个技能推荐四核、8GB 以上内存、500MB 磁盘。我实测下来4GB 内存跑纯 API 模式够用但一旦开启浏览器抓取技能内存会飙到 3GB 以上所以还是留点余量。2.2 Node.js 版本管理OpenClaw 要求 Node.js v18推荐 v22 LTS。别用系统自带的 Node版本太旧会报Unsupported engine错误。用 nvm 管理最省心# 安装 nvmmacOS/Linux curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # 安装并切换到 Node 22 nvm install 22 nvm use 22 node -v # 应输出 v22.x.xWindows 用户用 nvm-windows命令类似。切换完记得nvm alias default 22否则新开终端又回到旧版本。2.3 国内网络优化安装依赖时如果卡在下载环节先配镜像源npm config set registry https://registry.npmmirror.com pnpm config set registry https://registry.npmmirror.com这一步不做后面npm install -g openclaw-cn大概率超时。配完可以用npm config get registry确认。2.4 Docker 环境如果你走容器方案先装 Docker DesktopWindows/macOS或 Docker EngineLinux装完执行docker version确认守护进程在跑。Windows 用户注意开启 WSL2 后端否则容器网络会出问题。3. Docker Compose 与 Node.js 双方案配置3.1 Docker Compose 完整配置容器方案适合服务器部署和隔离环境。我用的docker-compose.yml如下路径和端口都按官方默认来version: 3.8 services: openclaw: image: openclaw/openclaw:2026.4.15 container_name: openclaw restart: unless-stopped ports: - 18789:18789 environment: - TZAsia/Shanghai - OPENCLAW_MODELclaude-3-5-sonnet - OPENCLAW_API_BASEhttps://taotoken.net/api - OPENCLAW_API_KEYsk-你的TaoToken密钥 volumes: - ~/.openclaw:/root/.openclaw stdin_open: true tty: true启动命令docker compose up -d docker exec -it openclaw bash openclaw init --full exitOPENCLAW_API_BASE指向 TaoToken 的 API 地址OPENCLAW_API_KEY填你在控制台生成的 Key。这样容器启动后模型通道就已经接好了不用再进交互向导。3.2 Node.js 全局安装方案不想用 Docker 的话直接全局装npm install -g openclaw-cnlatest openclaw --version输出版本号就说明装好了。然后初始化openclaw onboard向导会问你选哪个模型服务商、填 API Key、开哪些技能。这里模型服务商选自定义或 OpenAI 兼容Base URL 填https://taotoken.net/apiKey 填你的 TaoToken 密钥Model ID 填claude-3-5-sonnet或你套餐里支持的模型。3.3 配置文件对照不管哪种方案最终都落到~/.openclaw/config.json。关键字段如下{ model: claude-3-5-sonnet, apiBase: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, skills: [file, terminal, search], port: 18789 }三件套必须齐全Base URL、Key、Model ID。少任何一个都会在请求阶段报错。改完配置执行openclaw restart生效。4. 验证请求与成功结果确认4.1 启动服务openclaw start成功时终端会输出类似 Lobster engine running Model channel connected Web console: http://localhost:187894.2 命令行健康检查openclaw doctor所有项目显示 才算正常。如果模型通道那项是 说明 Base URL 或 Key 有问题回到第 3 节检查配置。4.3 发一条真实请求打开浏览器访问http://localhost:18789输入初始化时生成的 Token 登录。在聊天框输入帮我列出当前目录下的所有文件并统计数量如果模型通道正常几秒内会返回文件列表和数量。这一步能跑通说明 OpenClaw 到 TaoToken 的链路完全打通。4.4 用 curl 单独验证通道想排除 OpenClaw 本身的干扰可以直接测 APIcurl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: ping}] }返回带choices字段的 JSON 就说明 Key 和 Base URL 都没问题。这一步是我排障时最常用的手段能快速定位是 OpenClaw 配置问题还是通道问题。5. 常见报错排查与真实错误对照5.1 401 Unauthorized最常见。原因通常是 Key 填错、有多余空格、或者 Key 已过期。检查config.json里的apiKey字段确认没有换行和空格。如果用的是环境变量确认容器里echo $OPENCLAW_API_KEY能打印出正确值。5.2 local proxy failed这个报错说明 OpenClaw 尝试走本地代理但连不上。检查两点一是apiBase是否写成了https://taotoken.net/api不要带多余路径二是系统环境变量里有没有残留的HTTP_PROXY。有的话先unset HTTP_PROXY HTTPS_PROXY再重启服务。5.3 reading choices 报错通常是模型返回格式不匹配。检查 Model ID 是否拼写正确比如claude-3-5-sonnet不能写成claude3.5。另外确认你的 TaoToken 套餐里包含这个模型不包含的话会返回空 choices。5.4 OAuth 相关报错如果你在配置里误开了 OAuth 模式会提示OAuth token missing。OpenClaw 接 TaoToken 用的是 API Key 模式不需要 OAuth。把配置里的authType改成apiKey即可。5.5 端口占用18789被占用时服务起不来。用lsof -i:18789查占用进程或者改config.json里的port字段换一个端口记得防火墙同步放行。5.6 Docker 容器内无法访问外网容器里curl https://taotoken.net/api超时的话检查 Docker 的 DNS 配置。在docker-compose.yml里加dns: 8.8.8.8通常能解决。6. 接入后的下一步与长期使用建议跑通之后你可以按需开启更多技能。文件管理和网页搜索建议必开终端执行谨慎授权。如果想让 OpenClaw 长期在后台跑Docker 方案加restart: unless-stopped最省心。模型通道这块TaoToken 的好处是一个 Key 能切换多个模型不用为每个服务商单独配 Key。你可以在 TaoToken 控制台 里管理密钥和查看用量需要新 Key 就去 API Keys 页面 生成。接入文档在 这里遇到通道问题可以先对照文档排查。如果你打算长期跑编码类 Agent 任务Coding Plan 比按量计费更划算。想先试试模型对话效果可以直接去 模型对话 页面发几条指令感受一下。最后提醒一句OpenClaw 的终端执行技能权限很大别在存有敏感数据的机器上随便开。我一般只在测试目录里跑确认任务逻辑没问题再放到正式环境。