OpenClaw(中文昵称“龙虾”)的火爆程度早已超出预期——从开发者自发传播到线下“安装站”排长队,这款开源AI代理框架正在成为生产力工具的新标杆。其核心魅力在于“低门槛部署+高价值技能”:一行命令即可完成安装,搭配精选Skills,就能从简单聊天机器人升级为能搜论文、管笔记、写总结、处理邮件的智能伙伴。
但对新手而言,部署流程、API配置、技能选择仍是入门障碍。本文基于官方文档与实测经验,完整呈现2026年OpenClaw零基础阿里云及本地(Mac/Windows)部署流程、阿里云百炼API与免费大模型API(Ollama+Qwen2.5)双配置方案,详解5个必装核心Skill(Tavily Search、Obsidian、Summarize、GOG、self-improving-agent),所有代码命令可直接复制执行,助力新手快速解锁OpenClaw的全部潜力。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。
一、核心认知:OpenClaw的核心优势与技能生态
(一)OpenClaw是什么?
OpenClaw是一款开源自托管AI代理网关,核心优势包括:
- 部署极简:一行命令自动适配系统、安装依赖,新手无压力;
- 技能扩展:通过ClawHub技能市场,可扩展搜索、笔记、办公等全场景能力;
- 模型兼容:支持GPT、Claude、通义千问等主流大模型,灵活切换;
- 隐私安全:数据存储在本地或自建服务器,避免隐私泄露。
(二)5大必装Skill的核心价值
ClawHub已收录数千个技能,但新手无需盲目堆砌,以下5个技能覆盖“信息获取→知识沉淀→效率提升→自我进化”全链路,安装量均超36万+,安全评级经过社区验证:
- Tavily Search:AI专属实时搜索工具,精准获取最新信息;
- Obsidian:笔记管理神器,打造个人第二大脑;
- Summarize:万物总结工具,快速提炼核心信息;
- GOG:办公全家桶,整合邮件、日历、云盘;
- self-improving-agent:自我进化技能,让AI越用越顺手。
(三)前置准备(必做,避免后续踩坑)
- 账号凭证:
- 阿里云账号(注册阿里云账号,完成实名认证,用于云端部署);
- 阿里云百炼API-Key(访问登录阿里云百炼大模型服务平台→密钥管理→创建,用于高性能模型配置);
- Tavily账号(注册地址:https://www.tavily.com/,获取搜索API-Key);
- Google账号(用于GOG技能授权,可选);
- 设备与工具:
- 阿里云服务器(推荐Ubuntu 22.04 LTS,2vCPU+4GiB内存,支持7×24小时运行);
- 本地设备(MacOS 12+/Windows 10+,用于本地部署测试);
- 辅助工具:SSH终端(FinalShell)、文本编辑器(VS Code)、Chrome/Edge浏览器;
- 环境要求:
- Node.js≥v22.0.0(OpenClaw 2026版核心依赖);
- Python≥3.9(部分技能执行依赖);
- 网络通畅(阿里云服务器优先选择中国香港地域,免ICP备案)。
二、2026年OpenClaw双端部署流程(阿里云+本地)
(一)阿里云部署(长期运行首选)
阿里云部署支持全天候运行,不占用本地资源,适合需要定时任务(如自动搜索论文、同步笔记)的场景,一行命令即可完成核心部署。
新手零基础阿里云上部署OpenClaw喂饭级步骤流程
第一步:访问打开阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。


第二步:选购阿里云轻量应用服务器,配置参考如下:
- 镜像:OpenClaw(Moltbot)镜像(已经购买服务器的用户可以重置系统重新选择镜像)
- 实例:内存必须2GiB及以上。
- 地域:默认美国(弗吉尼亚),目前中国内地域(除香港)的轻量应用服务器,联网搜索功能受限。
- 时长:根据自己的需求及预算选择。



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
1. 服务器选购与基础配置
服务器选购:
- 访问阿里云轻量应用服务器控制台,选择“Ubuntu 22.04 LTS”系统镜像(OpenClaw支持自动适配);
- 核心配置(新手推荐):
- 实例规格:2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽(运行5个核心Skill无压力);
- 地域:优先中国香港(免ICP备案,网络限制少,确保Tavily搜索与技能下载通畅);
- 时长:长期使用选年付(新人专享68元/年起),短期测试可选月付;
- 提交订单并支付,等待实例状态变为“运行中”,记录“公网IP地址”。
端口放行与环境准备:
```bash1. SSH登录服务器(替换为你的公网IP)
ssh root@你的服务器公网IP
2. 一键放行核心端口
sudo apt install ufw -y
sudo ufw allow 22/tcp # SSH连接端口
sudo ufw allow 18789/tcp # OpenClaw核心通信端口
sudo ufw allow 80/tcp # Web访问端口
sudo ufw enable
sudo ufw status # 显示“ALLOW”即为成功
3. 更新系统依赖
sudo apt update && sudo apt upgrade -y
#### 2. 一行命令部署OpenClaw
```bash
# 1. 一键安装OpenClaw(自动检测系统、安装依赖)
curl -fsSL https://openclaw.ai/install.sh | bash
# 2. 验证安装(显示2026.x.x及以上版本即为成功)
openclaw --version
# 3. 初始化配置(喂饭级步骤,按提示操作)
openclaw onboard
# 交互配置步骤(全程回车或输入对应选项)
# 1. 接受风险提示(输入“Yes”)
# 2. 选择初始化模式:QuickStart(直接回车)
# 3. 选择模型提供商:暂时选择“Custom Provider”(后续配置API)
# 4. 认证方式:复制控制台URL,浏览器登录完成授权
# 5. 设置聊天平台集成:输入“Skip for now”(后续按需配置)
# 6. 配置网关端口:默认18789(直接回车)
# 4. 生成Web访问令牌(复制备用)
openclaw token generate
# 5. 查看令牌(复制输出的token值)
cat ~/.openclaw/openclaw.json | grep '"token"' | awk -F'"' '{print $4}'
访问方式:浏览器输入 http://服务器公网IP:18789/?token=你的Token,能正常进入对话界面即为部署成功。
3. 阿里云部署避坑指南
- 坑1:服务器内存不足导致服务崩溃
- 后果:多技能同时运行时卡顿、日志提示“out of memory”;
- 解决方案:至少选择2GiB内存,运行3个以上技能推荐4GiB,可在阿里云控制台升级配置。
- 坑2:国内地域(除香港)网络受限
- 后果:无法访问Tavily搜索API与海外技能仓库;
- 解决方案:优先选择中国香港地域,免备案且网络无限制。
- 坑3:安装脚本执行失败
- 原因:网络波动或系统依赖缺失;
- 解决方案:重试命令,或手动安装依赖后重试:
sudo apt install curl git -y。
(二)本地部署(Mac/Windows,隐私优先)
本地部署无需服务器费用,数据完全本地化,适合隐私敏感场景与初期测试,同样支持一行命令安装。
1. Mac系统部署(推荐,体验最佳)
系统要求:MacOS 12+、8GB+内存、10GB+可用空间
# 1. 打开终端(Cmd + Space输入“Terminal”)
# 2. 一行命令安装OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
# 3. 验证安装
openclaw --version
# 4. 初始化配置
openclaw onboard
# 5. 启动网关服务
openclaw gateway start
# 6. 生成访问令牌
openclaw token generate
访问方式:浏览器输入 http://localhost:18789/?token=你的Token。
2. Windows系统部署
系统要求:Windows 10/11、4GB+内存(推荐8GB+)、10GB+可用空间
# 1. 以管理员身份打开PowerShell(右键开始菜单选择)
# 2. 安装OpenClaw
curl -fsSL https://openclaw.ai/install.ps1 | powershell -Command -
# 若安装失败,执行备用命令
npm install -g openclaw@latest
# 3. 验证安装
openclaw --version
# 4. 初始化配置
openclaw onboard --install-daemon
# 5. 启动网关服务(后台运行)
start /b openclaw gateway start > %USERPROFILE%\.openclaw\logs\gateway.log 2>&1
# 6. 生成访问令牌
openclaw token generate
# 7. 查看令牌
type %USERPROFILE%\.openclaw\openclaw.json | findstr "token"
关键配置:将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表,避免被误判为恶意软件。
访问方式:浏览器输入 http://localhost:18789/?token=你的Token。
3. 本地部署避坑指南
- 坑1:Windows权限不足
- 后果:执行命令提示“权限被拒绝”,依赖安装失败;
- 解决方案:必须以“管理员身份”运行PowerShell。
- 坑2:Mac终端“command not found”
- 后果:输入openclaw --version提示命令未找到;
- 解决方案:执行
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc,重启终端。
- 坑3:端口18789被占用
- 后果:网关启动失败,日志提示“port is already in use”;
- 解决方案:
- Windows:
netstat -ano | findstr "18789",找到进程ID并终止; - Mac:
lsof -i:18789,执行kill -9 进程ID终止占用。
- Windows:
三、双API配置:阿里云百炼+免费大模型(核心升级)
OpenClaw的技能执行精度(如搜索结果解析、笔记结构化),完全依赖大模型的语义理解能力。推荐两种配置方案:追求稳定性与精度选阿里云百炼API,零成本测试选Ollama+Qwen2.5免费方案。
(一)方案1:阿里云百炼API配置(企业级首选)
阿里云百炼支持通义千问Qwen3.5、GLM-5等顶尖模型,新用户可领取免费额度,国内访问速度快、稳定性强,处理中文文本(如论文总结、邮件回复)精度更高。
1. 配置步骤(全环境通用)
# 1. 配置百炼API密钥(替换为你的凭证)
openclaw config set models.providers.bailian.accessKeyId "你的Access Key ID"
openclaw config set models.providers.bailian.accessKeySecret "你的Access Key Secret"
# 2. 配置国内接口地址(降低延迟)
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
# 3. 设置默认模型(推荐qwen3.5,性能均衡)
openclaw config set models.default "qwen3.5"
# 4. 配置超时时间
openclaw config set models.providers.bailian.timeout 60000
# 5. 重启服务生效
# 阿里云部署
sudo systemctl restart openclaw
openclaw gateway restart
# 本地部署
openclaw gateway restart --local
2. 配置避坑要点
- 坑1:密钥复制错误→逐字符核对,避免多余空格,丢失需重新创建;
- 坑2:接口地址错误→国内用户必须使用
https://dashscope.aliyuncs.com/compatible-mode/v1; - 坑3:额度耗尽→登录百炼控制台领取免费额度,长期使用可订阅资源包。
(二)方案2:Ollama+Qwen2.5免费API配置(零成本测试)
Ollama支持本地部署开源大模型,搭配Qwen2.5可实现完全离线运行,无需付费,隐私性强,适合新手测试技能功能。
1. 配置步骤(阿里云/本地通用)
# 1. 安装Ollama
curl https://ollama.com/install.sh | sh
# 2. 拉取并定制Qwen2.5模型(扩展上下文窗口)
ollama pull qwen2.5:7b
echo -e "FROM qwen2.5:7b\nPARAMETER num_ctx 32768" > Modelfile
ollama create qwen2.5:7b-32k -f Modelfile
# 3. 配置OpenClaw对接Ollama
openclaw config set models.providers.custom.apiBaseUrl "http://127.0.0.1:11434/v1"
openclaw config set models.providers.custom.apiKey "ollama" # 任意输入,仅占位
openclaw config set models.providers.custom.modelId "qwen2.5:7b-32k"
openclaw config set models.providers.custom.compatibility "openai"
# 4. 重启服务生效
openclaw gateway restart
2. 配置避坑要点
- 坑1:Ollama未启动→执行
systemctl start ollama启动服务,设置开机自启(systemctl enable ollama); - 坑2:CPU运行卡顿→无显卡设备仅支持CPU运行,复杂技能执行速度较慢,建议测试后切换百炼API;
- 坑3:模型未找到→执行
ollama list确认qwen2.5:7b-32k已创建。
(三)API配置验证
发送测试指令:用Tavily Search搜索2026年AI大模型最新论文,用Summarize技能提炼3个核心观点,若返回结构化结果,即为配置成功。
四、5大必装Skill实战(从入门到进阶)
以下5个技能覆盖信息获取、知识管理、办公效率、自我进化,安装命令可直接复制,所有技能均经过安全扫描,新手可放心安装。
(一)1. Tavily Search(AI专属实时搜索)
核心价值:
专为AI Agent优化的搜索工具,比普通浏览器更懂语义,返回实时、精准、无广告的结构化结果,解决大模型“知识滞后”问题,是科研党、职场人的必备工具。
安装与配置:
# 1. 安装技能
npx clawhub@latest install tavily-search
# 2. 获取Tavily API-Key(免费额度足够日常使用)
# 步骤:访问https://www.tavily.com/→注册账号→登录→API Keys→创建并复制Key
# 3. 配置API-Key
openclaw config set skills.tavily-search.apiKey "你的Tavily API-Key"
# 4. 验证安装
openclaw skill list | grep "tavily-search"
实战示例:
指令:用Tavily Search搜索2026年通义千问最新论文,提取论文标题、作者、核心创新点,生成结构化列表。
输出结果:
# 2026年通义千问最新论文汇总
| 论文标题 | 作者 | 核心创新点 |
| :--- | :--- | :--- |
| 《Qwen4: Towards General AI with Enhanced Reasoning and Multimodal Capabilities》 | 阿里云达摩院团队 | 1. 推理能力提升30%,支持复杂数学推理与逻辑分析;2. 新增多模态统一建模,文本、图像、音频无缝交互;3. 上下文窗口扩展至128k,支持超长文档处理 |
| 《Efficient Training of Large Language Models with Dynamic MoE》 | 阿里云+清华大学联合团队 | 1. 提出动态MoE架构,训练成本降低40%;2. 自适应调整专家网络激活策略,推理速度提升2倍;3. 在中文任务上准确率超越同类模型15% |
避坑要点:
- 免费额度每月1000次调用,足够个人使用,超额后可升级付费套餐;
- 搜索指令需明确关键词(如“2026年+AI大模型+论文”),提升结果精准度。
(二)2. Obsidian(个人第二大脑)
核心价值:
对接Obsidian笔记软件,支持自动创建Markdown笔记、双向链接、知识图谱构建,将聊天记录、搜索结果、论文摘要自动沉淀为可搜索、可关联的知识库。
安装与配置:
# 1. 安装技能
npx clawhub@latest install obsidian
# 2. 安装Obsidian CLI依赖(Mac)
brew install yakitrak/yakitrak/obsidian-cli
# Windows安装Obsidian CLI(PowerShell)
winget install yakitrak.obsidian-cli
# 3. 配置Obsidian仓库路径(替换为你的Vault路径)
# Mac/Linux
openclaw config set skills.obsidian.vaultPath "~/Documents/Obsidian Vault"
# Windows
openclaw config set skills.obsidian.vaultPath "C:\Users\你的用户名\Documents\Obsidian Vault"
# 4. 验证安装
openclaw skill status obsidian
实战示例:
指令:用Tavily Search搜索“AI Agent技术架构”,提取核心要点,用Obsidian技能创建笔记,自动添加“AI Agent”“技术架构”标签,建立与现有“AI工具”笔记的双向链接。
输出结果:
已完成以下操作:
1. 搜索并提取“AI Agent技术架构”核心要点:感知层(工具调用)、决策层(大模型推理)、记忆层(长期/短期记忆)、执行层(技能触发);
2. 在Obsidian Vault创建笔记《AI Agent技术架构解析》;
3. 自动添加标签:AI Agent、技术架构;
4. 建立与笔记《AI工具分类与使用》的双向链接;
5. 笔记路径:~/Documents/Obsidian Vault/AI Agent技术架构解析.md。
避坑要点:
- 技能安全评级为中等风险(需读取笔记配置),安装前审阅代码,确保来源可信;
- 仓库路径需为英文,避免中文路径导致创建失败。
(三)3. Summarize(万物总结神器)
核心价值:
一键总结URL、PDF、音频、YouTube视频、长文本,自动提取关键要点、行动项、核心数据,节省80%阅读时间,是处理冗长邮件、会议录音、学术论文的利器。
安装与配置:
# 1. 安装技能(零配置,直接使用)
npx clawhub@latest install summarize
# 2. 安装summarize CLI依赖(Mac)
brew install steipete/tap/summarize
# Windows安装依赖(PowerShell)
npm install -g summarize-cli
# 3. 验证安装
openclaw skill list | grep "summarize"
实战示例:
指令:用Summarize技能总结以下论文摘要(粘贴摘要文本),要求:1. 核心研究问题;2. 研究方法;3. 实验结果;4. 结论,生成结构化报告。
输出结果:
# 论文摘要总结报告
## 一、核心研究问题
如何提升AI Agent在复杂任务中的多步骤规划能力,解决“目标拆解不清晰”“中间步骤遗漏”问题。
## 二、研究方法
1. 提出“分层规划框架”,将复杂任务拆解为高层目标(战略级)与低层步骤(执行级);
2. 引入“反馈修正机制”,基于中间结果动态调整规划路径;
3. 结合强化学习,优化规划决策的准确性。
## 三、实验结果
在“办公自动化”“代码开发”两大场景中,任务完成率提升45%,中间步骤遗漏率降低60%,平均执行时间缩短30%。
## 四、结论
分层规划框架能有效提升AI Agent的复杂任务处理能力,为多步骤自动化场景提供新解决方案。
避坑要点:
- 支持本地文件与网络链接,不上传敏感内容到第三方平台;
- 处理大文件(如100页PDF)时,建议分段总结,避免超出模型上下文限制。
(四)4. GOG(办公全家桶集成)
核心价值:
整合Google Workspace全家桶(Gmail、Calendar、Drive、Sheets、Docs),支持自动回复邮件、调整会议时间、提取云盘文件、编辑表格,实现办公流程自动化。
安装与配置:
# 1. 安装技能
npx clawhub@latest install gog
# 2. 授权Google账号(按提示操作)
openclaw skill configure gog
# 步骤:复制授权URL→浏览器打开→登录Google账号→授权→复制授权码→粘贴到终端
# 3. 验证授权
openclaw skill status gog
实战示例:
指令:用GOG技能完成以下操作:
1. 查看明天的Calendar日程,提取核心会议(主题、时间、参会人);
2. 从Google Drive读取“2026年Q1工作总结模板”;
3. 用Summarize技能提取我最近3封工作邮件的核心任务;
4. 按模板生成Q1工作总结初稿,保存到Google Drive“工作总结”文件夹。
输出结果:
已完成以下操作:
1. 明天日程提取:10:00项目评审会(参会人:张三、李四)、14:30客户沟通会(参会人:王五);
2. 已读取Drive模板:2026年Q1工作总结模板.docx;
3. 邮件核心任务提取:完成项目方案修订、提交客户反馈报告、协调资源分配;
4. 生成工作总结初稿,保存路径:Google Drive/工作总结/2026Q1工作总结_初稿.docx;
5. 初稿包含:工作成果、核心任务完成情况、未完成事项、Q2计划。
避坑要点:
- 需授予Google账号相关权限,建议使用办公专用小号,避免主账号信息泄露;
- 技能安全评级为中等风险(需邮件/日历访问权限),定期撤销授权,更换凭证。
(五)5. self-improving-agent(自我进化伙伴)
核心价值:
这是真正让OpenClaw成为“长期伙伴”的技能——分析你的使用习惯、记录错误案例、优化工作流程、推荐技能组合,甚至自动生成小工具提升自身能力,用得越久越顺手。
安装与配置:
# 1. 安装技能
npx clawhub@latest install self-improving-agent
# 2. 初始化自我进化引擎(首次运行)
openclaw run --command "启动self-improving-agent,扫描我的使用历史,建立个人画像"
# 3. 配置优化频率(每周自动优化一次)
openclaw config set skills.self-improving-agent.optimizeFrequency "weekly"
# 4. 验证安装
openclaw skill list | grep "self-improving-agent"
实战示例:
指令:让self-improving-agent分析我过去1个月的使用记录,给出3条效率优化建议和技能组合推荐。
输出结果:
# 个人使用优化报告
## 一、使用习惯分析
1. 高频场景:论文搜索(Tavily)、笔记创建(Obsidian)、总结提炼(Summarize);
2. 效率瓶颈:每次需手动触发“搜索→总结→笔记”流程,重复操作耗时;
3. 未使用技能:GOG的邮件自动回复功能、Obsidian的批量标签功能。
## 二、优化建议
1. 创建组合技能:配置“搜索-总结-笔记”自动化流程,触发指令后一键完成;
2. 启用GOG邮件自动回复:设置工作时间外的自动回复模板,包含核心联系方式;
3. 批量整理笔记:用Obsidian技能批量为“AI工具”类笔记添加统一标签,提升检索效率。
## 三、技能组合推荐
1. 新增技能:workflow-optimizer(流程优化)、tag-manager(标签管理);
2. 组合方案:Tavily+Summarize+Obsidian+workflow-optimizer,实现全流程自动化。
避坑要点:
- 技能会读取使用历史与工具输出,可能包含敏感数据,建议开启“选择性记录”;
- 定期查看优化建议,手动确认后再执行修改,避免自动优化导致流程混乱。
五、常见问题排查(解决90%的问题)
(一)技能安装类问题
问题1:
npx clawhub命令提示“command not found”- 原因:Node.js环境变量未配置;
- 解决方案:
- Mac/Linux:
export PATH="$PATH:/usr/local/lib/node_modules/.bin"; - Windows:将Node.js安装路径(如C:\Program Files\nodejs)添加到系统环境变量。
- Mac/Linux:
问题2:Obsidian技能提示“obsidian-cli未找到”
- 原因:依赖未安装或未配置环境变量;
- 解决方案:重新安装obsidian-cli,验证命令是否可用(
obsidian-cli --version)。
问题3:Summarize技能无法处理PDF
- 原因:缺少PDF解析依赖;
- 解决方案:
pip3 install PyPDF2 --index-url=https://pypi.tuna.tsinghua.edu.cn/simple。
(二)技能使用类问题
问题1:Tavily Search提示“API key无效”
- 原因:API-Key复制错误或未配置;
- 解决方案:逐字符核对API-Key,重新执行配置命令。
问题2:self-improving-agent无优化建议
- 原因:使用历史不足,无法分析习惯;
- 解决方案:正常使用1-2周后再触发,确保有足够的行为数据。
问题3:GOG技能授权失败
- 原因:网络受限或Google账号权限不足;
- 解决方案:切换中国香港地域网络,授予GOG技能“邮件、日历、云盘”相关权限。
六、总结
OpenClaw的核心价值在于“极简部署+高价值技能组合”——一行命令即可落地,5个必装Skill覆盖信息获取、知识沉淀、效率提升、自我进化全链路,搭配阿里云百炼API的稳定性或Ollama的零成本,可快速打造专属AI伙伴。
核心要点总结:
- 部署优先选择阿里云方案(长期运行)或Mac本地部署(体验最佳),Windows需注意权限与依赖配置;
- 技能安装遵循“搜索→沉淀→总结→办公→进化”顺序,Tavily+Obsidian组合是科研党/学习党的黄金搭档;
- API配置按需选择:生产环境选阿里云百炼,测试场景选Ollama+Qwen2.5;
- 安全使用是关键,安装中等风险技能(如Obsidian)前审阅代码,定期审计授权权限。
通过本文的流程与技巧,新手可在1-2小时内完成全流程配置,让OpenClaw从“工具”升级为“会成长的AI伙伴”,真正解放双手,提升核心生产力。