完全免费且步骤巨详细搭建OpenClaw！龙虾养起!!! [特殊字符]

1. 零基础搭建 OpenClaw 到底难在哪Node.js 环境与 API Key 两道坎OpenClaw 是一个开源 AI 智能体平台你可以把它理解成住在电脑里的一个助理通过聊天窗口给它下指令它去操作文件、整理目录、调用本地软件、跑脚本。它本身不产生智能智能来自背后接入的大模型所以搭建过程本质上是两件事——把运行环境装好把模型通道接上。很多人卡住不是因为 OpenClaw 复杂而是卡在两个前置环节。第一个是 Node.js 环境OpenClaw 的运行依赖 Node 运行时版本太低或者装了但没进 PATH安装脚本就会直接报错退出。第二个是 API Key模型服务没开通、Key 复制时带了空格、Base URL 填错都会让 OpenClaw 启动后发不出请求。这两个环节任意一个出问题表现都是装完了但用不了新手很难判断到底哪一步错了。这篇面向完全零基础的用户从 Node.js 准备、Cherry Studio 配置到 API Key 接入逐步拆解每一步都给可复制的配置片段和验证动作。目标很明确让你独立完成搭建并且跑通一次 qwen-turbo 调用。qwen-turbo 是通义千问系列里响应快、成本低的型号适合作为第一个验证模型等链路通了再换更强的模型也不迟。需要提前说明的是OpenClaw 这类能操作本地文件的智能体权限边界要自己心里有数。建议先在闲置电脑或者隔离环境里体验不要一上来就让它接触生产数据和重要目录。下面进入实操。2. 搭建前的环境准备Node.js 安装与 Cherry Studio 获取2.1 Node.js 装哪个版本、怎么验证装好了OpenClaw 对 Node.js 版本有要求建议直接用 LTS 版本不要用太老的版本。安装方式有两种官网下载安装包或者用包管理器。Windows 用户直接下.msi一路默认下一步即可安装过程中如果弹出 PowerShell 相关组件选同意安装否则后续脚本执行会缺依赖。装完之后必须验证这一步别跳过。打开终端Windows 用 PowerShellmacOS 用 Terminal执行node -v npm -v正常输出类似v20.11.0和10.2.4。如果提示不是内部或外部命令说明没进 PATH重装一次并勾选Add to PATH或者手动把 Node 安装目录加进环境变量。2.2 Cherry Studio 是什么为什么用它Cherry Studio 是一款开源、跨平台的桌面 AI 客户端相当于一个多模型聚合工作台可以在一个界面里管理多家模型服务也支持本地离线使用。它内置了 OpenClaw 的快速安装入口对零基础用户来说省去了手动敲一堆命令的麻烦同时它还能帮你管理 API Key 和模型连接测试。下载地址是官网https://www.cherry-ai.com/download选对应系统的安装包装完直接运行。首次打开界面是空的需要先配置模型服务再走 OpenClaw 安装流程。2.3 环境变量与目录规划建议在正式装 OpenClaw 之前建议先想清楚两件事工作目录放哪、模型配置写在哪。OpenClaw 的配置通常以 JSON 或环境变量形式存在工作目录建议单独建一个比如D:\openclaw-workspace不要放在系统盘根目录或者桌面避免权限和路径空格问题。环境变量方面后面接入模型时会用到OPENAI_API_KEY和OPENAI_BASE_URL这类变量名OpenClaw 兼容 OpenAI 格式的接口。提前知道这两个名字配置时就不会对着文档发懵。下面进入模型通道的接入。3. 接入模型通道API Key 获取与可复制配置片段3.1 获取 API Key 的完整动作模型通道的获取有两种路径。一种是在 Cherry Studio 里直接选模型服务商按引导开通并创建 Key另一种是到模型服务平台的控制台手动创建。无论哪种核心产物都是一个 API Key 字符串以及一个 Base URL。以 TaoToken 为例它的接口地址是https://taotoken.net/api兼容 OpenAI 格式OpenClaw 和 Cherry Studio 都能直接对接。获取 Key 的入口在控制台的 API Keys 页面创建后复制保存注意不要带首尾空格。如果你更习惯在 Cherry Studio 里操作可以在设置 - 模型服务里选择对应服务商填入 Key然后点检测按钮测试连通性。检测通过后记得把服务开关打开否则模型列表里看不到可用模型。3.2 可复制的配置文件片段OpenClaw 的模型配置一般写在项目根目录的配置文件里常见是 JSON 格式。下面是一个可直接改用的片段把sk-xxxx换成你自己的 Key{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-xxxx, modelId: qwen-turbo, temperature: 0.7, maxTokens: 2048 }, workspace: D:/openclaw-workspace, logLevel: info }如果你更倾向用环境变量而不是写死在文件里可以这样设置。Windows PowerShell$env:OPENAI_API_KEYsk-xxxx $env:OPENAI_BASE_URLhttps://taotoken.net/apimacOS / Linuxexport OPENAI_API_KEYsk-xxxx export OPENAI_BASE_URLhttps://taotoken.net/api三件套要记牢Base URL、API Key、Model ID。这三个任意一个错请求都会失败。Model ID 这里填qwen-turbo注意大小写和连字符写成qwen_turbo或者Qwen-Turbo都可能识别不了。3.3 配置项的对照说明配置项作用常见错误值baseUrl模型接口地址漏掉/api或多了斜杠apiKey身份凭证复制时带空格或换行modelId指定模型大小写、连字符写错workspace智能体工作目录路径含中文或空格配置写完后不要急着启动先做一次连通性验证下一节讲具体怎么测。4. 启动 OpenClaw 并验证 qwen-turbo 调用成功4.1 安装 OpenClaw 的两种方式在 Cherry Studio 里首页有 OpenClaw 的安装入口点击后它会先检查 Node.js 环境缺环境会提示你先装。环境就绪后点安装 OpenClaw等待进度条走完即可。这种方式适合不想碰命令行的用户。如果你习惯命令行也可以用 npm 全局安装npm install -g openclaw openclaw --version能输出版本号说明安装成功。如果报权限错误Windows 用管理员身份运行终端macOS 在命令前加sudo。4.2 启动与模型选择安装完成后在 Cherry Studio 的 OpenClaw 面板里选择模型这里选qwen-turbo然后点启动。启动成功的标志是界面显示运行状态并且日志里没有报错。命令行方式启动openclaw start --config ./openclaw.json启动后终端会打印监听地址和加载的模型信息看到model: qwen-turbo和provider: openai-compatible就说明配置被正确读取了。4.3 发一条测试指令验证链路启动成功后在对话窗口输入一条简单指令比如列出当前工作目录下的文件。如果模型通道正常它会返回文件列表或者说明当前目录为空。这一步验证的是完整链路OpenClaw 收到指令 → 调用 qwen-turbo → 模型返回 → OpenClaw 执行或回复。也可以用 curl 直接测模型通道排除 OpenClaw 本身的干扰curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-xxxx \ -H Content-Type: application/json \ -d {model:qwen-turbo,messages:[{role:user,content:你好}]}返回里有choices字段和内容说明 Key 和 Base URL 都没问题。如果这一步就失败那问题在模型通道不在 OpenClaw。5. 常见报错排查401、local proxy failed、reading choices 逐个击破5.1 401 Unauthorized这是最常见的错误含义是身份验证失败。原因通常是三种Key 复制错了、Key 已失效或被删、请求头里没带 Authorization。排查动作是先确认 Key 字符串完整再确认请求头格式是Bearer sk-xxxx中间有一个空格。如果用的是环境变量检查变量名有没有拼错OPENAI_API_KEY不要写成OPENAI_KEY。5.2 local proxy failed这个报错一般出现在 Cherry Studio 或 OpenClaw 启动阶段含义是本地代理或网络请求层初始化失败。常见原因是端口被占用、Base URL 填了不存在的地址、或者系统代理设置干扰了请求。排查动作先确认baseUrl是https://taotoken.net/api且能正常访问再检查本地是否有其他程序占用了 OpenClaw 的监听端口换个端口重启试试。5.3 reading choices 相关报错这类报错通常表现为cannot read property choices of undefined或者reading choices含义是返回体里没有预期的choices字段。原因一般是接口返回了错误信息而不是正常结果但代码没做错误分支处理。排查动作先用上一节的 curl 命令直接打接口看返回的原始 JSON 是什么。如果返回里有error字段按错误信息处理如果返回正常但 OpenClaw 仍报错检查modelId是否和服务端支持的模型名一致。5.4 OAuth 与鉴权相关报错有些模型服务走的是 OAuth 流程而不是静态 Key如果你混用了两种方式会出现鉴权失败。OpenClaw 对接 OpenAI 兼容接口时用的是静态 Key不要填 OAuth 的 token。如果报错里出现invalid_grant或token expired说明你填的是会过期的凭证换成长期有效的 API Key。5.5 排查顺序建议遇到问题不要乱改配置按这个顺序来先 curl 测模型通道 → 再确认配置文件三件套 → 再看 OpenClaw 日志 → 最后查端口和权限。大部分问题在前两步就能定位。6. 跑通之后把 OpenClaw 用起来的几个实用方向链路跑通只是起点。OpenClaw 真正的价值在于把重复的电脑操作交给它执行。你可以先从低风险任务开始比如让它整理下载目录、按规则重命名文件、把散落的文档归类到对应文件夹。这些任务即使出错也不会造成大损失适合用来熟悉它的行为边界。再进一步可以给它配置定时任务比如每天早上汇总某个目录的新文件并生成一份清单。这类任务的关键是把指令写清楚包含目录路径、筛选条件、输出格式。指令越具体执行结果越稳定。模型选择上qwen-turbo 适合做验证和轻量任务响应快、成本低。等你要处理更复杂的推理任务时可以在配置里换更强的模型只需要改modelId一个字段其他配置不用动。这就是把模型通道和智能体逻辑分开配置的好处。最后提醒一句涉及敏感数据的场景务必在隔离环境里运行工作目录单独划分不要让它接触系统关键路径。先把边界划清楚再逐步放开权限这样用起来才踏实。