1. OpenClaw 是什么新手第一次跑通任务会卡在哪OpenClaw 是一套可以跑在你自己电脑上的开源个人助理框架支持 Windows、macOS 和 Linux。它能自动打开浏览器操作网页、在本机安装软件、执行脚本、监控任务还能通过向量记忆模块记住你的使用习惯。适合刚接触 AI Agent、想在自己机器上跑一个 24 小时助理的开发者。但很多人第一次装完 OpenClaw 之后会卡在同一个地方软件装好了任务却跑不起来。原因通常不是 OpenClaw 本身而是模型 API 没接上。OpenClaw 本体免费但它需要调用大模型接口才能思考和执行任务。你可以把 OpenClaw 理解成一辆车模型 API 就是油——车再好没油也动不了。我第一次配的时候环境变量、Base URL、模型 ID 三个东西对不上终端一直报401 Unauthorized排查了快半小时才发现是 Key 复制时多带了一个空格。这类问题在新手里非常常见。这篇教程的目标很明确从零开始给出可复制的安装命令、配置文件片段和验证步骤让你在 30 分钟内完成从安装到跑通第一个任务的全流程。模型接入部分我会用 TaoToken 统一 Key/API 通道来演示这样你不需要在多个厂商之间来回切换一个 Key 就能调用不同模型。你需要准备的东西一台能联网的电脑Windows/macOS/Linux 都行、Node.js 环境后面会给安装命令、一个 TaoToken API Key。不需要 GPU不需要 Docker不需要提前买任何套餐。整个流程分四步装 OpenClaw → 拿 TaoToken Key → 写配置文件 → 跑验证任务。下面逐步来。2. 安装 OpenClaw 与 TaoToken 前置准备2.1 安装 OpenClawMac/Linux 用户直接执行curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.comWindows 用户在 PowerShell 中执行iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com这两个脚本会自动安装 Node.js、NVM 和 OpenClaw。如果你本地已经有 Node.js 18 环境也可以手动安装npm install -g openclaw/cli安装完成后验证openclaw --version正常输出类似openclaw/0.9.x的版本号就说明安装成功了。如果提示command not found检查 npm 全局 bin 目录是否在 PATH 里。2.2 获取 TaoToken API Key打开 TaoToken 官网注册账号然后进入控制台创建 API Key官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setupAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setup创建后你会得到一串以sk-开头的 Key。复制保存好后面配置文件里要用。TaoToken 的作用是统一 API 通道你不需要分别去智谱、Kimi、阿里、字节各注册一遍只需要一个 TaoToken Key就能在 OpenClaw 里切换不同模型。API 端点统一为https://taotoken.net/api注意这个地址后面不加 UTM 参数直接用于代码里的 Base URL。2.3 确认模型 ID在 TaoToken 的模型列表页可以看到当前支持的模型 ID。常见的几个模型名称Model ID适用场景Claude Sonnetclaude-sonnet-4-20250514复杂推理、代码生成GPT-4ogpt-4o通用任务、多模态DeepSeekdeepseek-chat轻量任务、高性价比记下你要用的 Model ID下一步写配置时要用。如果你想先测试模型对话效果可以直接在模型对话页面试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setup3. 可复制配置OpenClaw 接入 TaoToken 的完整 settings 片段OpenClaw 的配置文件默认在~/.openclaw/config.jsonWindows 是%USERPROFILE%\.openclaw\config.json。如果文件不存在手动创建。3.1 完整配置文件{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: claude-sonnet-4-20250514, maxTokens: 4096, temperature: 0.7 }, agent: { name: my-claw, workspace: ./workspace, memoryEnabled: true }, skills: { autoLoad: [browser, self-improvement] } }三个关键字段说明baseUrl固定填https://taotoken.net/api不要加尾部斜杠apiKey填你在 TaoToken 控制台创建的 Key注意不要有多余空格modelId填你要用的模型 ID比如claude-sonnet-4-202505143.2 用环境变量替代硬编码不想把 Key 写在配置文件里的话可以用环境变量export TAOTOKEN_API_KEYsk-你的密钥然后配置文件改成{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, modelId: claude-sonnet-4-20250514 } }Windows 用户用set TAOTOKEN_API_KEYsk-xxx或通过系统环境变量设置。3.3 如果你用 Claude Code 或 CodexClaude Code 的配置文件在~/.claude/settings.json接入 TaoToken 的片段{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }Codex 用户编辑~/.codex/auth.json{ openai_api_key: sk-你的TaoToken密钥, api_base: https://taotoken.net/api }三件套记住Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填你要用的模型。这三个对上了基本不会出问题。配置写完后运行一次初始化检查openclaw config validate输出Config OK就说明格式没问题。如果报 JSON 解析错误用python -m json.tool ~/.openclaw/config.json检查语法。4. 验证请求跑通第一个 OpenClaw 任务配置写好了现在来验证整条链路能不能跑通。4.1 先做一次最小化对话测试openclaw chat 你好请用一句话介绍你自己如果配置正确你会看到模型返回的回复。这一步验证的是 OpenClaw → TaoToken → 模型这条链路是否通畅。正常输出类似[openclaw] Using model: claude-sonnet-4-20250514 [openclaw] Connected to https://taotoken.net/api Assistant: 你好我是运行在 OpenClaw 上的 AI 助理...如果这一步就报错了直接跳到第 5 节排查。4.2 跑第一个真实任务对话通了之后让 OpenClaw 执行一个实际任务。比如让它打开浏览器搜索一个关键词并截图openclaw run 打开浏览器访问 https://www.baidu.com搜索 OpenClaw 教程截图保存到 ./workspace/search.pngOpenClaw 会依次执行启动浏览器 → 导航到百度 → 输入搜索词 → 截图 → 保存文件。终端会实时打印每一步的执行日志。执行完成后检查文件ls -la ./workspace/search.png能看到文件就说明任务跑通了。4.3 验证向量记忆再跑一个任务测试记忆模块openclaw run 记住我的项目路径是 /home/user/myproject然后新开一个会话openclaw chat 我的项目路径是什么如果模型能回答出/home/user/myproject说明向量记忆模块工作正常。4.4 查看运行日志所有请求日志在~/.openclaw/logs/目录下tail -f ~/.openclaw/logs/agent.log日志里会记录每次 API 请求的 URL、模型 ID、token 消耗和响应时间。如果你想知道每次任务花了多少 token看这个日志最直接。到这里从安装到跑通第一个任务的完整流程就走完了。整个过程如果顺利30 分钟内可以搞定。下面说几个常见的坑。5. 常见报错排查401、local proxy failed、reading choices这一节列出新手最常碰到的几个报错和对应解法。5.1 401 UnauthorizedError: 401 Unauthorized - Invalid API key原因Key 不对。检查三个地方第一Key 是否完整复制有没有多余空格或换行。用echo $TAOTOKEN_API_KEY | wc -c看长度对不对。第二Key 是否已过期或被删除。去 TaoToken 控制台确认 Key 状态是 active。第三配置文件里的apiKey字段是否真的读到了。用openclaw config show看实际加载的值。5.2 local proxy failed / connection refusedError: local proxy failed - connect ECONNREFUSED 127.0.0.1:7890原因系统里残留了本地代理设置OpenClaw 尝试走代理但代理没开。解法unset HTTP_PROXY unset HTTPS_PROXY unset ALL_PROXY然后重新运行。Windows 用户在系统设置里检查代理配置关掉手动代理。5.3 Error reading choices / unexpected response formatError: reading choices - unexpected response format原因Base URL 填错了。常见错误是填了https://taotoken.net/api/v1或https://taotoken.net/api/多了尾部斜杠。正确写法就是https://taotoken.net/api不带/v1不带尾部斜杠。改完重新验证。5.4 OAuth token expiredError: OAuth token expired - please re-authenticate原因如果你之前用的是其他平台的 OAuth 登录方式token 过期了。切到 TaoToken 的 Key 认证方式即可在配置文件里确保provider是openai-compatibleapiKey填的是 TaoToken 的 Key。5.5 模型返回空内容有时候请求成功了但返回是空的。检查modelId是否拼写正确。比如claude-sonnet-4-20250514写成了claude-sonnet-4有些模型 ID 必须完整匹配。去 TaoToken 模型列表页复制准确的 ID。5.6 排查通用思路碰到任何报错按这个顺序查openclaw config validate检查配置格式openclaw config show看实际加载的配置值tail -50 ~/.openclaw/logs/agent.log看详细错误日志用curl直接测试 API 连通性curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的密钥 \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:test}]}如果 curl 能通但 OpenClaw 不通问题在 OpenClaw 配置如果 curl 也不通问题在 Key 或网络。6. 长期使用建议与资源入口跑通第一个任务之后接下来可以考虑几件事。装基础 Skill。OpenClaw 的能力靠 Skill 扩展。建议先装这几个browser浏览器自动化、self-improvement自我改进和错误记录、vector-memory向量记忆搜索、skill-vetter安全检查。安装命令openclaw skill install browser self-improvement vector-memory skill-vetter配置 Coding Plan。如果你打算长期用 OpenClaw 做开发任务TaoToken 的 Coding Plan 比按量计费更划算。入口https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setup接入文档备查。配置过程中如果碰到字段不确定的地方接入文档里有完整的参数说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setupClaude Code 用户。如果你同时用 Claude Code它的接入配置和 OpenClaw 类似参考https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setup日常管理。API Key 的创建、删除、用量查看都在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_setup最后说一个实际经验OpenClaw 的配置文件改完之后一定要重启 agent 进程才生效。我一开始改完配置直接跑任务发现还是用的旧模型折腾了半天才发现是进程没重启。用openclaw restart或者杀掉进程重新启动就行。