手把手教你“养龙虾”:OpenClaw本地部署完全指南(Windows/Mac/Linux全兼容)

手把手教你“养龙虾”:OpenClaw本地部署完全指南(Windows/Mac/Linux全兼容)目录 1 为什么要本地部署 先搞懂这三点 1 数据隐私可控 2 长期零成本 3 断网也能用 2 部署前的 全家桶 准备 3 Windows 11 本地部署 最全版本 第一步 以管理员身份打开 PowerShell 第二步 解锁执行策略 第三步 一键安装核心依赖 第四步 验证安装

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



目录

1.为什么要本地部署?先搞懂这三点

1.数据隐私可控

2.长期零成本

3.断网也能用

2.部署前的“全家桶”准备

3.Windows 11本地部署(最全版本)

第一步:以管理员身份打开PowerShell

第二步:解锁执行策略

第三步:一键安装核心依赖

第四步:验证安装

第五步:配置国内镜像(加速下载)

第六步:全局安装OpenClaw

第七步:初始化配置

第八步:启动服务

第九步:生成访问Token

第十步:访问Web控制台

4.MacOS本地部署(Intel芯片/M芯片通用)

第一步:打开终端

第二步:安装Homebrew(包管理工具)

第三步:安装Node.js 22

第四步:验证安装

第五步:配置国内镜像(可选,但推荐)

第六步:全局安装OpenClaw

第七步:初始化配置

第八步:启动服务

第九步:生成Token并访问

5.Linux本地部署(Ubuntu 20.04+)

第一步:打开终端

第二步:安装Node.js 22和Git

第三步:验证安装

第四步:配置国内镜像(可选)

第五步:全局安装OpenClaw

第六步:初始化配置

第七步:启动服务

第八步:生成Token并访问

6.进阶玩法:对接本地大模型(Ollama+Qwen)

第一步:安装Ollama

第二步:拉取本地模型(推荐Qwen2.5 7B)

第三步:定制模型(扩展上下文窗口)

第四步:重新配置OpenClaw对接本地模型

7.Skill安装:给“龙虾”装技能

核心安全原则:先装安全工具,再装功能插件

常用必备Skill(一键安装)

查看已安装Skill

8.避坑指南(新手必看)

坑1:Node.js版本过低

坑2:端口被占用

坑3:模型上下文窗口过小

坑4:Token泄露

坑5:Skill安装失败

在动手之前,咱们先花3分钟搞清楚一个问题:为什么要把OpenClaw装在本地,而不是直接用云端版?

1.数据隐私可控

你的聊天记录、文件内容、API密钥全都留在自己电脑里,不用上传任何第三方服务器。这对处理敏感数据的人来说,是刚需。

2.长期零成本

云端部署虽然方便,但Token消耗起来是真的肉疼——重度用户一天烧掉上百万Token,长期下来不是小数目。本地部署搭配Ollama本地模型,等于一次性投入,终身免费。

3.断网也能用

哪怕家里断网、出差飞机上,只要你电脑有电,OpenClaw就能干活。

不管你是哪个系统,下面这几样东西必须先准备好:

核心凭证:

1.阿里云百炼API-Key(用于调用大模型能力,新用户有免费额度)

2.获取路径:登录阿里云百炼大模型服务平台 → 密钥管理 → 创建API-Key,生成后立即复制保存(关掉页面就看不到了)

辅助工具:

1.浏览器(Chrome/Edge都行)

2.文本编辑器(VS Code或记事本都够用)

3.一个加密记事本(专门存API-Key和Token)

网络要求:

确保网络通畅,能正常下载依赖包(建议提前配好国内镜像,后面有命令)

第一步:以管理员身份打开PowerShell

右键点击开始菜单 → 选择“Windows PowerShell(管理员)”,这一步很重要,否则后面会权限报错。

第二步:解锁执行策略
powershell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

输入这行命令,回车,看到没有任何报错就行。

第三步:一键安装核心依赖
GPT plus 代充 只需 145powershell

安装Node.js 22+(OpenClaw运行必须)

winget install OpenJS.NodeJS.LTS –version 22.2.0

安装Python 3.9(部分Skill依赖)

winget install Python.Python.3.9

安装Git(拉取代码用)

winget install Git.Git

如果winget命令报错,可以去官网手动下载安装:

Node.js官网:https://nodejs.org (选LTS版,安装时勾选“Add to PATH”)

Python官网:https://python.org (选3.9+,安装时勾选“Add Python.exe to PATH”)

第四步:验证安装
powershell

node –version  # 应显示v22.x.x

npm –version   # 应显示10.x.x

python –version  # 应显示Python 3.9.x

如果版本都对,继续下一步。

第五步:配置国内镜像(加速下载)
GPT plus 代充 只需 145powershell

npm config set registry https://registry.npmmirror.com

这步能让你后面安装快3倍以上。

第六步:全局安装OpenClaw
powershell

npm install -g openclaw@latest

等进度条跑完,出现绿色的“added xxx packages”就成功了。

第七步:初始化配置
GPT plus 代充 只需 145powershell

openclaw init

系统会进入交互式配置界面,按提示操作:

· 选择模型提供商:选“Custom Provider”

· 输入API Base URL:https://dashscope.aliyuncs.com/compatible-mode/v1(阿里云百炼地址)

