本地部署OpenClaw龙虾全攻略从零搭建到模型选型实战1. 引言在2026年的AI智能体浪潮中OpenClaw曾用名Clawdbot/Moltbot社区昵称“龙虾”无疑是GitHub上最受关注的开源项目之一GitHub星标已超过30.9万颗登顶多个开源榜单。与传统的AI对话工具不同OpenClaw是一个“连接”框架——它将大模型的思考能力与电脑的真实操作权限连接起来通过自然语言指令实现浏览器控制、文件操作、Shell命令执行等全场景自动化真正让AI从“对话生成”走向“闭环执行”。本文你将收获理解OpenClaw的核心架构与工作原理完成OpenClaw的完整本地部署Windows/macOS/Linux掌握配置文件修改与模型切换方法学会根据场景选择最适合的AI模型2. OpenClaw核心认知2.1 技术架构OpenClaw采用四层架构设计各层功能边界清晰技能执行层状态记忆层推理决策层控制网关层 (Gateway)接入层IM渠道Telegram/WhatsApp/DiscordWeb控制台CLI命令行协议转换JSON-RPC端口18789连接管理模型配置auth-profiles.jsonOPA循环观察-规划-执行memory.db会话持久化WAL日志Skills预置30工具自定义扩展2.2 OpenClaw与模型的关系OpenClaw本身不包含任何AI模型。它的核心价值在于“连接”——连接大模型的思考能力与电脑的真实操作权限。就像一个机器人有了身体OpenClaw提供执行能力但还需要大脑AI模型提供思考和决策能力。因此你的OpenClaw用得好不好很大程度上取决于你给它配了什么模型。3. 本地部署OpenClaw3.1 硬件与系统要求组件最低要求推荐配置操作系统Windows 10/macOS 12/Ubuntu 22.04Windows 11 / Ubuntu 24.04CPU2核支持SSE4.24核支持AVX2内存2GB8GB复杂任务/大模型推理磁盘空间10GB20GB含模型文件Node.js≥ v22.0.0v22.16.0GPU可选—NVIDIA 8GB显存本地模型推理⚠️Windows用户注意官方明确建议通过WSL2Windows Subsystem for Linux方式安装而非原生Windows环境以获得更好的兼容性和稳定性。如果坚持原生Windows请确保以管理员权限运行所有命令。3.2 部署前置准备安装Node.js 22.x# Linux/macOS推荐使用nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bashsource~/.bashrc nvminstall22nvm use22# 或使用官方安装包# Node.js v22.0.0推荐v22.16.0Windows用户务必使用纯英文路径安装如D:\OpenClaw禁用中文、空格和特殊字符运行前彻底关闭所有安全防护软件360、火绒、Windows Defender实时防护等防止误判拦截推荐使用7-Zip或WinRAR解压安装包避免使用Windows自带解压工具3.3 三种安装方式方式一官方一键脚本安装强烈推荐新手WindowsPowerShell 管理员# 国际版iwr-useb https://openclaw.ai/install.ps1|iex# 国内加速镜像iwr-useb https://open-claw.org.cn/install-cn.ps1|iexmacOS/Linux/WSL2# 国际版curl-fsSLhttps://openclaw.ai/install.sh|bash# 国内加速镜像curl-fsSLhttps://open-claw.org.cn/install-cn.sh|bash安装脚本会自动检测系统环境安装Node.js如需要然后通过npm全局安装OpenClaw。方式二npm全局安装适合已有Node.js环境的开发者# 国际源npminstall-gopenclawlatest# 国内镜像加速推荐npminstall-gopenclawlatest--registryhttps://registry.npmmirror.com验证安装openclaw--version方式三Windows一键部署包零代码操作适合纯小白前往官方镜像源获取OpenClaw Windows一键部署包约361MB下载后使用WinRAR/7-Zip解压到纯英文目录双击Openclaw Windows 一键启动.exe即可自动安装——程序会自动检测并安装Git、Node.js、Python等依赖部署OpenClaw核心项目文件整个过程约3-5分钟。若弹出Windows SmartScreen提示点击「更多信息」→「仍要运行」即可。3.4 初始配置Onboard向导安装完成后运行引导程序完成初始配置openclaw onboard --install-daemon向导会依次引导完成选择安装位置默认~/.openclaw/选择AI供应商支持Anthropic Claude、OpenAI GPT、Ollama等配置API Key连接聊天平台Telegram、Discord、WhatsApp等可选健康检查与自动验证Gateway默认端口OpenClaw的Web控制台默认监听18789端口。访问http://127.0.0.1:18789即可打开可视化界面。3.5 验证部署成功# 查看Gateway状态openclaw gateway status# 健康检查curl-shttp://127.0.0.1:18789/health|python3-mjson.tool# 正常输出应包含 status: ok# 查看实时日志openclaw logs--follow--levelinfo4. 如何使用OpenClaw4.1 配置文件核心解读OpenClaw的模型配置通过一个JSON文件完成核心配置文件位于macOS/Linux~/.openclaw/openclaw.jsonWindowsC:\Users\你的用户名\.openclaw\openclaw.json多Agent配置~/.openclaw/agents/main/agent/auth-profiles.json核心配置结构如下{models:{providers:{本地Ollama:{baseUrl:http://localhost:11434,api:ollama,models:[{id:qwen2.5:7b,name:Qwen2.5 7B}]},阿里云百炼:{baseUrl:https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey:sk-你的阿里云API-Key,models:[{id:qwen-max,name:Qwen-Max}]}}},agents:{defaults:{model:{primary:本地Ollama/qwen2.5:7b,fallback:阿里云百炼/qwen-max}}}}4.2 三种模型切换模式OpenClaw支持灵活的多模型配置切换模式说明适用场景主备切换主模型不可用时自动切换备用确保服务高可用按场景切换不同Agent任务指定不同模型任务质量与成本最优分配手工切换通过配置文件修改primary灵活测试不同模型4.3 使用自然语言执行任务配置完成后即可通过自然语言向OpenClaw下达指令。典型任务示例# 文件操作指令openclaw chat--prompt分析当前目录下的Python文件统计函数调用次数# 浏览器自动化指令openclaw chat--prompt打开淘宝搜索AI书籍按销量排序后截图保存# 跨应用协同指令openclaw chat--prompt检查邮箱中的发票邮件下载附件并整理到桌面发票文件夹通过可视化Web控制台http://127.0.0.1:18789还可以实现模型切换、对话历史管理、指令实时输入等操作整个过程可视化、零代码。5. 如何选择模型5.1 选型全景图场景分类日常对话/中文办公推荐: GLM-5 / 元宝 / 豆包编程/代码生成推荐: DeepSeek V3.2复杂工程自动化推荐: Kimi K2.5数据隐私敏感/离线推荐: 本地模型Ollama/Qwen2.5-7B成本敏感/高频使用推荐: 元宝/豆包免费版多语言/英文场景推荐: GPT-4o / Claude5.2 云端模型推荐最优推荐Kimi K2.5工具调用能力最强OpenClaw的Agent任务本质是“模型决策→调用工具→读取结果→再决策”的循环。因此模型的工具调用能力强弱直接决定Agent任务的完成质量而非单纯的对话流畅度。Kimi K2.5在公开benchmark中表现最为突出256K超长上下文可一次性读入更多工具返回结果在SWE-bench Verified真实软件工程Agent评测中达到65.8%单次准确率在国产模型中处于第一梯队配置示例{id:kimi-k2.5,provider:qiniu/moonshotai/kimi-k2.5,apiKey:${QINIU_API_KEY}}代码生成首选DeepSeek V3.2DeepSeek V3.2是官方默认的primary模型在代码补全、函数生成、架构设计类任务上性能突出延迟低、响应快适合日常高频代码辅助场景。中文办公首选GLM-5GLM-5由智谱AI开发中文自然语言理解和指令遵循能力突出。在IFEval指令遵循评测得分87.6%超过DeepSeek V3的83.4%更适合中文文案撰写、报告生成等场景。5.3 本地私有化模型数据隐私优先如果对数据隐私有严格要求可选择本地私有化模型部署方案。OpenClaw通过Ollama、LM Studio等工具接入本地模型。方案一Ollama OpenClaw最受欢迎组合Ollama是目前最受开发者欢迎的本地大模型运行工具GitHub星标突破16万支持480开源模型一键部署。# 1. 安装Ollamacurl-fsSLhttps://ollama.com/install.sh|sh# 2. 下载并运行推荐模型需至少64k上下文ollama run qwen2.5:7b# 3. 直接通过Ollama启动OpenClawollama launch openclaw推荐使用的本地模型与OpenClaw配合良好模型特点推荐场景qwen2.5:7b中文能力优秀日常对话、办公自动化glm-4.7多语言通用能力强通用任务kimi-k2.51T参数工具调用最强复杂Agent任务qwen3-coder代码优化编程辅助方案二LM Studio Qwen3.5对于需要本地GPU推理的用户可采用LM Studio方案。根据硬件配置选择不同规模的模型RTX 3090/409024GB显存Qwen3.5-27B/35B量化版本RTX 3060/406012GB显存Qwen3.5-9B量化版本入门/无GPUQwen3.5-2B版本CPU推理或仅用云端API5.4 官方推荐模型与配置方案OpenClaw在阿里云百炼平台正式接入后推荐的模型包括qwen3.6-plus支持图像理解、kimi-k2.6支持图像理解、glm-5.1、MiniMax-M2.5。使用场景推荐模型理由国内用户/中文自动化Kimi K2.5工具调用精度高长上下文256K海外用户/英语环境GPT-4o / Claude原生最佳运行体验代码开发DeepSeek V3.2官方默认primary延迟低中文内容创作GLM-5IFEval得分87.6%指令遵循强数据隐私/离线Ollama qwen2.5:7b数据不出本地成本控制/高频元宝/豆包免费版零成本或极低成本6. 常见问题速查Q1遇到“Node.js版本不匹配”怎么办彻底移除旧版Node.js安装22.x及以上版本Linux/MacOS推荐nvm管理Windows选择官方LTS版终端重启后验证版本。Q2Gateway启动失败端口冲突怎么办# 查看占用端口的进程netstat-ano|findstr :18789# Windowslsof-ti:18789|xargskill-9# Linux/MacOS# 或修改配置文件中的端口openclaw configsetgateway.port 新端口Q3浏览器自动化无法启动怎么办OpenClaw的浏览器自动化功能依赖Chrome或Chromium需确保已安装。Q4提示“上下文容量不足”怎么办# 将contextWindow值调整为65536或更高openclaw configsetcontextWindow65536openclaw gateway restart7. 总结硬件环境准备安装Node.js 22一键脚本安装npm全局安装onboard向导配置API/模型验证Gateway状态健康接入模型选择最适配开始使用自然语言指令OpenClaw作为2026年最受欢迎的开源AI智能体框架核心价值在于将大模型的思考能力与电脑操作权限打通实现了从“对话生成”到“闭环执行”的跨越。选择什么样的模型决定它的能力上限。对于国内用户优先推荐Kimi K2.5工具调用最强代码开发场景优先DeepSeek V3.2官方默认数据隐私优先本地OllamaQwen2.5方案。关键提醒OpenClaw具备系统级操作权限能读写文件、执行命令建议在专用设备或虚拟机上运行防止因配置错误导致数据泄露部署前务必检查防火墙是否放行18789端口这是新手排名第一的踩坑点若使用本地模型模型上下文长度建议至少64k Tokens若使用的是旧版命令Clawdbot/Moltbot旧命令clawdbot和moltbot仍可作为别名使用