先说句大实话:听到“OpenClaw”这名字,很多人第一反应是“这又是个要折腾半天、看不懂命令行的开源项目”。我第一次在 GitHub 上刷到 Clawdbot 这个分支时也是这么想的,可实际花了一个下午把环境搭完,才发现它自称“不需要技术”并不夸张。真正难住新手的从来不是 OpenClaw 本身,而是不知道从哪里开始、该选哪个模型、装完以后怎么让它干点正事。
这篇文章专门写给非程序员和刚入门 AI 应用的朋友。我会围绕 2026 年 OpenClaw(社区里也更习惯叫它 Clawdbot)的秒速部署,整理 5 个可以直接照着做的教程。里面没有一行需要你理解原理的代码,所有命令基本都是“复制—粘贴—回车”级别;同时我会把我实际遇到的坑、报错,以及不同大模型的接入差异全部写出来。就算你完全没搞过本地部署,只要能打开电脑上的 PowerShell,今天就能把它跑起来。
1. 先说清楚:OpenClaw 和 Clawdbot 到底是什么
1.1 它不是你想的那种“软件”
很多刚接触的人以为 OpenClaw 是一款传统软件,装完双击图标就能用。其实它是一个基于大语言模型的智能体运行环境,你可以把它理解成一个“会自己用工具、会读文件、会一步步完成任务”的 AI 助手驾驶舱。它本身不生产答案,而是负责调度问题、调用工具、决定下一步做什么,真正干活的“大脑”是你挂在它后面的模型。
Clawdbot 则是 OpenClaw 社区里的一个常用别名,早期版本把命令行程序命名为 openclaw,界面和交互方式又很像一个聊天机器人,所以有人干脆叫它 Clawdbot。现在这两个词经常混着用,你搜“openclaw 部署”和“clawdbot 部署”,出来的基本上是同一个东西。对使用者来说,只需要知道它约等于“本地跑一个可以自动干活的 AI 助手”,这样就够了。
1.2 为什么 2026 年大家都在说“秒速部署”
前两年部署这类 AI 智能体确实麻烦:要装 Python、要配 CUDA、要理解模型参数、要填一堆 API Key。但 2026 年的环境已经完全不一样了。OpenClaw 官方和各社区把基础设施都铺好了:Windows 11 下一键安装包、便携版、 Docker 镜像、PowerShell 安装脚本,还有预置的 Ollama 本地模型联动方案。你甚至不需要手动创建配置文件,第一次启动时它会用问答的方式帮你生成。
所以“秒速部署”不是标题党。只要网络顺畅、工具版本对得上,从打开终端到第一次和 OpenClaw 对话,5 到 10 分钟是完全可以实现的。难点反而不是技术,而是很多人没意识到:你需要提前想清楚“我要用哪个模型”。
1.3 零基础也能上手的三个前提
先说三个前提条件,满足了你就能顺利走完后面的教程。
第一,电脑能联网,最好能正常访问国内外主流网站。第二,操作系统尽量用 Windows 11,Win10 也可以,但 Win11 的 PowerShell 和终端体验更省事。第三,不要害怕“命令行”。教程里你只是复制粘贴,真正要理解的只有几个固定名词:openclaw 是主程序,ollama 是本地模型管理器,workspace 是 OpenClaw 的工作目录。搞懂这三个,你已经超过一半的新手。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 部署前你需要准备的(其实就 3 样东西)
2.1 环境检查:一台能装 Windows 11 的电脑就行
先说环境。OpenClaw 官方对主流操作系统的支持已经很成熟,Windows、macOS、Linux 都能跑,但我个人最推荐在 Windows 11 上尝试,原因很简单:Windows 11 自带的 PowerShell 7 和 Windows Terminal 对新手更友好,粘贴命令不会乱码,权限提示也更直观。
如果你用的是 Win10,建议先把 PowerShell 升级到 5.1 以上,或者直接装一个 Windows Terminal。路径很简单:打开微软商店,搜索 Windows Terminal,安装好以后,所有操作都在这个终端里完成。硬件方面,OpenClaw 本身占用极低,1 核 2G 的云服务器都能跑;显卡也不是必须,因为模型可以跑在远程服务上。
我整理了一个简单的环境对照表,你可以先对号入座:
| 环境项 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 64 位 | Windows 11 64 位 |
| 内存 | 8GB | 16GB 及以上 |
| 磁盘空间 | 3GB 可用空间 | 20GB 以上(要装本地模型) |
| 终端 | PowerShell 5.1 | Windows Terminal + PowerShell 7 |
| 网络 | 能访问 GitHub 或镜像站 | 可正常访问模型下载源 |
2.2 模型选择:Ollama + DeepSeek / MiniMax H3 / 免费云模型
这里必须花点篇幅把模型讲透。OpenClaw 不等于模型,它是一个“骨架”,你要在骨架后面挂一个“大脑”。本地部署时最常用的搭配是 Ollama + 开源模型,热门搜索词里的“ollama部署”“deepseek部署”“minimax h3 部署”说的都是这条链路。
Ollama 是目前最流行的本地模型运行工具,它把模型下载、加载、运行封装成了几条简单命令,Windows 版装完后会在后台开一个本地服务,默认地址是 http://localhost:11434。OpenClaw 只要连上这个地址,就能用本地模型和它对话。
选模型时我建议按这个逻辑来:电脑显卡低于 8GB 显存,选 7B 参数左右的模型,比如 DeepSeek R1 7B;显存在 12GB 以上,可以试 14B 到 32B 的版本;完全不想占用本机资源,就直接用云端 API,比如 DeepSeek 开放平台的接口,或者 MiniMax 的在线接口。
| 模型方案 | 部署方式 | 成本 | 适合场景 |
|---|---|---|---|
| DeepSeek R1 7B | Ollama 本地部署 | 免费 | 日常对话、任务规划 |
| Qwen2.5 7B | Ollama 本地部署 | 免费 | 中文写作、项目整理 |
| MiniMax H3 | 本地/Ollama 或云端 API | 免费或按量 | 长文本、多模态扩展 |
| DeepSeek API | 云端调用 | 按 token 计费 | 重任务、追求稳定 |
2.3 “免费模型”到底怎么理解
很多新手会问:OpenClaw 能不能直接免费使用热门模型?答案是可以,但有条件。本地部署的开源模型完全免费,也不受网络限制,但模型能力受限于硬件;云端 API 虽然要注册和充值,但一般都会给新手赠送额度,日常折腾完全够用。
还有一个选择是 OpenClaw 内置的免费模型中转,首次登录时会给你一个临时额度。我的建议是把它当“体验通道”,不要当长期主力,因为共享额度有时候会排队,尤其是晚上高峰期。真正想长期用,要么本地挂一个小模型,要么注册一个云端 API,两条路都不难,后面教程都会覆盖到。
3. 5 个零代码教程,照着做就行
3.1 教程一:Windows 11 下用 PowerShell 完成 OpenClaw 安装
这一节是全篇最核心的部分。我默认你用的是 Windows 11,打开开始菜单,搜索“终端”或“PowerShell”,右键选择“以管理员身份运行”。
第一步,先检查一下本机有没有现成的包管理器。输入 winget --version,只要能输出版本号,说明系统自带 winget。接下来执行:
powershell复制winget install --id OpenClaw.OpenClaw -e --accept-package-agreements --accept-source-agreements
这里要注意,不同发布渠道的包名可能不完全一样,如果你在终端里看到提示找不到包,就去 OpenClaw 官网的 Quick Start 页面复制当前最新的安装命令。常见的安装方式还有一种,把官网给的 irm ... | iex 脚本命令直接粘贴进 PowerShell 执行,本质是下载一个官方安装脚本。
如果你之前装过 Node.js,也可以走 npm 路线:
bash复制npm install -g @openclaw/cli
装完后关掉终端重新打开,输入 openclaw --version,能看到版本号就说明安装成功。首次运行 openclaw init 会进入交互式配置,一路回车或按它的默认选择即可,它会自动创建 ~/.openclaw 目录和配置文件。
实操中的两个细节:一是 PowerShell 可能会提示“禁止运行脚本”,这是安全策略限制,执行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 就能放行;二是安装完必须重开一个终端窗口,否则 PATH 不会刷新,输入 openclaw 会提示找不到命令。
3.2 教程二:让 OpenClaw 接入 Ollama 里的 DeepSeek 本地模型
安装好 OpenClaw 之后,下一步就是给它接一个真正的“大脑”。以本地部署 DeepSeek 为例,先安装 Ollama,这一步也可以完全用复制粘贴完成。
打开 Ollama 官网,下载 Windows 版本,安装完成后同样重开一个终端,输入:
bash复制ollama pull deepseek-r1:7b
这条命令会下载 DeepSeek R1 7B 模型,大小大约 4.7GB。下载速度取决于你的网络,等它出现 success 提示后,再执行 ollama serve 确认本地服务已经启动。
然后回到 OpenClaw,在终端里输入:
bash复制openclaw models add deepseek --provider ollama --model deepseek-r1:7b --base-url http://localhost:11434
openclaw models use deepseek
第一步是注册模型,第二步是切换默认模型。如果你不想记命令,也可以通过配置文件手动修改:用记事本打开 C:\Users\你的用户名\.openclaw\config.toml,找到 models 段落,填上 provider 为 ollama、model 为 deepseek-r1:7b、base_url 为 http://localhost:11434。
我在这步踩过一个坑:OpenClaw 启动时如果发现 Ollama 没有运行,会直接连不上。所以正确顺序是先启动 Ollama,再启动 OpenClaw。Windows 上可以把 Ollama 设置为开机自启,这样后面每次用都不用手动打开。
3.3 教程三:配置 MiniMax H3 作为本地大模型引擎
如果你不想用 DeepSeek,想试试 MiniMax H3 这个新模型,流程也很接近。MiniMax H3 在长文本理解和推理上表现不错,尤其是处理项目文档、长篇内容时,比同参数量的一些模型更省 token。
先检查 Ollama 社区有没有现成镜像,直接在终端执行 ollama search minimax。如果能看到结果,就执行:
bash复制ollama pull minimax-h3
然后把它注册给 OpenClaw:
bash复制openclaw models add minimax-h3 --provider ollama --model minimax-h3
openclaw models use minimax-h3
如果 ollama search 找不到现成镜像,说明权重还在转换阶段,这时候有两个替代方案:一是去 Hugging Face 搜索 MiniMax H3 的 GGUF 格式文件,下载后通过 Ollama 的 Modelfile 手动创建;二是用 MiniMax 官方云 API,直接注册开放平台,拿到 API Key 后在 OpenClaw 里配置:
bash复制openclaw config set models.provider minimax
openclaw config set models.api_key sk-你的密钥
云端 API 的好处是不占本地显卡,坏处是要联网、并且按量计费。我个人体验下来的建议是:如果只是体验,先用本地小模型;如果你要做正经的批量任务,比如整理一百篇文档,那花几十块钱用 API 反而更省时间。
3.4 教程四:用 Obsidian 把 OpenClaw 变成项目管理助手
部署好模型之后,很多人会陷入“不知道让它干啥”的尴尬。我强烈推荐一个落地场景:结合 Obsidian 做项目管理。这也是很多人在搜索的热门组合,因为 Obsidian 的本质是一个本地 Markdown 笔记库,OpenClaw 最擅长的就是读写本地文件。
打开 Obsidian,随便建一个库,假设路径是 D:\MyVault。然后在 OpenClaw 里把工作目录指过去:
bash复制openclaw config set workspace "D:\MyVault"
接下来在 Obsidian 里建一个“任务.md”文件,写几个待办事项。回到 OpenClaw 对话窗口,你可以直接说:“帮我读取任务.md,把今天需要完成的事情按优先级排序,并生成一个新的今日计划.md”。
OpenClaw 会先定位文件、读取内容,再调用模型做排序和总结,最后把结果写回 Obsidian。整个过程中你没有写任何代码,只是用自然语言下指令。我实际用下来的感受是:它特别适合做笔记整理、会议纪要归档、多文件内容汇总这类事情,比传统的“手动复制粘贴”效率高很多。
还要养成一个好习惯:把重要操作记录成 OpenClaw 的 Skill。它就像一个“可复用的快捷指令”,等下次想执行同样任务时,直接输入技能名,OpenClaw 就会自动按之前的流程处理。
3.5 教程五:在云服务器上部署,并接入飞书使用
本地部署适合个人体验,但如果想团队使用,或者想让手机也能随时随地用,我建议把 OpenClaw 放到云服务器上。云服务器不需要很多配置,一台 2 核 4G 的 Linux 机器就够了。
先说服务器上的安装。如果服务器有 Docker,这是最省事的一种方式,直接执行:
bash复制docker run -d --name openclaw --restart=always -v ~/.openclaw:/root/.openclaw -p 1860:1860 ghcr.io/openclaw/openclaw:latest
这条命令会拉取镜像、把配置目录挂载到宿主机,并映射 1860 端口。没有 Docker 也可以直接在服务器上装 OpenClaw,再用 systemd 注册为系统服务,实现开机自启。
服务器部署好后,重点来了:怎么接入飞书。先去飞书开放平台创建一个企业自建应用,拿到 App ID 和 App Secret,然后在 OpenClaw 里启用飞书技能:
bash复制openclaw skill install feishu
openclaw config set feishu.app_id 你的AppID
openclaw config set feishu.app_secret 你的AppSecret
最后把飞书机器人的回调地址填成 http://你的服务器IP:1860/api/feishu/webhook。整个过程看起来复杂,其实都是填表单、点按钮,不需要写代码。
这里我要特别提醒三个安全细节:服务器上一定要设置防火墙,只开放用得到的端口;飞书应用里要开启加密和签名校验;不要把 API Key 直接写在聊天记录里,统一放在 .env 文件中。很多人部署完成后被陌生人盗刷 API,十有八九是这几个地方漏了。
4. 我踩过的坑:OpenClaw 常见问题与排查实录
4.1 启动就报“无法将 openclaw 项识别为 cmdlet”
这是新手最常见的报错,原因只有一个:系统 PATH 里没有 OpenClaw 的安装路径。通常发生在刚安装完、没有重开终端的情况下。解决办法很简单,关掉当前终端,重新打开一个新的 PowerShell 窗口。如果重开了还是不行,检查安装方式:npm 安装的话,Node.js 的全局目录一般会自动加入 PATH;手动安装可能要把安装目录手动加进环境变量。
4.2 出现 legacy exec approvals exist 提示,是不是出错了
很多人安装新版后第一次启动,会看到类似 legacy exec approvals exist at /root/.openclaw/exec-approvals.json 的提示。这不是报错,是旧版本的“命令审批记录”还需要迁移。OpenClaw 从 2.0 开始改了权限模型,老版执行敏感命令时记录的批准文件要迁移到新格式。
按提示输入对应的迁移命令,或者先执行 openclaw update --channel stable 更新到最新版,再重新启动就能解决。如果你不想保留旧的批准记录,也可以直接打开 ~/.openclaw/ 目录,把 exec-approvals.json 备份后删除,OpenClaw 会生成一份新的。我个人更推荐迁移而不是删除,这样以前允许过的工具调用记录不会丢失。
4.3 update --channel dev 还是 stable?
社区里经常能搜到 openclaw update --channel dev 和 openclaw update --channel stable 两种命令。dev 是开发版,能提前体验新功能,但容易出现小毛病;stable 是稳定版,bug 更少。
除非你有明确需求,否则我建议日常使用永远选 stable:
bash复制openclaw update --channel stable
我一个朋友图新鲜切到 dev 版,结果自己的 Skill 市场插件全部失效,折腾了一晚上才降回来。对于“不需要技术”的用户来说,稳定比新功能重要得多。
4.4 配置文件和工作目录位置太绕
经常有人问:我的 workspace 到底在哪?配置文件在哪?这些路径在不同系统上不一样。
| 系统 | 配置文件目录 | 默认 workspace |
|---|---|---|
| Windows | C:\Users\你的用户名\.openclaw\ |
C:\Users\你的用户名\.openclaw\workspace |
| macOS/Linux | ~/.openclaw/ |
~/.openclaw/workspace |
| Docker 容器 | /root/.openclaw/ |
/root/.openclaw/workspace |
如果不知道当前配置,命令 openclaw config show 或者 openclaw doctor 会一次性把相关路径全部列出来,不用自己挨个找。遇到路径不对的问题,先看这里再动手。
4.5 常见报错速查表
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| 找不到 openclaw 命令 | PATH 未刷新 | 重开终端,或手动添加 PATH |
| 连不上 Ollama | Ollama 服务未启动 | 执行 ollama serve 或设置开机自启 |
| 模型响应很慢 | 显卡显存不足 | 换小模型,或改用云端 API |
| 飞书收不到消息 | 回调地址或加签配置错误 | 检查 webhook 地址和 IP 白名单 |
| workspace 无法写入 | 目录权限不足 | 给当前用户添加目录读写权限 |
| API 提示余额不足 | 免费额度用尽 | 更换本地模型或充值 |
5. 实操心得与后续扩展
5.1 我实际用了两周后的感受
把 OpenClaw 跑起来只是一个开始,真正有价值的是让它融入日常工作流。我自己用了两周后,最大的感受是:它最擅长的并不是“聊出多惊艳的答案”,而是“老老实实把重复劳动做完”。比如每周整理项目周报,以前我要翻 5 个文档、复制粘贴 20 次;现在我只需要说一句“读取本周工作记录,按项目维度生成周报”,三分钟后就看到结果文件躺在 Obsidian 里。
省下来的时间,完全可以用在真正需要判断力的事情上。但我必须提醒一句:OpenClaw 不是万能的,它偶尔也会读错文件、调用错工具,尤其是模型能力不够强的时候。所以,重要文件提前备份,敏感操作别交给它自动执行,这个底线一定要守住。
5.2 还能玩什么:技能市场、ClawHub、n8n 联动
如果你已经不满足于基础对话,可以看看 OpenClaw 的 Skill 市场和 ClawHub。ClawHub 是 OpenClaw 的技能分享平台,相当于“手机应用商店”,里面有人上传了各种现成技能:日报生成、邮件起草、网页内容抓取、飞书消息推送等等。安装技能只需一行:
bash复制openclaw skill install 技能名
此外,把 OpenClaw 和 n8n 这种自动化工作流工具联动,可以玩出更夸张的效果。比如 n8n 负责监听某个文件夹的新文件,一旦发现新文件,就调用 OpenClaw 自动处理并把结果发送到飞书群。这类场景适合有半自动化需求的小团队,前期搭好之后,后面几乎不需要人工干预。
另一个方向是配合 NVIDIA NIM 使用。如果你手头有 NVIDIA 显卡,可以拉取 NIM 容器来运行企业级模型,OpenClaw 里直接配置 NIM 的推理地址就行。这个方案的性能比普通 Ollama 更稳,适合想要“本地私有化部署”但又不想牺牲速度的进阶玩家。
5.3 最后再分享一个小技巧
我最后的建议可能和很多教程不一样:别一次性把所有功能都装齐。先用最基础的方式把 OpenClaw 跑起来,跑通一个简单任务,比如“让它帮我重命名一批文件”,然后慢慢增加模型、增加技能、增加外部应用。
我见过太多新手因为一上来就想做到“全自动”,结果卡在配置和报错上,最后直接放弃。OpenClaw 这类工具的本质是“让 AI 自动干活”,但它也需要你和它建立一种互相理解的工作方式。今天先用一两分钟把环境跑通,明天再加一个 Skill,一周之后你会发现自己已经离不开它了。
我自己也是从“一个小白抄命令”的状态一路踩坑过来的,所以文章中写的每一条报错和处理方式,都是真实经历过、确认有效之后才放上来的。希望这篇内容能帮你少走几个月的弯路,晚上七点开始折腾,八点就能用它干活,这才是“秒速部署”该有的样子。
