1. OpenClaw 本地部署到底难在哪谁适合看这篇OpenClaw 是一个用 TypeScript 写的个人电脑 AI 代理早先叫过 Clawdbot、Moltbot能在你本机帮你处理邮件、整理文件、自动操作电脑。它火起来之后很多人卡在第一步部署。官方文档默认你会用命令行、会配 Node 环境、会改配置文件光是npm install报错就劝退一大半人。这篇面向零代码基础的用户把 PC 电脑和手机安卓版两条线的本地部署流程拆开讲。核心思路是能用一键安装脚本解决的绝不让你手敲命令必须改配置的地方我给你可以直接复制的config.toml和settings.json骨架你只改几个字段就行。适合谁看完全没写过代码、但想让 AI 在自己电脑上跑起来的人已经装过一次失败、想搞清楚每一步在干什么的人以及想在安卓手机上跑一个轻量本地代理的人。我试过在 Windows 和一台安卓备用机上各走一遍踩过的坑集中在环境变量、端口占用和配置文件路径这三块后面会逐个排掉。整篇按「先讲问题 → 准备账号 → 复制配置 → 验证请求 → 排错 → 拿 Key」的顺序走你跟着做就行。2. 部署前的前置准备账号、环境与 TaoToken 接入OpenClaw 本身是本地运行的框架但它的对话能力需要一个模型服务来支撑。你可以把它理解成OpenClaw 是「身体」负责在你电脑上执行动作模型服务是「大脑」负责理解你说的话。本地部署只解决了身体的问题大脑还得接一个稳定的 API。这里用 TaoToken 来做模型接入原因是它的接口兼容主流格式配置里改一个base_url就能通不需要你折腾复杂的鉴权逻辑。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 端点固定为 https://taotoken.net/api 注意这个地址后面不要加任何多余路径。前置准备分三件事。第一确认你的设备满足最低要求PC 端建议 Windows 10 以上或 macOS 12 以上内存 8G 起步安卓端建议 Android 10 以上预留 2G 存储空间。第二注册并登录 TaoToken 账号拿到你的 API Key这一步在控制台完成地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 进去之后左侧找 API Keys 菜单。第三下载 OpenClaw 的一键安装脚本PC 和安卓各一份脚本会自动检测运行库、拉取依赖、生成默认配置。注意API Key 只显示一次拿到后先粘到记事本里存好后面配置config.toml要用。不要截图发群里这东西等同于你的账号密码。环境这块PC 端脚本会自动装 Node 18 和 Git你不需要手动装。安卓端因为权限限制脚本走的是 Termux 环境会自动初始化包管理器。如果你之前装过旧版本建议先卸载干净再跑脚本否则容易出现版本冲突。3. 可复制配置一键安装脚本 config.toml settings.json这一节是全文的核心所有命令和配置都可以直接复制。先讲 PC 端再讲安卓端。3.1 PC 端一键安装脚本执行下载脚本后Windows 用户右键「以管理员身份运行」macOS 用户在终端里执行下面这行。脚本会依次做四件事检测环境、安装依赖、生成配置目录、启动服务。# macOS / Linux 执行方式 chmod x openclaw-install.sh ./openclaw-install.sh --mode pc --auto-config# Windows PowerShell 执行方式 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass .\openclaw-install.ps1 -Mode pc -AutoConfig执行过程中你会看到类似[1/4] Checking runtime...的进度提示全程不需要你输入任何命令。脚本跑完后配置目录默认在~/.openclaw/Windows 是C:\Users\你的用户名\.openclaw\。3.2 config.toml 骨架配置打开配置目录里的config.toml把下面这段粘进去只需要改api_key那一行。其余字段保持默认即可base_url已经指向 TaoToken 的 API 端点。# OpenClaw 主配置文件 [server] host 127.0.0.1 port 8765 log_level info [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_name claude-3-5-sonnet timeout 60 [agent] name my-openclaw workspace ./workspace auto_start true [security] local_only true allow_file_access true几个关键点解释一下。host用127.0.0.1表示只允许本机访问数据不出本地。port默认 8765如果被占用改成 8766 即可。local_only true是安全开关确保代理不会对外暴露。3.3 settings.json 骨架配置部分功能模块比如文件管理和对话历史走的是settings.json和config.toml放在同一目录。内容如下{ ui: { theme: dark, language: zh-CN, show_toolbar: true }, storage: { history_path: ./data/history, max_records: 5000, auto_clean: true }, features: { file_manager: true, email_helper: false, auto_task: true }, api: { endpoint: https://taotoken.net/api, retry_times: 3, retry_interval: 2000 } }email_helper默认关掉你不需要邮件功能就别开减少权限申请。retry_times设成 3 是防止网络抖动导致请求失败配合retry_interval每 2 秒重试一次。3.4 安卓端一键安装安卓端在 Termux 里执行脚本会自动装好依赖并生成同样的配置结构。命令如下pkg update pkg install curl -y curl -fsSL https://taotoken.net/api/install-android.sh -o install.sh bash install.sh --mode android --auto-config跑完后配置文件在/data/data/com.termux/files/home/.openclaw/把上面两份配置按同样方式粘进去api_key换成你自己的。安卓端因为内存有限建议把config.toml里的model_name换成轻量一点的模型响应会更快。4. 验证请求确认服务正常启动配置改完下一步是启动服务并验证。PC 端在配置目录下执行openclaw start --config ./config.toml看到Server listening on 127.0.0.1:8765就说明服务起来了。然后开另一个终端发一个测试请求curl -X POST http://127.0.0.1:8765/v1/chat \ -H Content-Type: application/json \ -d {message:你好帮我列一下当前目录的文件,stream:false}如果返回类似下面的 JSON说明模型接入通了{ status: ok, reply: 当前目录下有 config.toml、settings.json 和 workspace 文件夹。, model: claude-3-5-sonnet, latency_ms: 842 }安卓端验证方式一样只是启动命令换成bash openclaw.sh start然后在 Termux 里用 curl 发同样的请求。实测下来PC 端首次响应在 1 秒左右安卓端因为要加载 Termux 环境首次会慢到 3 到 5 秒之后就正常了。提示如果 curl 返回Connection refused八成是服务没起来或者端口不对先回去看启动日志。返回401则是 API Key 有问题去控制台重新生成一个。想直接在网页里跟模型对话、不写 curl 的话可以用模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 登录后选同一个模型发一句话看能不能通能通说明 Key 和端点都没问题问题就出在 OpenClaw 的配置上。5. 本篇常见错误排查部署过程中报错集中在下面几类我按出现频率排一下。端口被占用。启动时报EADDRINUSE: address already in use 127.0.0.1:8765说明 8765 被别的程序占了。改config.toml里的port为 8766 或 8767重启即可。Windows 上可以用netstat -ano | findstr 8765查是谁占的。API Key 无效。返回401 Unauthorized或invalid api key。先确认 Key 复制时没带空格再确认base_url写的是https://taotoken.net/api而不是别的路径。如果还不行去 API Keys 页面重新生成一个地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。配置文件路径不对。报config file not found。PC 端确认在~/.openclaw/下安卓端确认在 Termux 的 home 目录下。启动命令里加--config指定绝对路径最稳妥。安卓端依赖安装失败。Termux 里报Unable to locate package先执行pkg update pkg upgrade更新源再重跑安装脚本。如果卡在下载环节换个网络环境重试。模型响应超时。timeout默认 60 秒如果模型负载高会超时。把config.toml里的timeout调到 120同时把retry_times保持 3 次。长期跑编码任务的话建议用 Coding Plan配额更稳入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。服务启动后立刻退出。看日志最后一行通常是workspace目录不存在。手动建一个workspace文件夹或者在配置里把workspace改成已存在的路径。排查顺序建议先看日志 → 再验 Key → 再查端口 → 最后看路径。大部分问题在前两步就能定位。接入相关的完整说明在文档里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到没覆盖的报错可以去翻一下。6. 拿到 Key 之后把 OpenClaw 跑成日常工具服务验证通过后最后一步是把 API Key 正式配好并跑通一个真实任务。去控制台生成 Key 的入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成后粘回config.toml的api_key字段重启服务。然后试一个真实场景让 OpenClaw 帮你整理桌面文件。在对话里输入「把桌面所有 .png 文件移到 Pictures 文件夹」看它能不能正确执行。能执行说明文件权限和模型理解都没问题。如果它只回复不执行检查settings.json里file_manager是不是true以及config.toml里allow_file_access有没有开。长期用的话PC 端可以把启动命令做成开机自启安卓端可以用 Termux 的termux-boot插件实现开机拉起。编码类任务建议走 Coding Plan普通对话和文件管理用默认模型就够。整套流程走下来从下载脚本到跑通第一个任务PC 端大概 15 分钟安卓端 20 分钟左右比手动敲命令省掉至少一半时间。