全网最全！GitHub 30万星 AI 神器 OpenClaw 保姆级部署教程

OpenClaw 是 GitHub 上最受欢迎的个人 AI 助手开源框架（309,000 Stars），可在 WhatsApp、Telegram、Slack、Discord、iMessage 等 20+ 渠道中接入 AI 能力，实现跨平台统一管理。本教程分为四个阶段——安装配置 → 渠道接入 → 技能与工具 → 进阶自动化——从零开始手把手完成 OpenClaw 全功能部署，并覆盖每个阶段最常见的坑点。

1.1 系统要求

检查并安装 Node.js：

1.2 安装 OpenClaw

权限报错处理：若出现 ，执行 ，再重新安装。

1.3 运行 Onboard 向导

Onboard 向导是 OpenClaw 官方提供的交互式配置工具，自动完成 Gateway 守护进程注册、初始配置文件创建和健康检查。

向导会依次引导完成：

1. 选择安装位置：默认
2. 注册守护进程：macOS 写入 ；Linux 写入
3. API Key 初始配置：填入第一个 Provider 的 API Key
4. 健康检查：自动运行 验证配置

注意：向导完成后 Gateway 会自动启动并在系统重启时自动恢复。

1.4 验证 Gateway 运行

Gateway 控制命令速查：

2.1 配置文件位置总览

2.2 auth-profiles.json：配置 LLM Provider

这是 OpenClaw 最核心的配置文件，控制使用哪个 AI 提供商的哪个模型。

国际 Provider 配置示例：

国内 Provider 配置（兼容 OpenAI API 格式）：

七牛云 MaaS 统一接入（一个 Key 切换多个国内模型）：

配置生效：修改 后执行 使配置生效。

2.3 接入渠道

OpenClaw 支持 20+ 渠道，以下是最常用的几种接入方式：

Telegram（最推荐入门渠道）

Discord

Slack

查看已配置渠道

2.4 设备配对安全机制

OpenClaw 对 WebChat（浏览器控制台）和未知发件人默认启用设备配对审批机制：首次访问时生成 pairing request，需要人工审批后才能通信。

常见问题：浏览器访问 后显示 ，多数是设备配对未完成——先检查 是否有 pending 请求。

3.1 OpenClaw 技能体系

OpenClaw 的技能（Skills）是扩展 AI 能力的核心机制，分为三类：

3.2 安装 ClawHub 技能

ClawHub DNS 故障绕过（2026 年 3 月 13 日起）：若 超时，改用 直接从 GitHub 安装。

3.3 内置工具使用

OpenClaw 内置四大工具，可在对话中直接调用：

Shell 执行：

浏览器控制：

文件操作：

3.4 接入 MCP 协议工具

MCP Server 配置（在 中）：

重启生效后验证：

使用示例（在对话中）：

4.1 Cron 定时任务

OpenClaw 内置 Cron 系统，无需 crontab 或外部调度工具，直接在对话中创建定时任务：

通过配置文件显式定义 Cron 任务（）：

4.2 多 Agent 路由与 Workspace

创建专用 Agent（ 目录下）：

路由规则（按关键词自动分发到不同 Agent）：

4.3 自定义 Skill 编写

Skill 是一个 Markdown 文件（），定义工作流步骤，由 OpenClaw 解析并执行。

最简 Skill 示例：

部署 Skill：

Skill 编写最佳实践（基于 Anthropic 官方提示词工程文档）：

• 每个步骤只做一件事（原子化）
• 自动执行的步骤加
• 用 或括号注明步骤依赖关系
• 每步说明「完成标准」而非只说「做什么」

4.4 防限速与高可用配置

高频使用场景下，配置多 API Key 和速率限制可大幅提升稳定性：

4.5 远程访问：SSH 隧道 vs Nginx 反代

方案 A：SSH 隧道（最简单，推荐入门）

方案 B：Nginx 反向代理（生产环境）

官方资源

国内生态

Q：入门应该用哪个 Provider 和渠道？
Provider 推荐 DeepSeek（兼容 OpenAI 格式，国内可直连，成本低），渠道推荐 Telegram（配置最简单，只需一个 Bot Token，无需企业账号）。两者结合是入门门槛最低的组合。

Q：Onboard 向导完成后，怎么验证 OpenClaw 工作正常？
依次执行：（确认守护进程运行）→ （确认 HTTP 端点正常）→ 向已配对渠道发送一条 “hello”（确认 AI 响应）→ （全面健康检查）。四步全通则配置正确。

Q：技能执行时 Claude 经常跳步，怎么避免？
核心是「步骤原子化 + 完成标准」：每步只做一件事，步骤末尾注明「完成标准：XX 文件存在后继续」，自动执行步骤加 。详见 Anthropic 官方提示词工程文档（2026 年 3 月版）。

Q：如何在不同设备间同步 OpenClaw 配置？
同步 目录中的 、 和 目录（注意 包含 API Key，同步前确认目标存储安全）。可借助 rsync、Syncthing 或加密 Git 仓库实现跨设备同步。

Q：OpenClaw 的学习曲线太陡，有更简单的方案吗？
Linclaw（七牛云推出的 OpenClaw 桌面版）将本教程中第一、二阶段的全部命令行操作封装为图形化向导，安装后 5 分钟内即可接入微信/钉钉/飞书，适合技术基础较弱的用户。进阶功能（MCP、Cron、多 Agent）则仍建议使用 OpenClaw 原版以获得完整灵活性。

OpenClaw 的学习路径可分为清晰的四阶段：安装启动（Node.js ≥22 + npm install + onboard 向导）→ 配置接入（auth-profiles.json 配 Provider + 渠道 Token + 设备配对）→ 技能工具（ClawHub 技能 + MCP Server 配置）→ 进阶自动化（Cron 定时任务 + 多 Agent 路由 + 自定义 Skill）。每个阶段独立可验证，完成一个阶段后即可获得实际可用的 AI 助手能力，不必等到全部配置完成才能体验效果。

本文内容基于 OpenClaw 官方 GitHub 文档和 2026 年 3 月 Anthropic 官方提示词工程文档整理。