1. 为什么要在本地跑 OpenClaw 这类智能体OpenClaw 是一个能在你自己电脑上运行的本地智能体圈内有人叫它小龙虾 AI。它和普通聊天机器人的区别在于它能听懂自然语言指令把「把下载文件夹里的图片按日期归档」这种话拆成一步步操作然后真的去动你的文件、开浏览器、整理表格。适合谁适合每天被重复性办公操作消耗精力、又不想把文件传到云端的人。我试过把它装在 Windows 和 MacOS 上最大的感受是安装本身不难难的是模型接入那一步。OpenClaw 自己不带模型能力它需要一个 API 通道来驱动。这篇就聚焦两件事——可视化安装流程以及用 TaoToken 统一 Key 把模型接进去最后跑通连通性验证。先说清楚整体链路OpenClaw 负责「执行动作」模型负责「理解指令」TaoToken 负责「提供统一的模型调用入口」。三者关系理顺了配置就不会乱。2. TaoToken 前置准备拿到统一 Key 和 API 通道TaoToken 在这里的角色是统一 Key 和 API 通道。你不需要为每个模型单独申请账号、记不同的 Key一个 Key 就能调用多种模型。对本地智能体来说这很省事因为 OpenClaw 的配置里只需要填一个 base_url 和一个 api_key。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册账号。注册流程很常规邮箱加密码就行。第二步进入控制台创建 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。在 API Keys 页面点新建复制生成的 Key形如sk-xxxxxxxx。这个 Key 只显示一次先存到记事本里。第三步确认 API 端点。TaoToken 的 API 地址是 https://taotoken.net/api 注意这个地址不带任何查询参数。OpenClaw 配置里的 base_url 就填它。如果你后面要长期跑编码类或 Agent 类任务可以了解下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它针对高频调用场景做了额度优化比按次计费更适合智能体这种反复调用的用法。注意Key 不要直接写进会提交到 Git 的配置文件里。本地测试可以先用环境变量或者单独放一个不纳入版本管理的文件。3. 可视化安装Windows 与 MacOS 的完整流程3.1 安装前的系统准备不管哪个系统先做一件事退出所有安全防护软件。火绒、360、电脑管家、Windows Defender 实时防护全部关掉。原因很直接——OpenClaw 要读写本地文件、模拟键鼠、控制浏览器这些行为在防护软件眼里就是高危操作很容易被拦截甚至把核心文件隔离删除。这一步不做后面大概率卡在 Gateway 离线。MacOS 用户额外注意在「系统设置 - 隐私与安全性」里给 OpenClaw 授予「辅助功能」和「完全磁盘访问权限」否则它没法模拟操作。3.2 Windows 安装步骤下载整合安装包解压时用 7-Zip 或 WinRAR别用系统自带的解压工具容易丢文件或权限异常。解压后进入Openclaw-win文件夹双击Openclaw Windows 一键启动.exe。如果弹出「Windows 已保护你的电脑」点左下角「更多信息」再点「仍要运行」。进入欢迎页点「开始使用」跳到路径配置。这里有个硬性规范安装路径只能是纯英文不能有中文、空格、中文标点或特殊符号。推荐D:\OpenClaw像D:\AI工具\OpenClaw这种带中文的目录会直接安装失败。勾选用户协议和免责声明点开始安装。程序会自动做环境检测、补依赖、部署核心程序、生成本机配置大概 3 到 5 分钟。这期间别关窗口。安装完软件自动启动第一次加载 Gateway 后台服务要等 1 到 3 分钟。右上角显示「Gateway 在线」就说明部署成功了。3.3 MacOS 安装步骤MacOS 版本流程类似下载对应的整合包解压后运行启动程序。路径同样要求纯英文推荐放在/Users/你的用户名/OpenClaw。首次运行如果提示「无法打开因为来自身份不明的开发者」去「系统设置 - 隐私与安全性」里点「仍要打开」。MacOS 上 Gateway 首次初始化时间可能比 Windows 稍长耐心等状态变成在线。4. 可复制配置config.toml 与 settings.json 骨架安装完成后OpenClaw 会在安装目录下生成配置文件。核心是两个文件config.toml管模型接入settings.json管运行参数。下面是可以直接复制修改的骨架。4.1 config.toml 模型接入配置# OpenClaw 模型接入配置 # 文件位置安装目录/config/config.toml [model] # 使用 TaoToken 统一 API 通道 provider openai_compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_name claude-3-5-sonnet max_tokens 4096 temperature 0.3 [model.fallback] # 主模型不可用时的备用模型 model_name gpt-4o-mini max_tokens 2048 [gateway] host 127.0.0.1 port 8765 auto_start true几个参数说明provider填openai_compatible因为 TaoToken 的接口兼容 OpenAI 格式base_url就是 https://taotoken.net/api 不要加斜杠后缀api_key换成你刚才复制的 Keymodel_name按你实际要用的模型填。4.2 settings.json 运行参数{ workspace: D:/OpenClaw/workspace, language: zh-CN, auto_execute: true, confirm_before_action: false, max_steps: 30, timeout_seconds: 120, log_level: info, browser: { headless: false, default_engine: chromium }, file_ops: { allow_delete: false, backup_before_modify: true } }workspace是智能体默认操作目录建议单独建一个文件夹别直接指向整个 D 盘。confirm_before_action设为 false 表示任务自动执行不逐步确认测试阶段可以先设 true 观察它的每一步动作。allow_delete建议保持 false避免误删。注意两个文件改完都要保存为 UTF-8 编码Windows 上用记事本另存时注意选编码否则中文路径或指令可能乱码。5. 验证请求确认模型通道真的通了配置写完不代表通了得实际验证。有两种方式。5.1 用模型对话页面快速验证最直接的办法是打开模型对话页面 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 在里面选一个模型发一句话比如「你好回复一个字通」。如果能正常返回说明你的 Key 和通道没问题。这一步能排除掉大部分「Key 填错」或「额度不足」的问题。5.2 用 curl 验证 API 端点在终端里跑一条请求确认 base_url 和 Key 组合可用curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: 回复连通正常}], max_tokens: 50 }返回里如果有choices字段和正常内容说明通道通了。如果返回 401是 Key 问题返回 404检查 base_url 是不是多写了路径。5.3 在 OpenClaw 里下发真实任务通道验证通过后回到 OpenClaw 界面在底部输入框下发一条测试指令在 workspace 目录下新建一个 test 文件夹并在里面创建一个 hello.txt内容写入「OpenClaw 连通测试成功」观察它是否自动执行并返回结果。如果 Gateway 在线但任务无响应多半是 config.toml 里的模型配置没生效重启一次 Gateway 服务再试。6. 本篇常见报错排查Q1程序文件被杀毒软件隔离删除关掉所有防护软件去隔离区恢复文件重新解压安装包再部署。装完之后可以把 OpenClaw 安装目录加入白名单避免下次又被删。Q2提示路径非法无法继续安装换成纯英文目录去掉中文、空格、特殊符号。D:\OpenClaw可以D:\AI 工具\OpenClaw不行。Q3Gateway 持续离线先确认防护软件全关、路径合规。点界面右上角重启服务。还不行就重新运行启动程序修复运行环境。MacOS 用户检查是否授予了辅助功能和磁盘访问权限。Q4任务下发后报模型调用失败大概率是 config.toml 里的 api_key 或 base_url 写错。用第 5 节的 curl 命令单独测一下通道确认 Key 有效、额度充足。注意 base_url 结尾不要加/v1OpenClaw 会自己拼路径。Q5首次启动特别慢首次运行要初始化各类组件属于正常现象后续启动会快很多。如果超过 5 分钟还卡着检查是不是被防护软件拖住了。Q6中文指令乱码检查 config.toml 和 settings.json 是否保存为 UTF-8 编码。Windows 记事本默认可能是 GBK另存时手动选 UTF-8。7. 后续接入与进阶方向跑通基础链路后你可以按需深入。如果主要做编码类或 Agent 类长期任务建议看看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 额度模型更适合高频调用。需要管理多个 Key 或查看用量去控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各语言 SDK 的调用示例。如果你用 Claude Code 这类工具Anthropic 兼容接入的说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentClaudeCodeAnthropicutm_campaignrewrite 。实际用下来最容易踩的坑不是安装而是配置文件的编码和 base_url 的写法。把这两点盯住剩下的就是让智能体多跑几条真实任务慢慢摸清它的执行边界。
退化到线性增长的排查与修复)
