OpenClaw 全攻略：从入门到精通的 AI 智能体部署指南

第一部分：认知篇 —— 什么是 OpenClaw？

1.1 定义与定位
OpenClaw（原名 Clawdbot / Moltbot）是一个本地优先、隐私至上、多渠道集成的自托管 AI 助手平台。它标志着人工智能从“对话式交互”迈入“自主行动”的第三阶段。

通俗理解：

传统 AI（如网页版 ChatGPT）：你问一句，它答一句，像个顾问。

OpenClaw：你给它一个目标（如“帮我整理本月财报并发送给团队”），它能自己规划步骤、搜索数据、处理文件、发送邮件，像个员工。

1.2 核心架构：App、Gateway 与 CLI
要玩转 OpenClaw，必须理解它的三个核心组件：

Gateway（网关）：真正的中枢。负责承接模型调用、工具连接、会话状态和本地配置。它是大脑与手脚的连接点。

App（桌面应用）：稳定入口。主要用于申请系统权限、查看运行状态和线程交互。

CLI（命令行）：操作界面。用于初始化配置、健康检查、安装技能和调试。

1.3 为什么是“空壳框架”？
OpenClaw 本身只提供执行逻辑，不具备具体的功能。它的强大完全依赖于 Skills（技能插件）。没有技能的 OpenClaw 只是一个“智障聊天机器人”，装对技能才是“AI 员工”。

第二部分：准备篇 —— 环境与选型

2.1 硬件与系统要求
操作系统：Windows 11、macOS 12+、Linux（Ubuntu 22.04+ 推荐）。

内存：最低 2GB，强烈推荐 4GB 以上（尤其是在运行浏览器自动化技能时）。

核心依赖：Node.js 22.x 或更高版本（必须，低于此版本会安装失败）。

2.2 部署方案选型
根据你的使用场景选择方案：

部署方案核心优势适用场景维护成本
本地部署零费用、数据私有、响应快个人办公、短期任务、功能测试中（需保持电脑开机）
云服务器部署7×24小时运行、多设备访问、公网接入店铺托管、批量任务、团队协作低（云厂商运维）
新手建议：先在本地（Win/Mac）用 QuickStart 模式跑通，熟悉后再迁至云端。

第三部分：部署篇 —— 2026 全平台实战

3.1 本地部署（Windows / macOS / Linux）
方法一：一键安装脚本（推荐新手）
这是官方最推荐的方式，自动检测并安装 Node.js 环境。

macOS / Linux：

bash
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（管理员模式 PowerShell）：

powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
方法二：手动安装（适合有 Node.js 环境的用户）
配置国内镜像（加速下载）：

bash
npm config set registry https://registry.npmmirror.com
全局安装 OpenClaw：

bash
npm install -g openclaw@latest
初始化配置：

bash
openclaw onboard –install-daemon
这一步会进入交互式配置，关键选择如下：

模式：选择 QuickStart。

模型：推荐选择 Moonshot AI (Kimi) 或 Qwen（国内用户友好）。

API Key：输入从 Kimi 或阿里云百炼平台获取的 Key。

聊天载体：新手先选 Skip，使用内置的 TUI 测试。

网络搜索：选择对应的搜索 API（如 Kimi 搜索或 Tavily）。

验证部署：
启动网关并访问 Web 控制台：

bash
openclaw gateway start
浏览器打开 http://127.0.0.1:18789，输入生成的 Token 即可看到 Dashboard。

3.2 云服务器部署（以阿里云为例）
云端部署适合需要 24 小时在线的任务。

购买服务器：

进入阿里云轻量应用服务器购买页。

镜像选择：应用镜像 -> OpenClaw (Moltbot) 2026 官方镜像。

地域选择：建议选美国（弗吉尼亚）或中国香港，避免国内网络限制导致的联网搜索功能受限。

配置：内存必须 ≥2GiB。

配置防火墙：

在服务器控制台放行端口：18789（核心端口）和 8080（WebUI）。

配置大模型 API（阿里云百炼）：

访问阿里云百炼控制台，开通服务并创建 API Key。

