1. Ubuntu 22.04 上 OpenClaw 到底能做什么适合谁OpenClaw 是一个跑在本机的 AI Agent 操作层你可以把它理解成「给大模型装上手和脚」它自己带 Gateway 网关、Agent 调度、Skills 技能库和 Memory 记忆系统能读写文件、执行 shell、抓网页、连飞书/Telegram 这类频道。装好之后你在浏览器或聊天窗口里说一句话它就能真的去动你的机器而不是只回你一段文字。这篇面向的是在 Ubuntu 22.04 上从零部署 OpenClaw、并且想用统一 API 通道接大模型的人。典型场景有三种一是在 VMware/云主机里跑一个长期在线的 Agent用 SSH 隧道把 Web 控制台映射到本地二是想把手头的模型调用收敛到一个入口不想每个工具都单独配 Key三是想拿它当自动化脚本的调度器定时跑任务、整理文件、抓数据。我实测下来Ubuntu 22.04 的坑主要集中在三块Node 版本必须 22 以上、npm 全局安装的镜像源、以及 Gateway 默认只监听 127.0.0.1 导致远程访问连不上。把这三块理顺剩下的就是配置文件的活。下面按「系统依赖 → 装 OpenClaw → 接 TaoToken → 验证 → 排障」的顺序走命令都能直接复制。先说清楚 OpenClaw 的架构不然后面配参数会懵。它的核心是 Gateway默认跑在ws://127.0.0.1:18789所有频道消息、Agent 实例、权限控制都从这里过。Agent 是真正干活的智能体它调用 Skills技能Skills 再组合底层 Tools文件、执行、网络、记忆。Workspace 提供项目级隔离Memory 做持久化ClawHub 是技能市场。你接大模型本质是给 Agent 配一个 provider让它推理时有模型可用。所以「接入 TaoToken」这件事在 OpenClaw 里就是配一个 OpenAI 兼容的 provider把 baseUrl 指向 TaoToken 的 API 地址填上 Key再指定模型 ID。TaoToken 的 API 入口是https://taotoken.net/api它兼容 OpenAI 的 completions 协议所以 OpenClaw 里api字段写openai-completions就能通。官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册和拿 Key 都在那边。适合谁有 Linux 基础、能敲命令、想自己掌控 Agent 运行环境的人。如果你只是想网页上聊两句那不用装这个但如果你要的是「一句话让机器去干活」OpenClaw 这套结构是对的方向。下面开始动手。2. 装 OpenClaw 前的系统依赖与 Node 22 环境准备Ubuntu 22.04 默认的 Node 版本太老OpenClaw 要求 22 以上所以第一步不是装 OpenClaw而是把 Node 环境弄对。我建议用 nvm 管理别用 apt 的 nodejs否则后面升级会打架。先更新系统并装基础工具sudo apt update sudo apt install -y curl git build-essentialbuild-essential别省有些 npm 包要编译原生模块缺了会报gyp ERR。然后装 nvmcurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash装完要让当前 shell 加载 nvm执行export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh想让它每次登录自动生效把上面两行加到~/.bashrc末尾。接着装 Node 22nvm install 22 nvm use 22 nvm alias default 22验证一下node -v npm -v正常会输出v22.x.x和对应的 npm 版本。如果node -v还是老版本说明 nvm 没加载重开一个终端或者手动 source 一次。这里有个细节npm 全局安装默认走官方源国内拉包会慢甚至超时。OpenClaw 安装时可以直接指定镜像npm install -g openclawlatest --registryhttps://registry.npmmirror.com装完确认版本openclaw --version我这边实测输出是OpenClaw 2026.3.13你的版本号可能更新只要不是报 command not found 就行。如果提示找不到命令检查npm config get prefix是否在 PATH 里nvm 环境下一般没问题。再补一个远程访问要用的依赖。如果你打算从 Windows 用远程桌面连进来装 xrdp 和 XFCEsudo apt install -y xfce4 xfce4-goodies xrdp sudo adduser xrdp ssl-cert echo xfce4-session ~/.xsession sudo systemctl enable --now xrdp防火墙放行 3389sudo ufw allow 3389 sudo ufw reload如果你只用 SSH 隧道访问 Web 控制台xrdp 可以跳过SSH 就够。SSH 服务确认开着sudo systemctl enable --now ssh到这一步系统依赖和 Node 环境就齐了。下一步初始化 OpenClaw 并配 TaoToken。3. 配置 OpenClaw 接入 TaoToken 的完整 settings 片段OpenClaw 装好后先跑一次初始化向导openclaw onboard --install-daemon--install-daemon会把它注册成 systemd 服务开机自启。向导里会问一些基础项模型和 Key 可以先跳过我们后面用命令直接写配置更可控。OpenClaw 的配置可以用openclaw config set逐项写也可以直接改配置文件。配置文件一般在~/.openclaw/下具体路径用openclaw config path查。我习惯用命令写避免手改格式出错。先配 TaoToken 这个 provider。注意baseUrl用 API 地址https://taotoken.net/apiapi字段写openai-completions模型 ID 按你在 TaoToken 控制台看到的填openclaw config set models.providers.taotoken --json { baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_API_Key, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5 } ] }这段 JSON 里三个关键字段必须对齐baseUrl是 TaoToken 的 API 根地址apiKey是你从控制台生成的 Keyapi协议类型。模型 ID 要和你实际能调用的模型一致写错了会在请求时报model not found。然后把模型模式设成 merge并激活默认模型openclaw config set models.mode merge openclaw models set taotoken/claude-sonnet-4-5models.mode merge的意思是保留内置模型定义把你新加的 provider 合并进去不会覆盖掉原有配置。如果你只想用 TaoToken也可以设成 replace但 merge 更安全。配完重启 Gateway 让配置生效openclaw gateway restart如果你更想直接编辑配置文件OpenClaw 的配置是 JSON 结构大致长这样路径以openclaw config path输出为准{ models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_API_Key, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: Claude Sonnet 4.5 } ] } } } }改完文件同样要openclaw gateway restart。这里提醒一句Key 是敏感信息别提交到 git也别贴到公开的地方。TaoToken 的 Key 在控制台的 API Keys 页面生成地址是https://taotoken.net/console/api-keys。配好 provider 后OpenClaw 的 Agent 在推理时就会走 TaoToken 这个通道。如果你还要接飞书这类频道那是另一层配置和模型 provider 不冲突。频道配置示例openclaw config set channels.feishu.enabled true openclaw config set channels.feishu.appId cli_你的AppID openclaw config set channels.feishu.appSecret 你的AppSecret openclaw config set channels.feishu.domain feishu openclaw gateway restart模型通道和频道是两条线先把模型通道跑通再考虑频道。4. 验证请求从 gateway status 到实际对话成功配置写完不能只看「没报错」要真的发一次请求确认链路通。验证分三层Gateway 进程状态、provider 配置读取、实际模型调用。先看 Gateway 状态openclaw gateway status正常会显示守护进程在跑、监听端口 18789。如果显示 stopped用openclaw gateway start起来。再看整体状态openclaw status这个命令会列出 Agent、Gateway、会话、内存的概览。重点看模型 provider 那一栏有没有识别到 taotoken。接着做连通性探测openclaw gateway probe它会尝试连 Gateway 的监听端口返回连通性结果。如果这里就失败说明 Gateway 没起来或者端口被占先解决这个再往下。然后验证模型配置是否被正确读取openclaw models list你应该能在列表里看到taotoken/claude-sonnet-4-5这一项。如果看不到说明 provider 的 JSON 写错了或者models.mode没设对回去检查。最关键的验证是实际发一次对话。OpenClaw 有 Web 控制台先生成访问 URLopenclaw dashboard它会输出一个带 Token 的 URL形如http://127.0.0.1:18789/...。因为 Gateway 默认只监听本地你在远程机器上访问不了需要做 SSH 隧道。在本地 Windows 的 cmd 里执行ssh -N -L 18789:127.0.0.1:18789 你的用户名你的服务器IP想让它后台跑加-fNssh -fN -L 18789:127.0.0.1:18789 你的用户名你的服务器IP隧道建好后本地浏览器打开openclaw dashboard输出的那个 URL就能进控制台。在对话框里发一句「你好报一下你用的模型」如果返回正常内容说明 TaoToken 通道打通了。如果控制台里发消息报错先看日志openclaw logs --follow日志里会明确写出是 401、连接超时还是模型不存在。这一步是排障的核心别跳过。还有一种验证方式是用openclaw doctoropenclaw doctor它会检查系统环境、配置完整性、潜在问题并给修复建议。加--fix能自动修一部分openclaw doctor --fix我建议每次改完配置都跑一次 doctor比人肉排查快。到这一步如果控制台能正常对话整个接入就算完成了。5. 本篇常见报错排查401、local proxy failed、reading choices接入过程里最容易卡住的就那几个报错我按实际遇到的频率排一下每个都给定位方法。401 Unauthorized。这个基本是 Key 的问题。先确认apiKey字段填的是 TaoToken 控制台生成的 Key没有多余空格没有把Bearer前缀写进去OpenClaw 会自己加。然后确认 Key 没过期、没被删。用 curl 直接打一次 TaoToken 的接口验证 Key 本身可用curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-5,messages:[{role:user,content:hi}]}如果 curl 也 401那就是 Key 本身的问题去控制台重新生成。如果 curl 通、OpenClaw 不通那是配置里 Key 写错了重新openclaw config set一遍。local proxy failed / connection refused。这个通常是 Gateway 没起来或者 SSH 隧道断了。先openclaw gateway status确认进程在跑再确认隧道命令还在。SSH 隧道长时间不用会断重新执行ssh -fN -L ...即可。还有一种情况是端口被占用ss -tlnp | grep 18789看谁占着杀掉或换端口。reading choices / cannot read property choices。这个报错说明请求发出去了但返回结构不是预期的 OpenAI 格式。常见原因是api字段写错比如写成了anthropic或openai-responses。TaoToken 走的是 OpenAI 兼容的 completions 协议所以必须写openai-completions。改完重启 Gatewayopenclaw config set models.providers.taotoken.api openai-completions openclaw gateway restartmodel not found。模型 ID 和 TaoToken 那边实际可用的对不上。去控制台看模型列表把id改成完全一致的字符串。注意大小写和斜杠claude-sonnet-4-5和claude-sonnet-4.5是两回事。OAuth / token expired。如果你用的是需要 OAuth 的通道token 过期会报这个。重新走一遍授权流程或者换成 API Key 方式。OpenClaw 的 provider 用 API Key 最省事不涉及 OAuth 刷新。npm 安装卡住或 ETIMEDOUT。加镜像源重装npm install -g openclawlatest --registryhttps://registry.npmmirror.comnode 版本不对报 engine 错误。确认node -v是 22 以上nvm use 22切过去再重装 OpenClaw。排查的通用思路是先看openclaw logs --follow的实时输出报错信息里通常直接写了原因再用openclaw doctor做体检最后用 curl 单独验证 TaoToken 接口把「Key 问题」和「OpenClaw 配置问题」分开。这三步走完九成的报错都能定位。6. 长期跑 Agent 的配置建议与 TaoToken 通道选择如果你只是试一下上面配完就够了。但如果你打算让 OpenClaw 长期在线跑任务有几个点值得提前设好。第一是超时。Agent 执行复杂任务时单步推理可能超过默认超时导致中途断掉。把默认超时调大openclaw config set agents.defaults.timeoutSeconds 300300 秒对大多数任务够用特别重的可以再往上加。第二是守护进程。openclaw onboard --install-daemon已经装了 systemd 服务确认一下开机自启openclaw daemon install systemctl status openclaw这样服务器重启后 Agent 会自动起来不用手动拉。第三是安全审计。OpenClaw 能执行 shell、读写文件权限不小定期跑一次审计openclaw security audit --deep它会检查配置里有没有危险项比如频道策略开得太松、Key 明文暴露等。群聊场景建议把requireMention设成 true避免机器人被随便触发。第四是技能管理。别一次性装太多 Skills按需装。新手可以先装几个基础的建立信心clawhub install weather clawhub install find-skills clawhub install summarize装之前可以用clawhub search 关键词找装之前跑skill-vetter审一下更稳。关于 TaoToken 通道的选择如果你只是偶尔验证模型效果用模型对话页面直接试就行地址是https://taotoken.net/models。如果你要长期跑编码类 Agent、需要稳定的调用配额和统一计费那用 Coding Plan 更合适入口在https://taotoken.net/coding-plan。接入文档在https://taotoken.net/doc里面有各语言的调用示例配 OpenClaw 时对照着看协议字段。最后说个实际经验OpenClaw 的配置改完一定要openclaw gateway restart很多人改完不重启然后纳闷为什么没生效。另外 SSH 隧道建议写成脚本或者用 autossh不然断线后控制台打不开会以为是 OpenClaw 挂了。把这两点记住长期跑起来会省很多事。