1. 为什么要在本地跑 OpenClaw以及它到底解决什么问题OpenClaw 是一个自托管的 AI 网关说白了就是你自己电脑或服务器上跑的一个“中转站”。它把企业微信、飞书、钉钉、QQ、Telegram、Discord 这些聊天平台和你常用的 AI 模型DeepSeek、通义千问、Claude、ChatGPT 等连在一起所有聊天记录、配置、密钥都留在你自己的机器上不经过第三方托管。适合谁适合想把 AI 助手接进日常聊天工具、又不想把数据交给别人、还愿意花半小时折腾一下的开发者或技术爱好者。我试过把它跑在一台 2 核 4G 的轻量服务器上同时接了飞书和 Telegram日常用下来响应稳定内存占用在 300MB 左右。它的核心能力包括多平台同时接入、原生工具调用网页搜索、文件操作、代码执行、定时任务、记忆系统、Web 控制面板、插件扩展。架构上分四层聊天平台 → OpenClaw 网关 → AI 模型 → 本地工具Web 面板负责管理。这篇教程聚焦本地部署全流程Node.js 环境准备、Docker 镜像拉取与容器启动、配置文件骨架编写以及通过 TaoToken 统一 API 通道完成 AI 网关接入。目标很明确——30 分钟内跑通 OpenClaw 并确认 API 连通性。下面每一步都有可复制的命令和配置片段你跟着敲就行。2. 环境准备与 TaoToken 统一 API 通道前置配置在装 OpenClaw 之前先把两件事搞定Node.js 运行时和 AI 模型的 API 通道。OpenClaw 本身是个 Node.js 应用官方要求 Node.js 22建议用 nvm 管理版本避免和系统自带的旧版本冲突。AI 通道这边我推荐用 TaoToken 的统一 API 通道原因是它把多个模型的调用收敛到一个 Base URL 和一把 Key 上后面在 OpenClaw 配置文件里只需要填一次换模型时改 Model ID 就行不用来回改地址和密钥。先装 nvm 和 Node.js 22curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 node -vnode -v输出v22.x.x就说明环境对了。接着装 pnpmOpenClaw 的依赖用 pnpm 装更快npm install -g pnpm pnpm -v然后去 TaoToken 控制台拿 Key。打开 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 登录后创建一个 API Key复制保存。这个 Key 后面要填进 OpenClaw 的配置文件。TaoToken 的 API 入口是 https://taotoken.net/api 注意这个地址不带任何查询参数配置时直接写这个。这里有个关键点OpenClaw 的模型配置走的是 OpenAI 兼容接口所以 Base URL 填https://taotoken.net/apiModel ID 填你在 TaoToken 上开通的模型名比如deepseek-chat或claude-3-5-sonnet。三件套Base URL Key Model ID缺一不可后面配置文件里会体现。如果你还没决定用哪个模型可以先在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 看一眼可用列表选一个再往下走。3. 可复制的安装配置Node.js 直装与 Docker 两种方式OpenClaw 提供两种安装方式npm 全局安装和 Docker 容器。前者适合本机调试后者适合服务器长期运行。两种我都跑过下面分别给完整命令和配置文件。3.1 Node.js 直装方式npm install -g openclawlatest openclaw --version装完后初始化配置openclaw setup这个命令会引导你生成~/.openclaw/openclaw.json骨架。生成后手动编辑这个文件填入 TaoToken 的通道信息。配置文件路径固定是~/.openclaw/openclaw.json不要改到安装目录下否则升级会丢。一个最小可用的配置骨架如下{ agents: { default: { model: deepseek-chat, apiKey: 你的TaoToken Key, baseURL: https://taotoken.net/api, temperature: 0.7, maxTokens: 4096 } }, gateway: { port: 18789 } }把apiKey换成你在 TaoToken 控制台复制的那串model换成你开通的 Model ID。保存后启动网关openclaw gateway --port 18789前台启动方便看日志确认没问题后再装成系统服务openclaw gateway install openclaw gateway status3.2 Docker 方式Docker 方式更适合服务器一条命令拉起数据目录挂载到宿主机升级时直接换镜像。docker pull openclaw/openclaw:latest mkdir -p ~/.openclaw docker run -d \ --name openclaw \ --restart always \ -p 18789:18789 \ -v ~/.openclaw:/root/.openclaw \ openclaw/openclaw:latest容器启动后配置文件同样在宿主机的~/.openclaw/openclaw.json编辑方式和上面一致。改完配置重启容器docker restart openclaw如果你用的是 Docker Compose可以写一个docker-compose.ymlversion: 3.8 services: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: always ports: - 18789:18789 volumes: - ~/.openclaw:/root/.openclaw然后docker compose up -d即可。两种方式选一种就行不要同时跑否则端口 18789 会冲突。4. 验证请求与成功结果确认 API 连通性配置写完后最关键的一步是验证 OpenClaw 能不能通过 TaoToken 通道拿到模型回复。分三层验证网关状态、健康检查、实际对话请求。先看网关状态openclaw gateway status正常输出会显示running和监听端口18789。如果显示stopped用openclaw logs --follow看日志。接着做健康检查openclaw health这个命令会检查网关、配置文件和模型通道。如果 TaoToken 的 Key 或 Base URL 填错这里会报model channel unreachable。最直接的验证是发一条测试消息。打开浏览器访问http://你的服务器IP:18789/进入 Web 控制面板在会话窗口里发一句“你好测试一下”。如果配置正确几秒内会收到模型回复。实测下来从发送到收到首字大约 1-2 秒取决于模型和网络。也可以用命令行直接测curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer 你的TaoToken Key \ -H Content-Type: application/json \ -d { model: deepseek-chat, messages: [{role: user, content: ping}] }返回 JSON 里choices[0].message.content有内容就说明 TaoToken 通道本身是通的。如果这一步通、OpenClaw 里不通问题就在 OpenClaw 配置不在通道。成功的结果长这样Web 面板会话列表出现新对话消息气泡显示模型回复统计面板里 Token 消耗数字开始累加。到这一步OpenClaw 就算跑通了。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth部署过程中最容易卡在几个报错上我按实际遇到的频率排一下。401 Unauthorized最常见。原因通常是apiKey填错、Key 前后有空格、或者 Key 已失效。检查~/.openclaw/openclaw.json里的apiKey字段确认和 TaoToken 控制台里复制的一致。注意不要手动加Bearer前缀OpenClaw 会自己加。local proxy failed / connection refused网关没起来或者端口被占用。先openclaw gateway status确认状态再lsof -i:18789看端口。如果是 Dockerdocker ps看容器是否在运行docker logs openclaw看启动日志。reading choices 报错这个通常出现在模型返回格式不对时比如 Base URL 填成了不带/api的地址或者 Model ID 写错。确认baseURL是https://taotoken.net/apimodel是 TaoToken 上真实存在的 ID。如果返回体里没有choices字段多半是通道地址错了。OAuth 相关报错如果你在接飞书、钉钉这类平台时看到 OAuth 错误检查应用的 App ID、App Secret、回调地址是否和 OpenClaw 配置一致。回调地址格式是http://你的服务器IP:端口/平台/events端口要和配置文件里的webhookPort对上。排查顺序建议先openclaw logs --follow看实时日志再对照配置文件逐项检查三件套Base URL Key Model ID最后用 curl 单独测 TaoToken 通道。这样能快速定位是通道问题还是 OpenClaw 配置问题。6. 接入后的下一步模型对话、Coding Plan 与文档跑通之后你可以直接在 Web 面板里和模型对话也可以把 OpenClaw 接到飞书、企业微信这些平台上日常用。如果只是想先体验模型效果打开 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 就能直接对话不用装任何东西。如果你打算长期用 OpenClaw 做编码助手或 Agent 任务建议看一下 Coding Plan它针对高频调用场景做了额度优化https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。配置细节和平台接入的完整说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。最后提醒一句OpenClaw 迭代很快定期跑npm update -g openclaw或docker pull openclaw/openclaw:latest更新能拿到最新的平台适配和安全修复。配置文件记得备份升级前先复制一份~/.openclaw/openclaw.json出问题能快速回滚。