在服务器应用详情页，点击“一键配置”，填入 API Key。

获取访问地址：

执行命令生成 Token，点击“打开网站页面”即可开始使用。

第四部分：技能篇 —— 让 OpenClaw 真正干活

核心原则：先装 Skill-Vetter 做安检，再装其他技能；任何新技能必先扫描再使用。

4.1 必装的四大核心技能

安装：npx clawhub@latest install skill-vetter

使用：clawhub scan –all（扫描所有已装技能）

安装：npx clawhub@latest install find-skills-skill

使用：clawhub find 办公自动化（搜索相关技能）

前置：注册 Tavily 获取免费 API Key。

配置：

bash
export TAVILY_API_KEY=“tvly-你的Key”
使用：clawhub run tavily-search “今天的科技新闻”

安装：npx clawhub@latest install browser-use

使用：clawhub run browser-use –task “登录OA系统下载本月报表”

4.2 技能通用管理命令
安装流程：npx clawhub@latest install <技能名> -> openclaw restart -> clawhub list。

卸载：clawhub uninstall <技能名>。

第五部分：进阶篇 —— 集成与自动化

5.1 接入钉钉 / 飞书
OpenClaw 支持接入即时通讯软件，变成群里的“数字员工”。

安装插件：openclaw plugins install @openclaw/dingtalk-connector（以钉钉为例）。

配置凭证：

在钉钉开放平台创建应用，获取 Client ID 和 Client Secret。

编辑配置文件 ~/.openclaw/openclaw.json，填入凭证并设置 channel 类型为 dingtalk。

启动与测试：

重启网关：openclaw gateway restart。

在钉钉群里 @机器人 即可下达指令。

5.2 大模型 API 配置指南
阿里云千问（Qwen）：

bash
openclaw config set models.providers.qianwen.apiKey=你的Key
openclaw config set models.providers.qianwen.baseUrl=https://dashscope.aliyuncs.com/compatible-mode/v1
Kimi（Moonshot）：
在初始化时选择 .cn 接入点，填入平台生成的 Key。

免费方案：可使用 MiniMax 或智谱 GLM 的免费额度进行测试。

5.3 科研辅助实战案例
OpenClaw 可以辅助完成复杂的科研任务，例如：

文献检索：通过 QQ/钉钉发送指令“搜索 2026 年大模型相关的顶会论文”。

自动下载：OpenClaw 调用 Scholar-Search-Skill，下载 PDF 到指定目录。

发送邮件：自动将下载的论文打包发送到指定邮箱。

撰写综述：指令“根据下载的文献，写一份 2000 字的研究综述”，OpenClaw 生成 Word 文档发回。

第六部分：避坑与维护

6.1 常见故障排查
端口未对齐：

现象：界面可开，但会话不通。

解决：检查 App 连接的端口（默认 18789）与 CLI 和 Gateway 是否一致。

命令未找到：

现象：终端提示 openclaw: command not found。

解决：将 npm 全局包路径加入 PATH：

bash
export PATH=“$(npmprefix-g)/bin:$PATH”
国内网络超时：

解决：配置 npm 镜像 npm config set registry https://registry.npmmirror.com。

钉钉签名验证失败：

解决：检查系统时间是否同步（NTP），确认加密 Key 正确。

6.2 安全红线
权限最小化：不要给 OpenClaw 根目录的读写权限，限制其访问范围。

隔离环境：建议在虚拟机或 Docker 中运行敏感任务。

定期审计：每季度轮换 API Key，检查技能来源。

6.3 性能调优
对于高并发场景（如企业客服），可调整 config.json 中的参数：

json
{
“worker_threads”: 4, // 设为 CPU 核心数的 1.5 倍
“message_queue_size”: 1000
}

结语

至此，你已经完成了从零基础到进阶应用的 OpenClaw 全攻略学习。核心总结三点：

先跑通链路：把 App、Gateway、CLI 三者协作跑顺，不要急于追新插件。

技能为王：装对 4 个核心技能（安检、搜索、找技能、自动化），解决 80% 的需求。

安全第一：所有第三方技能必经 Skill-Vetter 扫描。