1. Ubuntu 22.04 上 Openlaw 是什么、能做什么、适合谁Openlaw 这个名字在社区里经常和 OpenClaw 混着叫本质上它是一套跑在本地或服务器上的 AI Agent 运行框架你可以把它理解成一个「能自己动手干活的命令行助手」它不只是聊天还能读写文件、执行 shell、调用外部模型接口把一整条任务链跑完。Ubuntu 22.04 是目前最稳的长期支持版本之一Node.js 生态在这上面跑得最顺所以很多人第一次「养」Openlaw 都选它。这篇面向的是完全没接触过的新手你手上有一台干净的 Ubuntu 22.04物理机、云主机、WSL 都行想从零把 Node.js、npm 装好把 Openlaw 拉起来最后把模型调用通道切到 TaoToken 的统一 Key/API 上。全程给可复制的命令、目录结构和配置片段最后用一次真实请求验证它能正常返回结果。先说清楚它适合谁想在自己机器上跑一个能执行任务的 Agent、又不想被单一模型厂商绑死的人需要把模型 endpoint 统一管理、方便换模型的人以及想学 Agent 框架怎么配置的开发者。不适合的是只想开个网页聊天的人那种直接用网页版就行没必要折腾环境。整个链路分四段系统准备 → Node.js/npm 环境 → Openlaw 安装与初始化 → 模型通道切到 TaoToken 并验证。我会按这个顺序走每一步都给校验方法避免你装完了不知道成没成。有一点先提醒Ubuntu 22.04 自带的 apt 源里 Node.js 版本偏旧直接apt install nodejs很可能给你一个 12.x 或更老的版本Openlaw 这类新框架基本要求 Node 18 以上所以下面会用 NodeSource 源装 22.x。这是新手最容易踩的第一个坑。2. TaoToken 前置准备统一 Key 与 API 通道怎么拿在装 Openlaw 之前先把模型通道准备好这样后面配置一次到位不用来回改。TaoToken 的作用是把模型调用收敛到一个统一的 Base URL 和一把 Key 上你换模型时只改 Model ID不用动接入代码。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不带 UTM配置里就填它。拿 Key 的路径进控制台 → API Keys 页面创建一把新 Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API Keys 页面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建完复制出来形如sk-xxxxxxxx只显示一次丢了就重建。这里要区分三个东西新手经常搞混名称值用在哪Base URLhttps://taotoken.net/api所有请求的前缀API Keysk-...请求头 AuthorizationModel ID如claude-sonnet-4-5等请求体里的 model 字段Openlaw 这类框架底层大多走 OpenAI 兼容协议所以配置时通常填的是base_urlapi_keymodel三件套。TaoToken 的接口是 OpenAI 兼容格式/v1/chat/completions这类路径直接能用所以只要把 base_url 指过去就行。如果你后面要长期跑编码类 Agent 任务可以看下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它针对高频编码场景做了额度安排。想先验证模型通不通用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 直接发一条消息最快。接入细节和字段说明在文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里。注意Key 不要写进会提交到 git 的文件里。下面配置我会用环境变量或本地配置文件的方式避免泄露。准备好这三样后面 Openlaw 的配置就是填空。我实测下来先把 Key 拿到手再装环境比装完再回头找 Key 顺很多因为安装向导里会直接问你要。3. 可复制配置Node.js 环境 Openlaw 安装 TaoToken 接入这一节是核心全部命令可以直接复制。先更新系统并装基础工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git build-essentialbuild-essential别省有些 npm 原生模块编译要用到 gcc/make缺了会在npm install阶段报 node-gyp 错误。装 Node.js 22.x用 NodeSource 源curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs校验版本两个都要看node -v # 期望 v22.x.x npm -v # 期望 10.x 以上如果node -v还是旧版本说明系统里之前装过 nodejs先sudo apt remove nodejs -y再重跑上面的安装。npm 版本太低就sudo npm install -g npmlatest。接着全局装 Openlaw CLIsudo npm install -g openclawlatest which openclaw # 期望输出 /usr/bin/openclawwhich有输出说明 PATH 没问题。如果提示 command not found检查/usr/bin是否在 PATH 里或者用npm config get prefix看全局目录。然后跑初始化向导openclaw onboard向导会依次问是否了解网络风险选 yes、启动模式默认 QuickStart 直接回车、模型提供方。这里关键一步——不要选内置的厂商直连选自定义/OpenAI 兼容然后填 TaoToken 的三件套。如果向导里没有自定义选项就先随便选一个走完再手动改配置文件。配置文件一般在~/.openclaw/config.json不同版本路径可能略有差异用openclaw config path可以查。手动写入的内容长这样{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-5, temperature: 0.7 }如果你用的是带 TOML 的版本等价写法[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key model claude-sonnet-4-5 temperature 0.7更稳妥的做法是用环境变量避免 Key 落盘到明文配置export TAOTOKEN_API_KEYsk-你的Key export OPENAI_BASE_URLhttps://taotoken.net/api写进~/.bashrc后source ~/.bashrc生效。Openlaw 启动时会优先读环境变量。目录结构大致是这样方便你排查~/.openclaw/ ├── config.json # 主配置 ├── sessions/ # 会话记录 ├── logs/ # 运行日志 └── workspace/ # Agent 工作目录配置改完启动控制台openclaw dashboard它会起一个本地服务并打开浏览器界面在里面能看到状态、进聊天/Agent。如果端口被占用openclaw dashboard --port 8080换端口。4. 验证请求确认 Openlaw 能正常返回结果配置写完不算完得真发一次请求看它通不通。最直接的方式是先用 curl 打 TaoToken 的接口确认 Key 和 Base URL 没问题再让 Openlaw 走一遍。先测通道curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 只回复两个字通了}] }正常返回是一段 JSONchoices[0].message.content里就是模型输出。看到内容说明 Key、Base URL、Model ID 三件套都对。然后回到 Openlaw在 dashboard 里发一条消息或者用 CLI 直接跑openclaw run 用一句话说明你现在用的是哪个模型通道如果返回正常说明 Openlaw 已经成功把请求转发到 TaoToken。我实测下来这一步最容易出问题的地方是 Model ID 写错——比如写了个 TaoToken 不支持的模型名接口会返回 404 或 model not found而不是报 Key 错容易误判。再验证一下 Agent 能力让它执行个简单任务openclaw run 在当前目录创建一个 hello.txt内容写 ok跑完cat hello.txt看有没有内容。这一步能通说明不只是聊天工具调用链也正常。成功的结果长这样dashboard 状态显示 connected日志里能看到请求耗时和 token 用量~/.openclaw/logs/下有对应记录。如果日志里出现reading choices相关报错往下看第 5 节。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth新手在这一套流程里翻车基本集中在几个固定报错我按出现频率排一下。401 UnauthorizedKey 错了或没带上。检查echo $TAOTOKEN_API_KEY有没有值配置里api_key是不是复制时多了空格。TaoToken 的 Key 是sk-开头别把控制台里别的 ID 当 Key 填。还有一种情况是环境变量没source新开终端就丢了。local proxy failed / connection refusedOpenlaw 起本地代理但连不上上游。先确认base_url是https://taotoken.net/api别写成带/v1的完整路径又和框架自己拼的路径重复变成/v1/v1/chat/completions。再确认机器能出网curl -I https://taotoken.net/api看有没有响应。公司内网有出口限制的话这种请求会被拦。reading choices 报错一般是返回体结构不符合预期常见原因是 Model ID 不存在接口返回了错误 JSON框架去读choices就读不到。解决方法是先用第 4 节的 curl 单独测这个 Model ID确认能返回正常结构再回框架里用。也可能是 base_url 少了/api这一段。OAuth 相关报错有些版本向导默认走 OAuth 登录某厂商你选了自定义通道但残留了 OAuth 配置。检查配置文件里有没有oauth字段删掉确保provider是openai-compatible。如果用的是 Codex 类工具~/.codex/auth.json里也要确认没混入旧凭证。对照表方便你快速定位报错大概率原因处理401Key 错/没带重设环境变量检查空格local proxy failedbase_url 错/网络不通改成https://taotoken.net/api测出网reading choicesModel ID 不存在curl 单测模型名OAuth残留旧认证配置删 oauth 字段改 provider排障时养成看日志的习惯tail -f ~/.openclaw/logs/*.log报错原文比猜快得多。如果 Key 本身有问题去 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重建一把字段含义不清楚就翻文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。6. 后续怎么用换模型、长期跑 Agent 与接入文档环境搭好只是开始真正用起来你会遇到两个需求换模型、长期跑任务。换模型最简单只改配置里的model字段Base URL 和 Key 都不动。比如从claude-sonnet-4-5换成别的改完重启openclaw dashboard即可。这就是统一通道的好处——不用改代码不用重新申请 Key。想先对比不同模型效果用模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 发几条消息试试选顺手的再写进配置。长期跑编码类 Agent 任务的话Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 更适合高频场景额度安排比按次调用划算。日常接入遇到字段问题文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里有完整的请求示例。几个实用技巧把openclaw dashboard做成 systemd 服务开机自启省得每次手动拉日志定期清理~/.openclaw/logs/跑久了会占空间Key 用环境变量管理换机器时只改环境变量不动配置。我踩过的坑是配置里同时写了环境变量和明文 Key结果框架读了明文那个改环境变量没生效排查了半天——统一用一种方式别混。最后一步确认你的~/.openclaw/config.json里 base_url 是https://taotoken.net/api、api_key 有值、model 是有效 ID然后openclaw run ping能返回内容这套环境就算养成了。