什么是 OpenClaw？
OpenClaw（原名 Clawdbot / Moltbot）是一个本地优先、隐私至上且支持多渠道集成的自托管 AI 助手平台。它标志着人工智能从单纯的'对话式交互'迈向了'自主行动'的新阶段。
通俗来说，传统 AI 像顾问，你问一句它答一句；而 OpenClaw 更像员工，你给它一个目标（比如'整理本月财报并发送'），它能自己规划步骤、搜索数据、处理文件甚至发送邮件。
核心架构
要玩转 OpenClaw，理解这三个组件是关键：
- Gateway（网关）：真正的中枢，负责模型调用、工具连接、会话状态和本地配置，是连接大脑与手脚的接口。
- App（桌面应用）：稳定入口，用于申请权限、查看运行状态和线程交互。
- CLI（命令行）：操作界面，用于初始化配置、健康检查、安装技能和调试。
需要注意的是，OpenClaw 本身只提供执行逻辑，不具备具体功能。它的强大完全依赖于 Skills（技能插件）。没有技能的 OpenClaw 只是个聊天机器人，装对技能才是'AI 员工'。
环境准备与方案选型
硬件与系统要求
- 操作系统：Windows 11、macOS 12+ 或 Linux（推荐 Ubuntu 22.04+）。
- 内存：最低 2GB，建议 4GB 以上（尤其是运行浏览器自动化技能时）。
- 核心依赖：Node.js 22.x 或更高版本（低于此版本可能无法安装）。
部署方案
根据你的场景选择合适的方案：
- 本地部署：零费用、数据私有、响应快。适合个人办公、短期任务或功能测试。维护成本中等，需保持电脑开机。
- 云服务器部署：7x24 小时运行、多设备访问。适合店铺托管、批量任务或团队协作。维护成本低，由云厂商运维。
新手建议先在本地（Win/Mac）用 QuickStart 模式跑通流程，熟悉后再迁移至云端。
全平台实战部署
本地部署（Windows / macOS / Linux）
官方最推荐的方式是使用一键安装脚本，它会自动检测并安装 Node.js 环境。
macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（管理员模式 PowerShell）：
iwr -useb https://openclaw.ai/install.ps1 | iex
如果你已有 Node.js 环境，也可以手动安装。先配置国内镜像加速下载：
npm config set registry https://registry.npmmirror.com
然后全局安装 OpenClaw：
npm install -g openclaw@latest
初始化配置时输入命令进入交互式设置：
openclaw onboard --install-daemon
关键选择如下：
- 模式：选 QuickStart。
- 模型：推荐 Moonshot AI (Kimi) 或 Qwen（国内用户友好）。
- API Key：输入 Kimi 或阿里云百炼平台的 Key。
- 聊天载体：新手先选 Skip，使用内置 TUI 测试。
- 网络搜索：选择对应的搜索 API（如 Tavily）。
验证部署很简单，启动网关并访问 Web 控制台：
openclaw gateway start
浏览器打开 http://127.0.0.1:18789，输入生成的 Token 即可看到 Dashboard。
云服务器部署（以阿里云为例）
云端部署适合需要 24 小时在线的任务。
- 购买服务器：选择轻量应用服务器，镜像选'应用镜像 -> OpenClaw (Moltbot)'，地域建议选美国（弗吉尼亚）或中国香港以避免联网限制。内存必须 ≥2GiB。
- 配置防火墙：放行端口 18789（核心）和 8080（WebUI）。
- 配置大模型 API：在阿里云百炼控制台开通服务获取 Key，填入服务器应用详情页的一键配置中。
- 获取访问地址：执行命令生成 Token，点击'打开网站页面'即可开始使用。
技能篇 —— 让 OpenClaw 真正干活
核心原则：先装 Skill-Vetter 做安检，再装其他技能；任何新技能必先扫描再使用。
必装的四大核心技能
-
Skill-Vetter（安全安检员） 第一道防线，用于扫描恶意代码和风险权限，避免 API Key 泄露。
npx clawhub@latest install skill-vetter # 扫描所有已装技能 clawhub scan --all -
Find-Skills-Skill（技能搜索神器） 解决'不会找、找不对'的痛点，直接在终端搜索技能库。
npx clawhub@latest install find-skills-skill clawhub find 办公自动化 -
Tavily-Search（实时联网搜索） 赋予 AI 实时联网能力，返回结构化搜索结果和可信度评分。 前置注册 Tavily 获取免费 API Key，配置环境变量：
export TAVLY_API_KEY="tvly-你的Key"使用时直接运行：
clawhub run tavily-search "今天的科技新闻" -
Browser-Use / Office-Automation（网页与办公自动化） 让 OpenClaw 直接操控浏览器或处理文档，是'落地执行'的关键。
npx clawhub@latest install browser-use clawhub run browser-use --task "登录 OA 系统下载本月报表"
技能通用管理
- 安装：
npx clawhub@latest install <技能名>->openclaw restart->clawhub list - 卸载：
clawhub uninstall <技能名>
进阶篇 —— 集成与自动化
接入钉钉 / 飞书
OpenClaw 支持接入即时通讯软件，变成群里的'数字员工'。
- 安装插件：
openclaw plugins install @openclaw/dingtalk-connector - 配置凭证：在钉钉开放平台创建应用，获取 Client ID 和 Secret，编辑配置文件
~/.openclaw/openclaw.json，填入凭证并设置 channel 类型为 dingtalk。 - 启动测试：重启网关后，在钉钉群里 @机器人 即可下达指令。
大模型 API 配置
- 阿里云千问（Qwen）：
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 的免费额度进行测试。
科研辅助实战案例
OpenClaw 可以辅助完成复杂的科研任务，例如：
- 文献检索：通过 QQ/钉钉发送指令'搜索 2026 年大模型相关的顶会论文'。
- 自动下载：调用 Scholar-Search-Skill，下载 PDF 到指定目录。
- 撰写综述：指令'根据下载的文献，写一份 2000 字的研究综述'，OpenClaw 生成 Word 文档发回。
避坑与维护
常见故障排查
- 端口未对齐：现象是界面可开但会话不通。检查 App 连接的端口（默认 18789）与 CLI 和 Gateway 是否一致。
- 命令未找到：终端提示
openclaw: command not found。将 npm 全局包路径加入 PATH：export PATH=$(npm config get prefix)/bin:$PATH - 国内网络超时：配置 npm 镜像
npm config set registry https://registry.npmmirror.com。 - 钉钉签名验证失败：检查系统时间是否同步（NTP），确认加密 Key 正确。
安全红线
- 权限最小化：不要给 OpenClaw 根目录的读写权限，限制其访问范围。
- 隔离环境：建议在虚拟机或 Docker 中运行敏感任务。
- 定期审计：每季度轮换 API Key，检查技能来源。
性能调优
对于高并发场景（如企业客服），可调整 config.json 中的参数：
{
"worker_threads": 4,
"message_queue_size": 1000
}
结语
至此，你已经完成了从零基础到进阶应用的 OpenClaw 学习。核心总结三点：
- 先跑通链路：把 App、Gateway、CLI 三者协作跑顺，不要急于追新插件。
- 技能为王：装对 4 个核心技能（安检、搜索、找技能、自动化），解决 80% 的需求。
- 安全第一：所有第三方技能必经 Skill-Vetter 扫描。