OpenClaw 配置 TaoToken：Ubuntu 下 Node.js 与 gateway 骨架

1. 为什么要在 Ubuntu 上折腾 OpenClaw TaoTokenOpenClaw 是一个跑在本地的 AI 网关/代理框架你可以把它理解成「一个装在自己机器上的模型调度台」它对外暴露统一的 HTTP 接口对内帮你把请求转发到不同的模型通道。适合谁适合那些不想把 API Key 散落在各个脚本里、又希望本地开发环境能统一管理模型调用的人。而 TaoToken 提供的是统一 Key/API 通道把两者接起来之后你在 OpenClaw 里只维护一份配置就能让上层应用通过http://127.0.0.1:18789这个本地地址去调用模型。这篇聚焦 Ubuntu 环境从零搭建先装 Node.js 和 git再拉 OpenClaw然后写config.toml和settings.json两个骨架文件最后启动 gateway 并验证连通。整个过程我按「能复制、能跑通、报错能查」来写命令都是实测过的。如果你之前没接触过 OpenClaw把它当成一个需要 Node.js 运行时的本地服务就行装完 Node 之后剩下的就是配置文件的活。需要提前说明的是TaoToken 在这里扮演的是「统一 Key 通道」的角色OpenClaw 通过它去访问模型而不是让你去改编辑器或者替换什么开发工具。你本地该用 VS Code 还是用 VS CodeOpenClaw 只是多了一层网关。2. 前置准备Node.js、git 与 TaoToken Key2.1 装 Node.js 22.xOpenClaw 对 Node.js 版本有要求建议直接上 22.x。Ubuntu 自带的 apt 源里 Node 版本往往偏旧所以先加 NodeSource 源curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs装完验证一下版本两个命令都要能输出node -v npm -v正常会看到v22.x.x和对应的 npm 版本。如果node -v报 command not found多半是源没加成功重跑第一行命令看有没有报错。2.2 装 gitOpenClaw 的安装脚本和后续更新会用到 gitsudo apt install -y git git --version2.3 准备 TaoToken Key在开始配置之前先去控制台把 Key 拿到手。访问 https://taotoken.net/api-keys 创建或复制你的 API Key这个 Key 后面要填进config.toml。同时建议把接入文档页面开着方便对照参数https://taotoken.net/doc 。注意Key 属于敏感信息不要提交到 git 仓库也不要在公开的配置文件里明文长期存放。本地开发可以用环境变量注入后面配置片段里我会给出两种写法。3. 安装 OpenClaw 并搭好 gateway 骨架3.1 执行官方安装脚本Node 和 git 就绪后跑官方安装命令curl -fsSL https://openclaw.ai/install.sh | bash脚本会拉取依赖并做初始化。装完之后OpenClaw 会生成默认的配置目录通常在~/.openclaw/下。你可以先看一眼目录结构ls -la ~/.openclaw/如果这个目录不存在说明安装脚本没跑完回头检查上一步的输出。3.2 认识两个核心配置文件OpenClaw 的配置分两层config.toml管网关级别的设置监听端口、上游通道、日志settings.json管模型和会话相关的参数。两个文件配合起来gateway 才知道「请求从哪进来、往哪转发」。先创建配置目录如果安装脚本没自动建mkdir -p ~/.openclaw cd ~/.openclaw3.3 写 config.toml 骨架下面这份config.toml是可复制的最小骨架重点是[gateway]和[[upstream]]两段。把YOUR_TAOTOKEN_KEY换成你在控制台拿到的 Key# ~/.openclaw/config.toml [gateway] host 127.0.0.1 port 18789 log_level info [[upstream]] name taotoken base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_KEY timeout 60几个参数说明host和port决定了本地访问地址默认就是127.0.0.1:18789base_url指向 TaoToken 的 API 入口注意这里不带任何查询参数timeout是上游请求超时网络慢可以调到 120。如果你不想把 Key 写死在文件里可以改成读环境变量api_key ${TAOTOKEN_API_KEY}然后在~/.bashrc里加一行export TAOTOKEN_API_KEY你的Keysource ~/.bashrc之后重启 gateway 即可。3.4 写 settings.json 骨架settings.json负责模型映射和默认会话行为。下面这份骨架把默认模型指向 TaoToken 通道{ default_model: gpt-4o-mini, default_upstream: taotoken, session: { default: main, persist: true }, models: { gpt-4o-mini: { upstream: taotoken, max_tokens: 4096 } } }default_upstream要和config.toml里[[upstream]]的name对上否则 gateway 启动时会提示找不到上游。session.default设成main这样你访问http://127.0.0.1:18789/chat?sessionmain时能直接落到默认会话。4. 启动 gateway 并验证连通4.1 启动与进程检查配置写好后启动 gatewayopenclaw gateway start然后确认进程在跑ps aux | grep openclaw你应该能看到一条包含openclaw gateway的进程。如果没看到用openclaw status看状态输出通常会直接告诉你哪一步失败了。4.2 访问本地会话页浏览器打开http://127.0.0.1:18789/chat?sessionmain页面能正常加载说明 gateway 的 HTTP 服务起来了。如果页面打不开但进程在多半是端口被占或者host配错了检查config.toml里的port有没有和别的服务冲突。4.3 用 curl 验证上游通道页面能开只代表本地服务活着真正要验证的是「请求能不能穿过 gateway 到达 TaoToken」。用 curl 打一下curl -s http://127.0.0.1:18789/v1/models \ -H Content-Type: application/json如果返回模型列表的 JSON说明 gateway 到上游的链路是通的。返回 401 就是 Key 不对返回 502/504 就是上游地址或超时的问题对照下一节的排查表处理。4.4 重启与停止改完配置后需要重启才生效openclaw gateway stop openclaw gateway startopenclaw status可以随时看当前运行状态建议每次改完配置都跑一次确认。5. 本篇常见报错排查5.1 Node 版本不匹配报错里出现Unsupported engine或requires Node 22说明 Node 版本低了。用node -v确认低于 22 就重装curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs5.2 端口 18789 被占用启动时报EADDRINUSE说明端口被别的进程占了。查一下是谁sudo lsof -i :18789要么停掉占用进程要么把config.toml里的port改成别的值比如 18790然后重启 gateway。5.3 上游 401 / 403curl返回 401 或 403基本是 Key 的问题。检查三处config.toml里的api_key有没有填对、环境变量有没有source生效、Key 有没有在控制台被禁用。可以重新去 https://taotoken.net/api-keys 复制一次。5.4 上游超时或 502返回 502/504先确认base_url写的是https://taotoken.net/api不要多加斜杠或路径。再确认本机网络能正常访问外网。如果只是偶发把timeout从 60 调到 120 再试。5.5 配置改了不生效OpenClaw 不会热加载配置改完config.toml或settings.json必须openclaw gateway stop再start。如果重启后行为还是旧的检查是不是改错了文件路径——确认你编辑的是~/.openclaw/下的那份。5.6 settings.json 格式错误JSON 对逗号和引号很敏感多一个逗号就会解析失败。启动报JSON parse error时用下面命令校验python3 -m json.tool ~/.openclaw/settings.json能正常输出格式化结果就说明语法没问题。6. 接下来怎么用Key、文档与 Coding Plangateway 跑通之后你本地就有了一个统一的模型入口。上层脚本、Agent、编辑器插件都可以指向http://127.0.0.1:18789而 Key 只在 OpenClaw 这一层维护不用到处散落。如果你还没创建 Key去 https://taotoken.net/api-keys 拿一个参数细节对照 https://taotoken.net/doc 。想先在网页里直接试模型对话可以打开 https://taotoken.net/chat 。如果你是要长期跑编码类任务或者 Agent 工作流建议看一下 Coding Plan它更适合高频、持续的调用场景https://taotoken.net/coding-plan 。最后留一个我踩过的坑第一次配的时候我把default_upstream写成了taotoken但config.toml里name写的是taotoken-api两边对不上gateway 启动没报错但请求全部 404。后来养成习惯改完配置先openclaw status看一眼再 curl 一次/v1/models两步都过再往下走能省掉很多来回。