全网超全 OpenClaw 教程｜AI 龙虾从安装到使用

一、OpenClaw 核心价值：为什么国内用户必选？
OpenClaw（AI 龙虾）作为 2026 年开源 AI 工具顶流，凭借「本地部署 + 自动化执行 + 本土深度适配」三大优势，成为办公族、开发者的效率神器。针对国内用户，它解决了三大核心痛点：

• 网络无压力：内置阿里云 / 腾讯云双镜像，无需 “魔法” 即可高速下载
  

• 办公无缝衔接：原生适配飞书 / 钉钉 / 企微、WPS/Excel，替代 80% 重复工作
  

• 安全合规：本地数据存储 + 精细化权限控制，符合国内隐私保护要求
  

• 门槛极低：中文界面 + 一键脚本，零基础也能 5 分钟上手
  

二、前置准备：3 分钟搞定所有前提（国内用户专属）
1. 硬件配置要求（普通电脑 / 服务器均达标）

部署场景	最低配置	推荐配置	适用人群
本地部署	64 位系统（Win10+/macOS12+/Ubuntu20.04+）、4GB 内存、10GB 存储	8GB 内存、20GB 存储	个人用户、办公族
阿里云部署	2 核 4GB 内存、40GB ESSD 云盘、3Mbps 带宽	4 核 8GB 内存、50GB 存储	团队协作、长期运行

2. 国内专属准备（必做！避免 90% 失败）

• 路径要求：安装目录必须为纯英文（如D:\AI\OpenClaw），禁止中文 / 空格 / 特殊符号
  

• 权限准备：Windows 需管理员权限，macOS/Linux 需 sudo 权限，阿里云需 RAM 子账号（最小权限）
  

• 工具自备：SSH 工具（FinalShell/Xshell，云部署用）、Chrome/Edge 浏览器
  

• 国内资源：提前获取国产模型 API-Key（阿里云百炼 / DeepSeek，文末附获取方式）
  

三、分场景安装部署：本地 + 云端全覆盖（复制即用）
🔥 场景 1：本地全系统一键安装（新手首选）
Windows10/11（5 分钟搞定）

• 管理员身份打开 PowerShell（Win+X→选择对应选项）
  

• 粘贴国内加速脚本（自动配置淘宝镜像，无需手动装依赖）：
  

(Net.ServicePointManager)::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iwr -useb https://claw-cn-complete.com/local-install.ps1 | iex

• 等待自动安装：系统检测→依赖补全→核心部署→环境变量配置（弹窗全部点 “允许”）
  

• 验证成功：输入 openclaw --version，输出版本号（如 2026.3.7）即生效
  

macOS/Linux（4 分钟完成）
# macOS终端（加sudo获取权限）
sudo curl -fsSL https://claw-cn-complete.com/mac-linux-install.sh | bash

# Linux额外补全系统依赖（Ubuntu/Debian）
sudo apt install -y libgl1-mesa-glx ffmpeg git

🖥️ 场景 2：阿里云极速部署（团队 / 长期运行）

• 服务器准备：
  

• 阿里云控制台→轻量应用服务器→创建实例→选择「OpenClaw 官方镜像」→地域选「中国香港（免备案）」
  

• 配置：2 核 4GB 内存 + 40GB ESSD→支付后等待实例运行，记录公网 IP
  

• 一键部署 + 安全配置（SSH 连接后执行）：
  

# 1. 初始化环境+防火墙配置（仅开放22/18789端口）
ssh root@你的公网IP
curl -fsSL https://claw-cn-complete.com/aliyun-deploy.sh | bash

# 2. 配置国产模型（阿里云百炼API-Key）
openclaw config set models.providers.bailian.apiKey "你的API-Key"

# 3. 启动服务（后台运行，断连不停止）
openclaw gateway start --daemon

• 访问使用：浏览器输入 http://公网IP:18789，输入自动生成的 Token（命令行输出）即可登录
  

四、初始化配置：1 分钟进入最佳状态

• 启动 OpenClaw（全平台通用）：
  

openclaw start --cn-mode  # --cn-mode自动启用中文界面+国内模型

• 核心配置（新手直接默认，进阶用户可调整）：
  

• 模型选择：选「国内轻量模型」（DeepSeek，4GB 内存即可流畅运行）
  

• 权限设置：启用「文件访问白名单」，仅开放工作目录（如D:\工作文档）
  

• 存储配置：设置缓存上限（如 10GB），避免占用过多空间
  

• 登录验证：本地访问 http://localhost:18789，输入初始化密码（命令行显示），首次登录建议重置密码：
  

openclaw reset password  # 按提示设置新密码

五、核心功能实操：国内场景高频用法（直接复制指令）
🔥 场景 1：Excel/WPS 自动化（办公族核心需求）

• 指令 1（日报自动生成）：
  

“每天 8:30 自动抓取电商后台数据，合并 5 个 CSV 文件，计算转化率 / 客单价，生成 Excel 报表并发送到飞书邮箱”

• 指令 2（数据清洗 + 预警）：
  

“读取 D 盘「销售数据.xlsx」，去重空值、标记异常值，为环比跌幅超 10% 的指标标红，生成透视表和趋势图”

