1. 先搞清楚 OpenClaw 到底能帮你做什么OpenClaw 是一个开源的 AI Agent 运行框架你可以把它理解成一个“能动手的数字助理”它不只是聊天而是能读文件、跑命令、调浏览器、装扩展把一句自然语言指令拆成可执行步骤。适合谁适合已经会一点 Node.js、想让 AI 真正替自己干活的开发者也适合想入门 Agent 但不想被复杂框架劝退的小白。它和 OpenClawd 的关系是OpenClaw 是执行主体OpenClawd 是后台守护进程负责让 Agent 在终端关闭后依然在线。很多人第一次装完发现“关掉窗口就失联”就是只跑了前者、没跑后者。这篇我会按“认知 → 环境 → 安装 → 配置 → 验证 → 排障”的顺序走一遍全程命令可直接复制。模型接入部分我用 TaoToken 做示例因为它同时兼容 OpenAI 与 Anthropic 风格的接口配置起来省事。你不需要先理解所有原理跟着敲完能跑通一次再回头看概念会顺很多。2. 装之前先把 Node.js 和 TaoToken 准备好2.1 Node.js 版本是第一个硬门槛OpenClaw 要求 Node.js ≥ v22低于这个版本会在启动 OpenClawd 时直接报Node.js version too low。先确认版本node -v npm -v如果低于 v22用 nvm 升级最省心nvm install 22 nvm use 22 nvm alias default 22Windows 用户建议在 WSL2 里操作以管理员权限打开终端避免路径和权限的坑。macOS/Linux 自带终端即可。硬件上 8GB 内存能跑16GB 更流畅磁盘留 20GB 给依赖和模型缓存。2.2 拿一个可用的模型 KeyAgent 的“大脑”来自大模型所以你需要一个 API Key。打开 TaoToken 控制台创建密钥https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite创建后复制那串sk-开头的 Key先存到环境变量里别硬写进代码export TAOTOKEN_API_KEYsk-你的密钥接口地址用https://taotoken.net/api这个地址同时支持 OpenAI 兼容格式和 Anthropic 兼容格式后面写 config.toml 时会用到。如果你还不确定该选哪个模型可以先去模型对话页面试一下响应速度https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite2.3 安全提醒OpenClaw 有系统级权限能执行 Shell、读写文件。建议先在虚拟机或备用设备上跑配置文件里把allowed_paths限制到具体目录别一上来就放开整个磁盘。3. 安装 OpenClaw 与 OpenClawd 的完整命令3.1 一键安装核心程序macOS / Linux / WSL2curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell管理员iwr -useb https://openclaw.ai/install.ps1 | iex安装过程 5–10 分钟看到OpenClaw installed successfully就成功了。如果提示curl: command not found先补上# macOS brew install curl # Ubuntu / Debian sudo apt install curl -y3.2 启动 OpenClawd 守护进程openclaw onboard --install-daemon向导会问两件事模型配置和权限配置。模型这里选自定义/OpenAI 兼容填入刚才的 Key 和https://taotoken.net/api权限先选保守模式禁用删除系统文件这类高风险操作。完成后终端显示OpenClawd started successfully说明后台进程已经起来了关掉终端也不会断。3.3 写一份可复制的 config.toml 骨架配置文件一般在~/.openclaw/config.toml。下面这份骨架可以直接改[agent] name my-openclaw workspace /home/yourname/openclaw_workspace allowed_paths [/home/yourname/openclaw_workspace, /home/yourname/Desktop] max_steps 20 [model] provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model claude-sonnet-4-5 timeout_seconds 60 [daemon] auto_start true log_level info log_path /home/yourname/.openclaw/logs/openclawd.log几个关键点allowed_paths决定 Agent 能碰哪些目录先窄后宽api_key_env指向环境变量名而不是明文max_steps防止任务无限循环烧 token。改完保存重启守护进程openclawd restart3.4 settings.json 示例部分版本用settings.json管理运行时开关放在同目录{ telemetry: false, confirm_dangerous_actions: true, skills: { enabled: [file-ops, shell-exec, web-fetch], auto_update: false }, memory: { enabled: true, max_entries: 500 } }confirm_dangerous_actions建议保持 trueAgent 要执行删除、覆盖这类操作时会先问你。memory打开后它会记住你的偏好用久了更贴合习惯。4. 验证请求确认 Agent 真的能干活4.1 先看守护进程状态openclawd status输出running就正常如果是stoppedopenclawd start openclawd status4.2 跑一个最小任务openclaw run 在桌面创建一个名为 openclaw_test.txt 的文件内容为 OpenClaw 测试成功桌面出现该文件且内容正确说明模型接入、权限、执行链路全通了。如果没反应先看日志tail -f ~/.openclaw/logs/openclawd.log日志里通常会直接告诉你卡在哪一步是 Key 无效、路径不在allowed_paths还是模型返回超时。4.3 验证模型侧是否正常想单独确认 Key 和接口没问题可以用 curl 打一次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: 回复ok}] }返回里有正常内容就排除掉模型侧问题把排查范围收窄到 OpenClaw 配置本身。5. 本篇常见报错与排查5.1 Node.js version too low原因就是版本低于 v22。按 2.1 的 nvm 命令升级升级后重开终端再node -v确认。5.2 权限不足 / permission deniedAgent 想访问的目录不在allowed_paths里。打开 config.toml把目标目录加进去保存后openclawd restart。别图省事直接写/那等于把整台机器交出去。5.3 关闭终端后 Agent 不响应OpenClawd 没在后台跑。执行openclawd start再openclawd status确认。如果每次都要手动起检查 config.toml 里auto_start true是否生效。5.4 模型返回 401 / 超时401 一般是 Key 没读到确认export的环境变量在当前 shell 生效或写进~/.bashrc/~/.zshrc。超时就把timeout_seconds调大或换一个响应更快的模型再试。5.5 任务跑一半停住多半是max_steps太小或某一步在等确认。看日志定位卡住的步骤必要时临时调大max_steps但别设太大容易失控烧额度。6. 跑通之后往哪走第一次跑通只是起点。想扩展能力可以装 Skillsopenclaw install skill web-fetch openclaw install skill file-ops长期做编码或 Agent 类任务建议用 Coding Plan额度更划算适合高频调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite如果你更习惯在编辑器里直接调 AgentClaude Code 的 Anthropic 兼容接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite需要新建或轮换密钥时回到 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite我自己的习惯是先把allowed_paths收窄到一个专用工作目录跑顺了再逐步放开每次改完 config.toml 都openclawd restart并看一眼日志比事后猜问题快得多。