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

OpenClaw 完全指南：开源 AI 助手部署与配置

OpenClaw 是一款开源个人 AI 助手项目，支持多渠道通信及主动操作电脑系统。它具备本地优先特性，硬件要求低，支持多种大语言模型。介绍其核心功能、安装部署方法（包括一键脚本、源码安装）以及云端托管方案。通过配置 API Key 和 IM 工具，可实现邮件处理、代码编写、文件整理等自动化任务。建议采用 WSL2 环境运行，并关注安全配置与沙盒模式以保障数据安全。

abccba发布于 2026/3/24更新于 2026/8/2455 浏览
OpenClaw 完全指南：开源 AI 助手部署与配置

OpenClaw 完全指南：开源 AI 助手部署与配置

一、OpenClaw 是什么？

1.1 项目背景

OpenClaw（原名 Clawdbot，过渡名 Moltbot）是 2026 年 1 月爆火的开源个人 AI 助手项目，由 Peter Steinberger（PSPDFKit 创始人）开发。

项目名称演变历程：

名称时间线说明
Clawdbot / Clawbot2025 年末 - 2026 年 1 月初最初项目名，灵感来自 Claude 和 claw（龙虾爪）梗
Moltbot2026 年 1 月 27 日因 Anthropic 商标顾虑被要求更名，过渡名字
OpenClaw2026 年 1 月 30 日后当前官方名称，强调开源性，吉祥物是小龙虾 Molty 🦞

1.2 核心定位

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

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

核心能力：

  • 💬 多渠道通信（WhatsApp、Telegram、微信、钉钉、飞书、企业微信、QQ）
  • 🖥️ 主动操作电脑系统
  • 🌐 访问网页搜索信息
  • 📧 处理邮件和日程
  • 📁 整理文件和数据
  • ⏰ 发起提醒和自动化任务
  • 💻 自动编写和调试代码

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. 模型/认证配置
Model/auth provider ○ OpenAI ○ Anthropic ○ MiniMax ● Moonshot AI (Kimi K2 + Kimi Coding) ○ Google ○ OpenRouter ○ Qwen ○ Z.AI (GLM 4.7) ○ Copilot ○ Vercel AI Gateway ○ OpenCode Zen ○ Xiaomi ○ Symbiotic ○ Venice AI ○ Skip for now

支持的模型供应商：

供应商适用场景说明
OpenAI通用场景GPT-4 系列模型
Anthropic海外用户，代码能力强Claude 3.5 Sonnet 等
Moonshot AI中文场景，长文本Kimi K2 + Kimi Coding
Qwen国内用户，性价比高阿里云通义千问
Z.AI (GLM 4.7)中文场景智谱 AI
MiniMax中文场景国内大模型
Google通用场景Gemini 系列

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

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

4. 聊天工具配置

支持的 IM 工具：

工具配置方式说明
WhatsApp二维码扫描登录海外用户首选
TelegramBot Token需要创建 Bot
微信插件/第三方服务国内用户便利
钉钉机器人 Token企业用户
飞书机器人 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. 配置模型 API Key
    • 前往模型服务商控制台
    • 创建 API-Key
  3. 配置应用
    • 进入服务器控制台
    • 放行 18789 端口
    • 配置模型 API Key
    • 生成访问 Token
  4. 集成发布
    • 配置 IM 工具（钉钉、企业微信等）
    • 开始使用

5.3 云端部署对比

云平台最低价格特色优势推荐场景
云服务商 A参考官网深度集成大模型开发者、企业用户
云服务商 B参考官网全面接入主流 IM个人用户、小型团队
云服务商 C参考官网电信网络优势企业用户、对网络要求高的场景

六、进阶配置

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：

Skill功能说明
web-search网络搜索需要配置 Brave Search API Key
code-editor代码编辑支持多种编程语言
file-operations文件操作文件读写、整理
system-commands系统命令执行 Shell 命令
email-handler邮件处理收发邮件

七、常见问题与解决方案

7.1 安装问题

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

# 在 WSL2 中执行安装
curl -fsSL https://openclaw.ai/install.sh | bash

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

# 使用 nvm 升级
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. 及时反馈
    • 如果结果不符合预期，及时纠正
    • 使用具体的例子说明需求

分步骤任务

❌ "帮我做一个网站"
✅ "第一步：创建一个 Flask 项目结构；第二步：写一个首页路由..."

清晰的指令

❌ "帮我写代码"
✅ "用 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. 参与社区：贡献代码，分享经验

目录

  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. 5.3 云端部署对比
  51. 六、进阶配置
  52. 6.1 配置文件详解
  53. 6.2 沙盒模式配置
  54. 6.3 安装 Skills
  55. 查看可用 Skills
  56. 安装 Skill
  57. 查看已安装 Skills
  58. 七、常见问题与解决方案
  59. 7.1 安装问题
  60. 在 WSL2 中执行安装
  61. 使用 nvm 升级
  62. 7.2 配置问题
  63. 7.3 性能优化
  64. 八、最佳实践
  65. 8.1 安全建议
  66. 8.2 使用技巧
  67. 8.3 团队协作
  68. 九、生态与社区
  69. 9.1 官方资源
  70. 9.2 Skills 生态
  71. 9.3 社区交流
  72. 十、总结
  73. OpenClaw 的核心价值
  74. 适用人群
  75. 下一步行动
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Python 在 CentOS 系统上的安装与配置深度指南
  • 前端大数据导出优化：解决 Chrome 内存崩溃的实战方案
  • 数据结构基础：串的定义与常见误区
  • RAG 评估指南：解析评估指标与代码示例
  • 基于 Z-Image-Turbo 的虚拟现实场景资产自动化生成路径
  • n8n 飞书机器人 Webhook 配置与 Crypto 节点签名实现
  • Go 语言实现 Graham Scan 凸包算法详解与源码
  • AI Agent 智能体核心架构与实战解析
  • C++ 模板进阶：特化、萃取与可变参数详解
  • 学习大语言模型原理必看的 10 篇论文
  • Mac Mini M4 本地运行大模型：Ollama 与 Llama 环境配置
  • Llama-Factory 微调模型一键部署上线方案
  • 本地部署 Kimi K2 模型：llama.cpp、vLLM 与 Docker 方案
  • 用好 std::sort：自定义排序与常见陷阱
  • Yolo11 基于 DroneVehicle 数据集的无人机视角车辆目标检测
  • Stable Diffusion 与 Kohya_ss 安装指南
  • 基于 FPGA 的高速多通道数据采集系统设计
  • 算法：位运算技巧与经典题目解析
  • Python 入门基础教程：从环境搭建到核心语法详解
  • ComfyUI 自定义脚本使用指南：优化 AI 绘画工作流

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • curl 转代码

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

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online