跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonNode.jsAI算法

OpenClaw 开源 AI 助手部署与使用完全指南

OpenClaw 是一款由 PSPDFKit 创始人开发的开源 AI 智能体，支持本地优先与云端部署。它能主动操作电脑、访问网页、处理邮件及编写代码。 OpenClaw 的背景、核心能力、三种安装方式（一键脚本、手动、源码）、配置向导流程、模型与 IM 工具对接方法，以及云端部署方案和进阶配置技巧。内容涵盖系统要求、常见问题排查、安全最佳实践及团队协作建议，适合开发者、职场人士及技术爱好者快速上手打造 7x24 小时在线的个人 AI 助手。

JavaCoder发布于 2026/3/30更新于 2026/7/2532 浏览
OpenClaw 开源 AI 助手部署与使用完全指南

OpenClaw 开源 AI 助手部署与使用完全指南

OpenClaw Logo

摘要：OpenClaw（原名 Clawdbot/Moltbot）是由 PSPDFKit 创始人 Peter Steinberger 开发的开源个人 AI 助手项目。它不仅能回答问题，还能主动操作电脑、访问网页、处理邮件、编写代码。本文将详细介绍 OpenClaw 的功能特性、安装部署方法，以及如何在主流云平台上一键部署你的专属 AI 助手。

一、OpenClaw 是什么？

1.1 项目背景

OpenClaw 是 2026 年 1 月爆火的开源个人 AI 助手项目。项目名称经历了从 Clawdbot 到 Moltbot，再到最终定名 OpenClaw 的演变，强调其开源属性，吉祥物为小龙虾 Molty 🦞。

1.2 核心定位

与传统聊天机器人不同，OpenClaw 是一个可执行任务的智能体（Agent）。

  • ❌ 传统 AI：只能给建议、回答问题
  • ✅ OpenClaw：直接完成完整工程任务

核心能力包括多渠道通信（WhatsApp、Telegram、微信等）、主动操作电脑系统、访问网页搜索信息、处理邮件和日程、整理文件数据以及自动编写调试代码。

1.3 技术特点

  • 本地优先（Local-First）：数据保存在本地，隐私安全
  • 极低硬件要求：2GB RAM 即可运行
  • 跨平台支持：Mac、Windows、Linux（推荐 WSL2）
  • 多模型支持：OpenAI、Anthropic、Moonshot AI（Kimi）、Qwen（通义千问）、Z.AI（智谱 GLM）、MiniMax、Google 等
  • 开源免费：GitHub 开源，社区驱动

二、OpenClaw 能做什么？

2.1 典型应用场景

场景功能描述示例
AI 职场助理邮件处理、日程待办、周报总结"帮我总结本周的邮件并生成周报"
AI 编程助理代码编写、调试、重构"帮我写一个 Python 爬虫抓取豆瓣电影 Top250"
AI 学习助理资料整理、知识问答、学习规划"帮我整理 Python 异步编程的学习资料"
AI 旅行生活行程规划、酒店预订、翻译"帮我规划一个 5 天的日本东京行程"
自动化任务定时任务、数据处理、文件整理"每天早 8 点帮我整理桌面文件"

2.2 核心功能演示

# 搜索最新科技新闻
"帮我搜索今天的人工智能新闻"

# 编写代码
"用 Python 写一个斐波那契数列生成器，要求使用生成器实现"
# 操作文件
"帮我整理 Downloads 文件夹，按文件类型分类"
# 处理邮件
"帮我查看今天的邮件，并总结重要事项"
# 系统操作
"帮我查看当前系统的 CPU 和内存使用情况"

三、安装部署指南

3.1 系统要求

项目要求
硬件2GB RAM 及以上
操作系统macOS、Windows（推荐 WSL2）、Linux
Node.js>= 22
包管理器npm 或 pnpm

💡 Windows 用户注意：强烈推荐使用 WSL2（Ubuntu），原生 Windows 未经充分测试，工具兼容性较差。

3.2 安装方式一：一键脚本（推荐）

macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex
Windows（CMD）
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

一键脚本会自动检测环境、安装 Node.js（≥22）、安装 OpenClaw 并启动 onboarding 配置向导。

3.3 安装方式二：手动安装

