☰
OpenClaw本地部署工具:一键安装不用敲代码 + 完整教程PC电脑+手机安卓版合集
2026/9/27 17:38:33 网站建设 项目流程

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_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 端点固定为 https://taotoken.net/api ,注意这个地址后面不要加任何多余路径。

前置准备分三件事。第一,确认你的设备满足最低要求:PC 端建议 Windows 10 以上或 macOS 12 以上,内存 8G 起步;安卓端建议 Android 10 以上,预留 2G 存储空间。第二,注册并登录 TaoToken 账号,拿到你的 API Key,这一步在控制台完成,地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ,进去之后左侧找 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_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ,登录后选同一个模型,发一句话看能不能通,能通说明 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_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。

配置文件路径不对。报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_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。

服务启动后立刻退出。看日志最后一行,通常是workspace目录不存在。手动建一个workspace文件夹,或者在配置里把workspace改成已存在的路径。

排查顺序建议:先看日志 → 再验 Key → 再查端口 → 最后看路径。大部分问题在前两步就能定位。接入相关的完整说明在文档里:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ,遇到没覆盖的报错可以去翻一下。

6. 拿到 Key 之后:把 OpenClaw 跑成日常工具

服务验证通过后,最后一步是把 API Key 正式配好并跑通一个真实任务。去控制台生成 Key 的入口在这里:https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ,生成后粘回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 分钟左右,比手动敲命令省掉至少一半时间。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询