1. 虚拟机里跑 OpenClaw新手最容易卡在哪OpenClaw 是一个轻量级的自动化采集与任务编排框架结构清晰、扩展性强适合做数据采集、定时抓取、内容聚合这类工作。它本身不绑定特定模型但如果你想让采集到的内容自动做摘要、分类、清洗就需要接一个大模型通道。这篇内容面向第一次在虚拟机里部署 OpenClaw 的新手从系统准备一路走到模型接入和连通性验证每一步都给可复制的命令和配置。很多人第一次在虚拟机里装 OpenClaw卡住的地方其实不是 OpenClaw 本身而是三件事系统依赖没装全导致编译中断、配置文件里一个标签没闭合导致服务反复重启、以及模型接入时 Base URL 和 Key 填错导致请求一直 401。我试过在一台 2 核 4G 的 Ubuntu 虚拟机上从零走一遍把踩过的坑整理成下面这套流程。虚拟机的好处是环境干净、可快照、坏了直接回滚。推荐用 Ubuntu 22.04 LTS 或 CentOS 7/8分配至少 2 核 CPU、4GB 内存、20GB 磁盘。内存低于 2GB 时编译阶段容易 OOM磁盘低于 10GB 日志和缓存很快会撑满。下面按顺序来每一步都验证过。2. TaoToken 统一 Key 接入前的准备工作OpenClaw 跑起来之后真正让它“聪明”起来的是模型通道。TaoToken 提供统一的 API 入口一个 Key 可以调用多种模型省去在多个平台之间来回切换的麻烦。对新手来说这意味着你只需要记住一个 Base URL 和一个 Key就能在 OpenClaw 里完成模型接入。在开始之前你需要先拿到自己的 API Key。打开 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册后在控制台里创建一个 Key。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 的管理页面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建时建议给 Key 起一个能认出来的名字比如 openclaw-vm方便以后排查。拿到 Key 之后先别急着往 OpenClaw 里填。建议先在虚拟机里用 curl 测一下通道是否通这样能把“网络问题”和“配置问题”分开。API 的基础地址是 https://taotoken.net/api 注意这个地址不带任何查询参数。测试命令如下curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer 你的Key \ | head -c 500如果返回一串 JSON里面有模型列表说明 Key 和网络都没问题。如果返回 401说明 Key 填错了或者没带上 Bearer 前缀如果卡住不动检查虚拟机的 DNS 和出网是否正常。这一步花两分钟能省掉后面半小时的瞎猜。TaoToken 的接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有各语言的调用示例。OpenClaw 的模型配置本质就是填三个东西Base URL、API Key、Model ID。Base URL 用 https://taotoken.net/api Model ID 填你在模型对话页面里看到的模型名比如 claude-sonnet 这类。模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以先在那里确认模型名再填进配置。3. 可复制的 OpenClaw 安装与模型配置片段这一节是全文的核心所有命令和配置都可以直接复制。先装系统依赖再编译 OpenClaw最后写模型配置。第一步更新系统并安装编译工具链和网络库。Ubuntu/Debian 下执行sudo apt update sudo apt upgrade -y sudo apt install -y build-essential libcurl4-openssl-dev \ libxml2-dev libxslt1-dev zlib1g-dev git wget jqCentOS 下换成sudo yum update -y sudo yum groupinstall -y Development Tools sudo yum install -y libcurl-devel libxml2-devel libxslt-devel \ zlib-devel git wget jq装完后验证关键库是否注册成功pkg-config --modversion libcurl pkg-config --modversion libxml-2.0两条命令都能输出版本号说明依赖到位。如果报 “Package not found”说明对应的 -dev 或 -devel 包没装上回头补装。第二步拉源码并编译。创建工作目录并克隆sudo mkdir -p /opt/openclaw sudo chown $USER:$USER /opt/openclaw cd /opt/openclaw git clone https://github.com/example/openclaw.git .配置并编译./configure --prefix/usr/local/openclaw make -j$(nproc) sudo make installmake -j$(nproc)会按 CPU 核数并行编译2 核机器大概两三分钟。编译报 “undefined reference” 基本都是依赖没装全回到第一步检查。装完后把可执行文件路径加进环境变量echo export PATH$PATH:/usr/local/openclaw/bin ~/.bashrc source ~/.bashrc openclaw --version能输出版本号就说明安装成功。第三步写模型配置。OpenClaw 的模型接入配置通常放在conf/model.json或主配置的model段里。下面是一个可直接复制的 JSON 片段路径按你实际安装位置调整{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: 你的TaoToken Key, model_id: claude-sonnet, timeout: 60, max_retries: 3 } }三个关键字段必须写全base_url填 https://taotoken.net/api api_key填你在控制台创建的 Keymodel_id填模型对话页面里确认过的模型名。少任何一个请求都会失败。如果你用的是 TOML 格式的配置等价写法是[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model_id claude-sonnet timeout 60 max_retries 3配置文件改完后用jq . conf/model.json或python -m json.tool conf/model.json检查语法一个逗号或引号错了都会导致服务起不来。4. 启动服务并验证模型连通性配置写好后先以前台模式启动方便看日志openclaw --config /usr/local/openclaw/conf/config.json如果屏幕输出初始化成功、开始监听任务队列说明服务正常拉起。按 CtrlC 停掉改成 systemd 守护进程。创建服务文件sudo tee /etc/systemd/system/openclaw.service /dev/null EOF [Unit] DescriptionOpenClaw Service Afternetwork.target [Service] Typesimple User你的用户名 ExecStart/usr/local/openclaw/bin/openclaw --config /usr/local/openclaw/conf/config.json Restarton-failure RestartSec5 [Install] WantedBymulti-user.target EOF重载并启动sudo systemctl daemon-reload sudo systemctl start openclaw sudo systemctl status openclaw状态显示 active (running) 就对了。接下来验证模型通道。OpenClaw 一般提供--test-model或类似的诊断命令如果没有可以直接用 curl 模拟一次对话请求curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{role: user, content: 回复ok}] } | jq -r .choices[0].message.content返回ok或类似内容说明模型通道完全打通。如果返回里没有choices字段看error字段的内容通常是 Key 或模型名的问题。这一步验证通过后OpenClaw 里所有依赖模型的功能就都能用了。再写一个最小任务验证端到端。创建task.json{ name: demo, start_url: https://example.com, extract: { item: //h1, fields: { title: ./text() } }, output: { type: file, path: /tmp/openclaw-demo.json } }执行openclaw --task /opt/openclaw/task.json cat /tmp/openclaw-demo.json能看到提取出的标题说明采集和输出链路都正常。5. 常见报错排查401、local proxy failed、reading choices新手在这一步最容易遇到几类报错下面按真实报错信息对照排查。第一类401 Unauthorized或invalid api key。原因通常是 Key 填错、Key 前后有空格、或者没带Bearer前缀。检查配置文件里的api_key字段确认没有多余空格。用 curl 单独测一次如果 curl 也 401就是 Key 本身的问题去控制台重新生成一个。注意不要把 Key 提交到 Git 仓库建议用环境变量注入。第二类local proxy failed或connection refused。这通常是虚拟机出网问题或 DNS 解析失败。先在虚拟机里ping taotoken.net看能不能解析再curl -v https://taotoken.net/api/v1/models看握手过程。如果 DNS 有问题改/etc/resolv.conf加一个可用的 DNS。如果虚拟机网络是 NAT 模式确认宿主机网络正常。这类报错和 Key 无关别在配置里反复改。第三类reading choices或cannot read property choices of undefined。这说明请求发出去了但返回结构不是预期的对话格式。常见原因是model_id填错或者base_url多写了/v1导致路径重复。Base URL 只填 https://taotoken.net/api 不要在后面加/v1OpenClaw 或 SDK 会自动拼。另外确认model_id是模型对话页面里真实存在的名字拼错了会返回错误结构。第四类OAuth相关报错。如果你用的是 Claude Code 这类需要 OAuth 的工具报错通常出现在 token 过期或授权范围不对。Claude Code 的接入配置在 https://taotoken.net/claude-code?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按文档里的步骤重新走一遍授权。注意 OAuth 和 API Key 是两套机制别混用。第五类编译阶段fatal error: curl/curl.h: No such file。这是libcurl4-openssl-dev没装上回到第 3 节补装依赖。CentOS 下对应libcurl-devel。装完后make clean make重新编译。排查时记住一个原则先分层再定位。网络层用 curl 测配置层用 jq 检查语法模型层用最小请求测。三层都过了问题基本就没了。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔跑一次采集任务上面的配置已经够用。但如果你打算把 OpenClaw 当成长期的自动化引擎每天定时跑、接多个模型、做内容清洗和分类那建议把模型通道单独管理起来。TaoToken 的 Coding Plan 适合这种长期编码和 Agent 场景入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 里面有额度管理和多模型切换的说明。实际使用中把 Key 放在环境变量里而不是写死在配置文件是个好习惯echo export TAOTOKEN_API_KEY你的Key ~/.bashrc source ~/.bashrc然后配置文件里用${TAOTOKEN_API_KEY}引用。这样换 Key 不用改配置也不会不小心把 Key 传到仓库里。定时任务用 cron 挂起来每天早上跑一次0 8 * * * /usr/local/openclaw/bin/openclaw --task /opt/openclaw/task.json /var/log/openclaw/cron.log 21日志定期清理避免磁盘被撑满。配合 systemd 的Restarton-failure进程崩了会自动拉起。虚拟机记得定期打快照配置改坏了直接回滚比一点点排查快得多。最后一步把上面所有配置跑通后用systemctl status openclaw确认服务在跑用 curl 确认模型通道通用一次最小任务确认端到端没问题。这三件事都过了你的 OpenClaw 实例就算真正可用了。