# 使用 npm
npm i -g openclaw

# 或使用 pnpm
pnpm add -g openclaw

# 初始化并安装后台服务
openclaw onboard

3.4 安装方式三：从源码安装（开发模式）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 构建前端界面
pnpm build # 构建整个项目

# 初始化并安装为系统后台服务
pnpm openclaw onboard --install-daemon

# 开发模式：监听代码变更
pnpm gateway:watch

四、配置与初始化

4.1 运行配置向导

安装完成后，运行 onboarding 向导：

openclaw onboard --install-daemon

向导会引导你完成以下配置：

1. 安全确认
Must read: https://docs.openclaw.ai/gateway/security
I understand this is powerful and inherently risky. Continue?
◎ Yes / ● No

选择 Yes 继续。OpenClaw 能直接执行系统命令和操作文件，确实存在风险，建议先阅读安全文档了解详情。

2. 启动模式选择
Onboarding mode
● QuickStart (configure details later via openclaw configure.)
○ Manual

选择 QuickStart 模式（快速启动，后续可通过 openclaw configure 修改配置）。

3. 模型/认证配置

支持的模型供应商包括 OpenAI、Anthropic、Moonshot AI（Kimi K2 + Kimi Coding）、Qwen（通义千问）、Z.AI（GLM 4.7）、MiniMax、Google 等。

国内用户推荐：Moonshot AI（Kimi）或 Qwen（通义千问），无需海外账号，响应速度快。

选择供应商后，需要配置 API Key 或 OAuth 认证。

4. 聊天工具配置

支持的 IM 工具包括 WhatsApp（二维码扫描登录）、Telegram（Bot Token）、微信（插件/第三方服务）、钉钉/飞书/企业微信（机器人 Token）、QQ（插件）。

5. 端口配置

默认网关端口：18789 访问地址：http://127.0.0.1:18789/chat

6. Skills 选择

可以选择预置的技能包：Web 搜索、代码编辑、文件操作、系统命令、邮件处理。也可以直接跳过，后续再安装。

4.2 常用命令

# 查看状态
openclaw status

# 查看详细状态
openclaw status --all

# 健康检查
openclaw health

# 启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 查看网关状态
openclaw gateway status

# 发送测试消息
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

4.3 配对与安全

默认策略：未知私信会收到一个配对码，需要批准后才能交互。

# 查看待批准的配对请求
openclaw pairing list whatsapp

# 批准配对
openclaw pairing approve whatsapp <code>

五、云端一键部署方案

5.1 为什么选择云端部署？

对比项本地部署云端部署
在线时间电脑关机即离线7×24 小时在线
稳定性依赖本地环境云端稳定托管
安全性与个人数据混杂环境隔离，数据安全
访问方式仅限本机多终端随时访问
适用场景个人学习、实验生产环境、团队协作

5.2 云服务器部署通用步骤

以主流云厂商为例，通常包含以下步骤：

  1. 购买实例：选择轻量应用服务器或 ECS，推荐配置 2vCPU + 2GiB 内存。
  2. 配置镜像：部分云厂商提供 OpenClaw 应用镜像，可直接选择。
  3. 配置模型 API Key：前往 Moonshot AI 或阿里云百炼控制台创建 API-Key。
  4. 配置应用：进入服务器控制台，放行 18789 端口，配置模型 API Key。
  5. 集成发布：配置 IM 工具（钉钉、企业微信等），开始使用。

注：具体价格与优惠活动请参考各云厂商官方页面，此处仅展示技术流程。

六、进阶配置

6.1 配置文件详解

配置文件位置：~/.openclaw/config.json

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/clawd",
        "sandbox": { "mode": "off" }
      }
    }
  },
  "gateway": {
    "port": 18789,
    "auth": { "token": "your-gateway-token" }
  },
  "models": {
    "default": "claude-3-5-sonnet",
    "providers": {
      "anthropic": { "apiKey": "your-anthropic-api-key" },
      "aliyun": { "apiKey": "your-aliyun-api-key" }
    }
  }
}

6.2 沙盒模式配置

沙盒模式用于隔离群组/频道会话，保护主环境：