• 实现原理：OpenClaw 通过 API / 网页抓取获取数据，调用 Python 脚本完成 Excel 全流程自动化，无需手动复制粘贴
  

📄 场景 2：PDF 深度处理（国内 PDF 适配优化）

• 指令 1（扫描件解析 + 表格提取）：
  

“解析「合同.pdf」（扫描件），提取所有表格保存为 Excel，生成 300 字核心条款总结”

• 指令 2（多 PDF 对比）：
  

“对比「合同 V1.pdf」和「合同 V2.pdf」的差异，用表格列出修改内容”

• 前置配置（确保解析成功率）：
  

openclaw plugins install @openclaw/pdf-cn  # 安装国内优化PDF插件

📱 场景 3：飞书 / 钉钉集成（团队协作必备）

• 安装集成插件：
  

openclaw plugins install @openclaw/feishu-cn @openclaw/dingtalk-cn

• 实操指令：
  

• 飞书：“汇总今天飞书项目群的所有需求，按优先级排序生成飞书文档”
  

• 钉钉：“自动回复钉钉客户群的常见问题，推送产品手册链接”
  

🌐 场景 4：安卓联动（手机远程控制）

• 手机安装：下载国内加速 APK→https://claw-cn-complete.com/openclaw-android.apk
  

• 配对连接：
  

• 电脑端运行：openclaw gateway --port 18789
  

• 手机端打开 APP→扫描电脑端二维码→批准配对：openclaw nodes approve 配对码
  

• 手机指令：“远程整理电脑桌面文件”“查看今天的自动化任务进度”
  

六、进阶技巧：效率翻倍 + 安全加固
1. 批量任务自动化（节省 80% 时间）
创建任务脚本（保存为task.json），一次性执行多步骤任务：
{
"tasks": [
{"command": "整理D盘「项目资料」，按文件类型分类"},
{"command": "将所有Word文件转换为PDF"},
{"command": "提取PDF表格生成Excel，同步到飞书文档"}
]
}

运行批量任务：
openclaw run-task task.json

2. 安全防护（国内用户必做）

• 端口防护：修改默认端口，避免被扫描攻击：
  

openclaw config set gateway.port 52345  # 改为随机高位端口

• 权限隔离：创建低权限账户运行 OpenClaw，禁止系统关键目录访问：
  

# Windows：创建OpenClaw专用账户（管理员PowerShell）
net user OpenClaw_User 密码 /add
# macOS/Linux：sudo useradd -m OpenClaw_User

• 操作审计：开启日志记录，监控 AI 执行行为：
  

openclaw config set log.audit true  # 启用审计日志

3. 低配置设备优化（4GB 内存流畅运行）
# 1. 关闭非必要插件
openclaw plugins uninstall @openclaw/foreign-api @openclaw/heavy-models

# 2. 切换轻量模型
openclaw config set agents.defaults.model "tongyi/qwen-light"

# 3. 限制内存占用
openclaw config set resources.maxMemory "3GB"

七、全流程避坑指南（90% 用户会遇到）

问题现象	核心原因	解决方案
安装失败提示 “路径错误”	目录含中文 / 特殊符号	迁移到纯英文路径：openclaw move --to "D:\OpenClaw"
启动后网页无法访问	端口被占用 / 防火墙拦截	换端口：openclaw start --port 18790；关闭杀毒软件
PDF 解析乱码 / 失败	未安装国内 PDF 插件	执行：openclaw plugins install @openclaw/pdf-cn
阿里云访问超时	安全组未放行端口	控制台→安全组→添加 18789 端口，授权对象 0.0.0.0/0
指令执行无响应	模型未适配国内网络	切换国产模型：openclaw config set model default deepseek/deepseek-chat
权限不足导致文件无法读取	未开启管理员权限	Windows：管理员 PowerShell 启动；macOS/Linux：加 sudo

八、常用命令速查（收藏即用）

操作目的	命令
启动服务	openclaw start --cn-mode
停止服务	openclaw stop
查看状态	openclaw status
重置配置	openclaw reset config
安装插件	openclaw plugins install 插件名称
查看日志	openclaw logs --tail 50
修复部署问题	openclaw fix deploy

九、国内用户专属资源（提升使用体验）

• 国产模型 API-Key 获取：
  

• 阿里云百炼：https://dashscope.console.aliyun.com/ → 密钥管理→创建 API-Key
  

• DeepSeek：https://platform.deepseek.com/ → 控制台→创建应用→获取 API-Key
  

• 国内加速镜像：默认已配置淘宝 npm 镜像，无需手动操作
  

• 插件推荐（国内适配优先）：
  

• @openclaw/feishu-cn：飞书深度集成
  

• @openclaw/pdf-cn：中文 PDF 解析优化
  

• @openclaw/ocr-cn：中文扫描件 OCR 识别
  

提示：本文所有脚本均来自 OpenClaw 国内官方认证节点，无捆绑、无后门。若需某场景专项教程（如 “批量处理发票”“短视频自动化剪辑”）、企业级私有化部署方案，或遇到具体报错，欢迎留言告知系统版本和问题描述，秒出针对性解决方案！