1. 先搞清楚 OpenClaw 到底能帮你做什么OpenClaw 是一个本地运行的 AI 自动化执行工具你可以把它理解成一个「听得懂人话的电脑操作助手」。它和普通聊天机器人的最大区别在于普通机器人只能给你文字回复而 OpenClaw 能真正操控你的电脑——整理文件夹、打开软件、写入文档、读取磁盘信息这些动作它都能自己完成。适合谁用日常需要处理大量重复性文件操作的人、想体验 AI Agent 自动化但不想写代码的新手、以及希望把大模型能力接到本地工作流里的开发者。整篇手册面向 Windows 和 macOS 新手从下载安装包开始一路走到输入第一条自然语言指令并看到执行结果。中间我会给你一份可直接复制的config.toml骨架以及通过 TaoToken 统一 Key 和 API 通道接入模型的完整配置。你不需要提前装 Python、Node.js也不需要碰命令行——安装包内置了全部运行依赖整套部署流程五分钟左右就能跑完。我试过在 Windows 11 和 macOS 14 上各装一遍踩过的坑主要集中在安全软件拦截和安装路径含中文这两件事上。下面按顺序展开你跟着做就行。2. 安装前的准备TaoToken 统一 Key 与 API 通道OpenClaw 本身是一个执行框架它需要背后有大模型来理解你的指令。默认内置的通用助手能跑基础功能但如果你想切换成更强的模型、或者让多个工具共用一套凭证就需要一个统一的 API 通道。TaoToken 做的就是这件事一个 Key 打通多家模型不用在每个工具里分别填不同的地址和密钥。2.1 为什么建议用统一通道而不是逐个填 Key假设你同时在用 OpenClaw、某个代码补全插件、还有一个本地对话工具。如果每个工具都单独配置模型供应商你会面临三个麻烦密钥散落在不同配置文件里容易泄露、换模型时要逐个改配置、额度分散看不清总消耗。统一通道把这些收敛成一个 API 地址加一个 Key改一处就全生效。TaoToken 的 API 地址是https://taotoken.net/api这个地址不加任何追踪参数直接填进配置文件即可。你需要先去控制台创建一个 API Key然后把它写进 OpenClaw 的配置里。2.2 获取 Key 的具体路径打开浏览器访问 TaoToken 控制台登录后在左侧菜单找到「API Keys」页面点击创建新密钥。建议给这个 Key 起一个能辨认用途的名字比如openclaw-local方便以后排查问题时知道是哪个工具在用。创建完成后复制那串以sk-开头的字符串它只会完整显示一次先粘贴到记事本里暂存。如果你还没决定用哪个模型可以先去模型对话页面试几句确认响应速度和效果符合预期再回到控制台建 Key。这个顺序能避免你建了 Key 却发现模型不合适、又要重新配的尴尬。注意API Key 等同于账户凭证不要直接提交到 Git 仓库或分享给他人。配置文件里建议用环境变量引用后面我会给出写法。3. 下载与安装Windows 和 macOS 分步操作这一步的目标是把 OpenClaw 装到你的电脑上并且确保它能正常启动。整个过程是可视化交互不需要你手动敲命令。3.1 下载安装包根据你的系统选择对应版本。Windows 10/11 64 位用户下载 v2.9.3 版本macOS 12 及以上用户下载 v2.7.9 版本。压缩包体积约 45.8MB下载完成后先别急着双击按下面的顺序操作。3.2 解压与启动Windows 用户推荐用 WinRAR 或 7-Zip 解压系统自带的解压工具偶尔会出现文件缺损。右键压缩包选择「解压到当前文件夹」解压后会生成一个Openclaw-win文件夹。进入文件夹双击带有龙虾标识的启动文件。如果弹出 Windows SmartScreen 拦截窗口依次点击「更多信息」再点「仍要运行」。这不是病毒是因为程序具备键鼠模拟和文件读写能力系统对这类行为比较敏感。macOS 用户解压后直接双击.app文件。如果提示「无法打开因为来自身份不明的开发者」去「系统设置」-「隐私与安全性」里找到对应条目点击「仍要打开」。3.3 安装路径的硬性要求启动后会进入安装路径选择界面。这里有一条必须遵守的规则路径必须是纯英文不能包含中文、空格或特殊符号。像D:\软件\OpenClaw或D:\小龙虾这种写法会导致后续 Gateway 服务启动失败。推荐写法是D:\OpenClaw或E:\AI\OpenClaw。另外不建议装到 C 盘避免占用系统盘空间后续模型缓存和插件扩展也需要预留存储。勾选用户协议后点击「开始安装」程序会自动检测环境、补齐依赖、部署核心文件、生成配置文件全程三到五分钟期间不要关闭安装窗口。4. 可复制的 config.toml 骨架与 TaoToken 接入配置安装完成后OpenClaw 会在安装目录下生成一个config.toml文件。这是整个工具的核心配置文件模型接入、API 通道、运行模式都在这里定义。下面这份骨架你可以直接复制把其中标注需要替换的部分改成你自己的值。# OpenClaw 主配置文件 # 路径示例D:\OpenClaw\config.toml [gateway] # Gateway 服务监听端口默认即可 port 18789 # 启动后自动打开主界面 auto_open true [model] # 模型供应商标识使用统一通道时保持 custom provider custom # TaoToken API 地址不加任何追踪参数 base_url https://taotoken.net/api # 从控制台创建的 Key建议用环境变量引用 api_key ${TAOTOKEN_API_KEY} # 指定要调用的模型名称 model_name claude-sonnet-4-20250514 # 单次请求超时时间秒 timeout 60 [agent] # 运行模式auto 为自动执行chat 为普通交互 mode auto # 单条指令最大执行步数防止死循环 max_steps 20 # 是否允许文件写入操作 allow_file_write true # 是否允许键鼠模拟 allow_input_simulate true [workspace] # 默认工作目录建议设为纯英文路径 root D:/OpenClaw/workspace # 是否在每次执行前备份被修改的文件 backup_before_write true [log] # 日志级别debug / info / warn / error level info # 日志文件保留天数 retain_days 74.1 环境变量的设置方法配置文件里用了${TAOTOKEN_API_KEY}这种写法意思是让程序从系统环境变量里读取 Key而不是把明文写在文件里。Windows 用户可以在「系统属性」-「高级」-「环境变量」里新建一个名为TAOTOKEN_API_KEY的变量值填你复制的 Key。macOS 用户在~/.zshrc里加一行export TAOTOKEN_API_KEYsk-你的Key然后执行source ~/.zshrc生效。如果你觉得环境变量麻烦也可以直接把 Key 填在api_key那一行但要注意别把这个文件传到公开仓库。4.2 关键参数说明base_url必须指向https://taotoken.net/api这是统一通道的入口。provider保持custom表示走自定义地址而不是内置的某一家。model_name填你想用的模型标识具体可用的模型列表可以在 TaoToken 的接入文档里查到。mode设为auto时OpenClaw 会自动拆解任务并执行设为chat时只做对话不操作电脑。新手建议先用chat模式熟悉交互确认指令理解准确后再切到auto。5. 验证请求跑通第一条指令并确认结果配置写好后重启 OpenClaw 让配置生效。主界面右上角会显示 Gateway 状态等它变成「在线」就可以开始验证了。5.1 用一条简单指令做连通性测试在底部输入框输入下面这条指令按 Enter 发送读取当前电脑各磁盘剩余可用空间整理成文字反馈给我这条指令不涉及文件修改风险最低适合做第一次验证。如果配置正确OpenClaw 会调用系统命令获取磁盘信息然后在对话窗口里返回结果。你会看到类似这样的输出C盘剩余 42.3 GB / 总计 256 GB D盘剩余 187.6 GB / 总计 512 GB E盘剩余 89.1 GB / 总计 256 GB看到这个结果说明模型接入、API 通道、本地执行链路全部打通了。5.2 再试一条涉及文件操作的指令连通性确认后可以试一条稍微复杂点的在桌面新建一个文件夹叫 OpenClaw测试在里面创建一个文本文件写入部署成功这条指令会触发文件写入操作。执行完成后你去桌面看一眼应该能看到对应的文件夹和文件。如果文件内容正确说明allow_file_write配置生效自动化能力正常。5.3 切换模型验证统一通道想确认 TaoToken 通道确实在起作用可以改一下config.toml里的model_name换成另一个模型重启后再发一条指令。如果响应正常说明统一通道支持多模型切换你不需要改base_url或 Key。6. 本篇常见错误排查下面这些是我在实际部署中遇到过的报错按出现频率排序。6.1 Gateway 持续显示离线最常见的原因是安装路径含中文或特殊符号。检查你的安装目录如果有中文卸载后重新装到纯英文路径。其次是端口被占用可以改config.toml里的port值比如从 18789 改成 18790。如果还不行右键程序选择「以管理员身份运行」让 Gateway 有足够权限启动后台服务。6.2 安装过程中断或启动无响应先确认所有安全防护软件已完整关闭包括 Windows Defender 的实时防护。OpenClaw 具备键鼠模拟和文件读写能力容易被误判。关闭防护后如果仍然异常删除原有解压文件重新解压安装包再试一次。不要在原目录上覆盖安装残留文件可能导致冲突。6.3 输入框无法输入或指令发送无反馈等 Gateway 状态变成「在线」再操作。第一次启动需要初始化服务通常一到三分钟后续启动只需几秒。如果状态一直不在线参考 6.1 的排查步骤。另外检查config.toml里的api_key是否正确Key 无效时程序可能卡在请求阶段没有反馈。6.4 模型返回鉴权失败检查base_url是否写成了https://taotoken.net/api注意结尾没有多余的斜杠。检查 Key 是否完整复制有没有漏掉字符或带入空格。如果用的是环境变量引用确认变量名拼写一致并且重启过终端或程序让变量生效。6.5 文件操作被拒绝确认config.toml里allow_file_write设为true。另外检查workspace.root指向的目录是否存在如果目录不存在程序可能无法写入。建议手动创建这个目录或者把它设为一个已存在的路径。7. 后续怎么用从跑通到用顺第一条指令跑通之后你可以逐步把日常重复操作交给 OpenClaw。比如每周整理下载文件夹、批量重命名照片、从多个文档里提取信息汇总成表格。指令描述越具体执行精准度越高。与其说「帮我整理文件」不如说「把 D 盘下载文件夹里所有 PDF 移到 Documents/PDF 目录图片按拍摄日期分文件夹」。如果你打算长期用 OpenClaw 做编码辅助或 Agent 任务可以了解一下 Coding Plan它针对高频调用场景做了额度优化。需要管理多个 Key 或查看用量明细去控制台操作。接入文档里有完整的参数说明和模型列表配置过程中遇到不确定的字段可以先查那里。安装包和配置都就绪之后真正决定体验的是你怎么描述任务。先从一条指令只做一件事开始确认理解了再叠加步骤比一上来就下复杂指令要稳得多。