{
  "routing": {
    "agents": {
      "defaults": {
        "sandbox": { "mode": "non-main" }
      }
    }
  }
}
  • mode: "off" - 关闭沙盒，在主环境运行
  • mode: "non-main" - 非主代理使用沙盒

6.3 安装 Skills

OpenClaw 支持通过 Skills 扩展功能：

# 查看可用 Skills
openclaw skills list

# 安装 Skill
openclaw skills install web-search
openclaw skills install code-editor
openclaw skills install file-operations

# 查看已安装 Skills
openclaw skills installed

推荐 Skills：web-search（网络搜索）、code-editor（代码编辑）、file-operations（文件操作）、system-commands（系统命令）、email-handler（邮件处理）。

七、常见问题与解决方案

7.1 安装问题

Q: Windows 安装失败怎么办？ A: 强烈推荐使用 WSL2（Ubuntu）：

curl -fsSL https://openclaw.ai/install.sh | bash

Q: Node.js 版本不够怎么办？ A: 升级 Node.js 到 22 或以上：

nvm install 22
nvm use 22

7.2 配置问题

Q: 显示 "no auth configured" 怎么办？ A: 返回向导设置 OAuth 或 API Key：

openclaw onboard

Q: WhatsApp / Telegram 连接失败？ A:

  1. 确保使用 Node 运行网关（不是 Bun）
  2. 检查网络连接
  3. 重新扫描二维码或配置 Bot Token

Q: 首次私信没有回复？ A: 需要批准配对：

openclaw pairing list <channel>
openclaw pairing approve <channel> <code>

7.3 性能优化

Q: 如何降低延迟？ A:

  1. 选择就近的云服务器区域
  2. 使用国内模型（阿里云百炼、MiniMax）
  3. 开启缓存和会话保持

Q: 如何提高稳定性？ A:

  1. 使用云端部署代替本地部署
  2. 配置 systemd/launchd 守护进程
  3. 开启自动重启

八、最佳实践

8.1 安全建议

  1. API Key 管理：不要将 API Key 硬编码在代码中，使用环境变量或配置文件，定期轮换 API Key。
  2. 访问控制：启用配对验证，限制可访问的 IM 账号，配置防火墙规则。
  3. 数据隔离：使用沙盒模式运行非信任会话，定期清理敏感数据，备份重要配置。

8.2 使用技巧

  1. 及时反馈：如果结果不符合预期，及时纠正，使用具体的例子说明需求。
  2. 分步骤任务： 
    ❌ "帮我做一个网站"
✅ "第一步：创建一个 Flask 项目结构；第二步：写一个首页路由..."
  3. 清晰的指令： 
    ❌ "帮我写代码"
✅ "用 Python 写一个函数，输入一个列表，返回去重后的有序列表"

8.3 团队协作

  1. 共享配置：使用版本控制管理配置文件，文档化团队规范。
  2. 权限管理：区分开发、测试、生产环境，配置不同的模型和工具权限。
  3. 监控告警：配置日志收集，设置异常告警，定期检查健康状态。

九、生态与社区

9.1 官方资源

  • 官网：https://openclaw.ai/
  • GitHub：https://github.com/openclaw/openclaw
  • 中文文档：https://clawd.org.cn/

9.2 Skills 生态

  • Awesome OpenClaw Skills：https://github.com/VoltAgent/awesome-openclaw-skills
  • 社区贡献的各种 Skills 扩展

9.3 社区交流

  • GitHub Issues：问题反馈和功能建议
  • Discord/Telegram 群组：技术交流
  • 各大云平台交流群：部署经验分享

十、总结

OpenClaw 的核心价值

  1. 真正可执行的 AI：不只是聊天，而是完成实际任务
  2. 本地优先：数据安全，隐私可控
  3. 开源免费：社区驱动，持续迭代
  4. 多渠道接入：支持主流 IM 工具
  5. 云端部署：7×24 小时在线服务

适用人群

  • 👨‍💻 开发者：代码助手、自动化脚本
  • 💼 职场人士：邮件处理、日程管理、周报生成
  • 🎓 学生：学习助手、资料整理
  • 🏢 企业团队：内部工具、自动化流程

下一步行动

  1. 快速体验：使用一键脚本在本地安装
  2. 稳定使用：在阿里云/腾讯云/天翼云部署云端版本
  3. 深度定制：开发自己的 Skills，扩展功能
  4. 参与社区：贡献代码，分享经验