· 输入API Key:粘贴你刚才保存的百炼API-Key

· 其他选项全部回车默认

第八步:启动服务
powershell

openclaw start

看到“Server running on port 18789”的提示,说明启动成功。

第九步:生成访问Token
GPT plus 代充 只需 145powershell

openclaw start

复制输出的那串长字符串(以oc_开头),保存好。

第十步:访问Web控制台

打开浏览器,输入:

http://localhost:18789/?token=刚才复制的Token

看到OpenClaw的对话界面,恭喜你,Windows版“龙虾”养成功!

第一步:打开终端

在“启动台”搜索“终端”,打开。

第二步:安装Homebrew(包管理工具)
bash

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)";

如果已经装过,这步可以跳过。

第三步:安装Node.js 22
GPT plus 代充 只需 145bash

brew install node@22

echo ‘export PATH=”/usr/local/opt/node@22/bin:$PATH“’ >> ~/.zshrc

source ~/.zshrc

M芯片的Mac会自动安装ARM版本,不用担心兼容性。

第四步:验证安装
bash

node –version

npm –version

应该看到v22.x.x和10.x.x。

第五步:配置国内镜像(可选,但推荐)
GPT plus 代充 只需 145bash

npm config set registry https://registry.npmmirror.com

第六步:全局安装OpenClaw
bash

npm install -g openclaw@latest

第七步:初始化配置
GPT plus 代充 只需 145bash

openclaw init

交互步骤和Windows完全一样,按提示输入阿里云百炼API-Key即可。

第八步:启动服务
bash

openclaw start

第九步:生成Token并访问
GPT plus 代充 只需 145bash

openclaw token generate

浏览器输入http://localhost:18789/?token=你的Token,搞定!

第一步:打开终端

第二步:安装Node.js 22和Git
bash

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash

sudo apt install -y nodejs git

第三步:验证安装
GPT plus 代充 只需 145bash

node –version

npm –version

第四步:配置国内镜像(可选)
​bash npm config set registry https://registry.npmmirror.com

第五步:全局安装OpenClaw
GPT plus 代充 只需 145bash

npm install -g openclaw@latest

第六步:初始化配置
bash

openclaw init

同样是交互式配置,输入阿里云百炼API-Key。

第七步:启动服务
GPT plus 代充 只需 145bash

sudo openclaw start

Linux下可能需要sudo权限。

第八步:生成Token并访问
bash

openclaw token generate

浏览器访问http://你的本地IP:18789/?token=你的Token

如果你不想用云端API,想完全本地运行,可以搭配Ollama使用。

第一步:安装Ollama

访问Ollama官网(ollama.com)下载对应系统的安装包,一路下一步。

第二步:拉取本地模型(推荐Qwen2.5 7B)
GPT plus 代充 只需 145bash # Windows/Mac/Linux通用 ollama pull qwen2.5:7b

这个模型约4.7GB,显存4GB以上的显卡都能跑。

第三步:定制模型(扩展上下文窗口)

OpenClaw要求上下文窗口≥16000 tokens,默认模型只有4096,需要手动定制:

bash # 创建Modelfile配置文件 echo "FROM qwen2.5:7b PARAMETER num_ctx 32768" > Modelfile # 创建自定义模型 ollama create qwen2.5:7b-32k -f Modelfile
第四步:重新配置OpenClaw对接本地模型
GPT plus 代充 只需 145bash openclaw config wizard

这次选择:

· 模型提供商:Custom Provider

· API Base URL:http://127.0.0.1:11434/v1

· API Key:任意输入(比如“ollama”)

· Model ID:qwen2.5:7b-32k

部署只是第一步,装Skill才是让“龙虾”真正干活的关键。

核心安全原则:先装安全工具,再装功能插件
bash

安装安全扫描工具

clawhub install skill-vetting

这个工具能从源头拦截恶意插件,强烈建议第一个装。

常用必备Skill(一键安装)
GPT plus 代充 只需 145bash

文件管理器

clawhub install file-manager

内容摘要

clawhub install summary

邮件处理

clawhub install email

定时任务

clawhub install scheduler

网页自动化

clawhub install web-automation

数据抓取

clawhub install scraper

安装完成后重启服务生效。

查看已安装Skill
bash

clawhub list

根据上百位读者的反馈,我整理了最常见的几个坑:

坑1:Node.js版本过低

症状:安装报错“requires Node.js >=22.0.0”

解决:去官网重装最新版,或者用n升级:sudo n 22.0.0

坑2:端口被占用

症状:启动时提示“port 18789 already in use”

解决:关掉其他占用程序,或者改端口:openclaw config set server.port 18790

坑3:模型上下文窗口过小

症状:调用时报错“Model context window too small”

解决:按06部分定制模型,或者修改配置文件增加num_ctx参数

坑4:Token泄露

症状:发现陌生IP访问你的控制台

解决:立即重新生成Token:openclaw token generate –admin,不要把Token截图发群里

坑5:Skill安装失败

症状:clawhub install卡住或报错

解决:检查网络,或从GitHub直接拉取:git clone 技能地址

小讯
上一篇 2026-03-19 18:03
下一篇 2026-03-19 18:01

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/245287.html