OpenClaw 开源 AI 助手部署与使用指南
OpenClaw 是一款开源 AI 智能体项目,支持本地优先运行及多渠道通信。它具备主动操作电脑、访问网页、处理邮件及编写代码的能力。本文涵盖项目背景、核心功能演示、本地安装步骤、配置向导流程以及云端部署方案。通过配置大模型 API Key 与 IM 工具,用户可实现 7×24 小时自动化任务执行。文章还包含进阶配置、常见问题解决及安全最佳实践,适合开发者及职场人士构建个人 AI 助手。

OpenClaw 是一款开源 AI 智能体项目,支持本地优先运行及多渠道通信。它具备主动操作电脑、访问网页、处理邮件及编写代码的能力。本文涵盖项目背景、核心功能演示、本地安装步骤、配置向导流程以及云端部署方案。通过配置大模型 API Key 与 IM 工具,用户可实现 7×24 小时自动化任务执行。文章还包含进阶配置、常见问题解决及安全最佳实践,适合开发者及职场人士构建个人 AI 助手。

OpenClaw(原名 Clawdbot,过渡名 Moltbot)是 2026 年 1 月爆火的开源个人 AI 助手项目,由 Peter Steinberger(PSPDFKit 创始人)开发。
项目名称演变历程:
| 名称 | 时间线 | 说明 |
|---|---|---|
| Clawdbot / Clawbot | 2025 年末 - 2026 年 1 月初 | 最初项目名,灵感来自 Claude 和 claw(龙虾爪)梗 |
| Moltbot | 2026 年 1 月 27 日 | 因 Anthropic 商标顾虑被要求更名,过渡名字 |
| OpenClaw | 2026 年 1 月 30 日后 | 当前官方名称,强调开源性,吉祥物是小龙虾 Molty 🦞 |
OpenClaw 是一个可执行任务的智能体(Agent),与传统聊天机器人不同:
核心能力:
| 场景 | 功能描述 | 示例 |
|---|---|---|
| AI 职场助理 | 邮件处理、日程待办、周报总结 | "帮我总结本周的邮件并生成周报" |
| AI 编程助理 | 代码编写、调试、重构 | "帮我写一个 Python 爬虫抓取豆瓣电影 Top250" |
| AI 学习助理 | 资料整理、知识问答、学习规划 | "帮我整理 Python 异步编程的学习资料" |
| AI 旅行生活 | 行程规划、酒店预订、翻译 | "帮我规划一个 5 天的日本东京行程" |
| 自动化任务 | 定时任务、数据处理、文件整理 | "每天早 8 点帮我整理桌面文件" |
# 搜索最新科技新闻
# 帮我搜索今天的人工智能新闻
# 编写代码
# 用 Python 写一个斐波那契数列生成器,要求使用生成器实现
# 操作文件
# 帮我整理 Downloads 文件夹,按文件类型分类
# 处理邮件
# 帮我查看今天的邮件,并总结重要事项
# 系统操作
# 帮我查看当前系统的 CPU 和内存使用情况
| 项目 | 要求 |
|---|---|
| 硬件 | 2GB RAM 及以上 |
| 操作系统 | macOS、Windows(推荐 WSL2)、Linux |
| Node.js | >= 22 |
| 包管理器 | npm 或 pnpm |
💡 Windows 用户注意:强烈推荐使用 WSL2(Ubuntu),原生 Windows 未经充分测试,工具兼容性较差。
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
一键脚本会自动:
# 使用 npm
npm i -g openclaw
# 或使用 pnpm
pnpm add -g openclaw
# 初始化并安装后台服务
openclaw onboard
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
安装完成后,运行 onboarding 向导:
openclaw onboard --install-daemon
向导会引导你完成以下配置:
Must read: https://docs.openclaw.ai/gateway/security
I understand this is powerful and inherently risky. Continue?
◎ Yes / ● No
选择 Yes 继续。
💡 说明:OpenClaw 能直接执行系统命令和操作文件,确实存在风险。建议先阅读安全文档了解详情。
Onboarding mode
● QuickStart (configure details later via openclaw configure.)
○ Manual
选择 QuickStart 模式(快速启动,后续可通过 openclaw configure 修改配置)。
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 | 中文场景 | 国内大模型 |
| 通用场景 | Gemini 系列 |
国内用户推荐:Moonshot AI(Kimi)或 Qwen(通义千问),无需海外账号,响应速度快。
选择供应商后,需要配置 API Key 或 OAuth 认证。
支持的 IM 工具:
| 工具 | 配置方式 | 说明 |
|---|---|---|
| 二维码扫描登录 | 海外用户首选 | |
| Telegram | Bot Token | 需要创建 Bot |
| 微信 | 插件/第三方服务 | 国内用户便利 |
| 钉钉 | 机器人 Token | 企业用户 |
| 飞书 | 机器人 Token | 企业用户 |
| 企业微信 | 机器人 Token | 企业用户 |
| 插件 | 个人用户 |
默认网关端口:18789
访问地址:http://127.0.0.1:18789/chat
可以选择预置的技能包:
也可以直接跳过,后续再安装。
# 查看状态
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"
默认策略:未知私信会收到一个配对码,需要批准后才能交互。
# 查看待批准的配对请求
openclaw pairing list whatsapp
# 批准配对
openclaw pairing approve whatsapp <code>
| 对比项 | 本地部署 | 云端部署 |
|---|---|---|
| 在线时间 | 电脑关机即离线 | 7×24 小时在线 |
| 稳定性 | 依赖本地环境 | 云端稳定托管 |
| 安全性 | 与个人数据混杂 | 环境隔离,数据安全 |
| 访问方式 | 仅限本机 | 多终端随时访问 |
| 适用场景 | 个人学习、实验 | 生产环境、团队协作 |
套餐选择:
部署步骤:
套餐选择:
开箱即用 OpenClaw 的云电脑方案:
| 云平台 | 特色优势 | 推荐场景 |
|---|---|---|
| 阿里云 | 百炼大模型深度集成,Coding Plan 套餐 | 开发者、企业用户 |
| 腾讯云 | 混元大模型支持,四大 IM 全面接入 | 个人用户、小型团队 |
| 天翼云 | 电信网络优势,AI 云电脑方案 | 企业用户、对网络要求高的场景 |
配置文件位置:~/.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"
沙盒模式用于隔离群组/频道会话,保护主环境:
{
"routing": {
"agents": {
"defaults": {
"sandbox": {
"mode": "non-main"
}
}
}
}
}
mode: "off" - 关闭沙盒,在主环境运行mode: "non-main" - 非主代理使用沙盒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 | 邮件处理 | 收发邮件 |
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
Q: 显示 "no auth configured" 怎么办?
A: 返回向导设置 OAuth 或 API Key:
openclaw onboard
Q: WhatsApp / Telegram 连接失败?
A:
Q: 首次私信没有回复?
A: 需要批准配对:
openclaw pairing list <channel>
openclaw pairing approve <channel> <code>
Q: 如何降低延迟?
A:
Q: 如何提高稳定性?
A:
分步骤任务
❌ "帮我做一个网站"
✅ "第一步:创建一个 Flask 项目结构;第二步:写一个首页路由..."
清晰的指令
❌ "帮我写代码"
✅ "用 Python 写一个函数,输入一个列表,返回去重后的有序列表"

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online