本文基于 OpenClaw 最新版本编写，项目正在快速迭代中，建议关注官方更新。

目录

  1. OpenClaw 开源 AI 助手部署与使用完全指南
  2. 一、OpenClaw 是什么？
  3. 1.1 项目背景
  4. 1.2 核心定位
  5. 1.3 技术特点
  6. 二、OpenClaw 能做什么？
  7. 2.1 典型应用场景
  8. 2.2 核心功能演示
  9. 搜索最新科技新闻
  10. 编写代码
  11. 操作文件
  12. 处理邮件
  13. 系统操作
  14. 三、安装部署指南
  15. 3.1 系统要求
  16. 3.2 安装方式一：一键脚本（推荐）
  17. macOS / Linux
  18. Windows（PowerShell）
  19. Windows（CMD）
  20. 3.3 安装方式二：手动安装
  21. 使用 npm
  22. 或使用 pnpm
  23. 初始化并安装后台服务
  24. 3.4 安装方式三：从源码安装（开发模式）
  25. 初始化并安装为系统后台服务
  26. 开发模式：监听代码变更
  27. 四、配置与初始化
  28. 4.1 运行配置向导
  29. 1. 安全确认
  30. 2. 启动模式选择
  31. 3. 模型/认证配置
  32. 4. 聊天工具配置
  33. 5. 端口配置
  34. 6. Skills 选择
  35. 4.2 常用命令
  36. 查看状态
  37. 查看详细状态
  38. 健康检查
  39. 启动网关
  40. 停止网关
  41. 重启网关
  42. 查看网关状态
  43. 发送测试消息
  44. 4.3 配对与安全
  45. 查看待批准的配对请求
  46. 批准配对
  47. 五、云端一键部署方案
  48. 5.1 为什么选择云端部署？
  49. 5.2 云服务器部署通用步骤
  50. 六、进阶配置
  51. 6.1 配置文件详解
  52. 6.2 沙盒模式配置
  53. 6.3 安装 Skills
  54. 查看可用 Skills
  55. 安装 Skill
  56. 查看已安装 Skills
  57. 七、常见问题与解决方案
  58. 7.1 安装问题
  59. 7.2 配置问题
  60. 7.3 性能优化
  61. 八、最佳实践
  62. 8.1 安全建议
  63. 8.2 使用技巧
  64. 8.3 团队协作
  65. 九、生态与社区
  66. 9.1 官方资源
  67. 9.2 Skills 生态
  68. 9.3 社区交流
  69. 十、总结
  70. OpenClaw 的核心价值
  71. 适用人群
  72. 下一步行动
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • CentOS YUM 源报错修复与 repo.repo 配置实战
  • Java 反射机制核心逻辑与面试考点
  • Windows 环境下 Clawdbot Gateway 持久化运行配置指南
  • Cursor 彻底卸载与设备标识重置指南
  • UniApp 小程序自定义底部 TabBar 闪烁白屏优化方案
  • BeyondCompare 安装与本地试用状态管理
  • 边缘计算设备部署轻量 TensorFlow 模型全流程
  • 2024 年免费 AI 效率工具指南：OCR、绘图与写作助手精选
  • Git 下载及安装教程（适用于 Windows/macOS/Linux）
  • Java 模拟算法题目练习
  • 前端 PDF 导出实战：JSPDF 与 HTML2Canvas 深度解析
  • AIGC 核心概念解析：22 个基础术语详解
  • Python 素数判断与查找算法详解
  • OpenCode 使用 GitHub Copilot 按次计费账单暴涨原因与优化方案
  • Spring Web MVC 核心概念与实战应用
  • OpenClaw 安全 AI 助理搭建与部署实战指南
  • Rust 控制流详解：条件、循环与模式匹配
  • 免费版 Trae 编辑器实测：i18n 任务排队千位与死循环问题
  • C++ 核心就业方向与技术成长指南
  • web应用集成AI翻译：前端+后端完整调用示例代码分享

相关免费在线工具

  • 加密/解密文本

    使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印，支持批量处理与下载。 在线工具，Gemini 图片去水印在线工具，online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online