在2026年初,OpenClaw 迅速成为开源AI智能体领域的现象级项目。它不再是单纯的聊天机器人,而是一个真正能“动手”的本地AI助手:可以读取文件、执行命令、自动化处理邮件、跨平台管理消息,甚至帮你写代码、生成报告。本文将详细解答“OpenClaw和Clawdbot怎么一起装”的疑问,带你从零基础完成安装、配置到实战应用,包含本地部署、云部署、常见坑与解决方案,助你快速拥有一个24小时在线的私人AI管家。

文章导航
OpenClaw 与 Clawdbot 的关系:为什么会更名?
Clawdbot 是项目早期名称,因与 Anthropic 的 Claude 发音过于相似,开发者Peter Steinberger 将其更名为 OpenClaw。更名后:
- GitHub 仓库地址变更为 https://github.com/openclaw/openclaw
- npm 包名从 clawdbot 改为 OpenClaw
- 配置文件路径从 ~/.clawdbot 变为 ~/.openclaw(旧路径仍兼容)
- 命令行工具从 clawdbot 改为 openclaw
结论:你现在安装的就是最新版的 OpenClaw,它完全兼容之前所有 Clawdbot 的配置和技能。老用户只需更新包名,新用户直接安装 OpenClaw 即可,无需同时安装两个。
OpenClaw 核心架构与能力一览
OpenClaw 由四个核心模块组成:
| 模块 | 功能说明 | 典型用途 |
|---|---|---|
| Gateway | 网关,负责与外部消息平台(如钉钉、Telegram)连接 | 接收指令、返回结果,支持流式响应 |
| Agent | 智能体核心,使用大模型进行推理与决策 | 理解复杂指令、规划多步任务 |
| Skills | 可插拔技能包 | 网页搜索、邮件处理、文件管理、代码执行等 |
| Memory | 本地记忆存储 | 跨会话记住用户偏好、历史对话 |
它能做什么?简单来说:把你的聊天窗口变成一个“万能遥控器”。比如:
- 自动整理邮件并生成摘要
- 根据天气预报提醒带伞
- 在钉钉里直接让AI写日报、回复客户咨询
- 管理本地文件、批量重命名、归档
- 辅助编程、调试代码
安装前准备:环境与必备条件
| 项目 | 推荐配置 | 说明 |
|---|---|---|
| 操作系统 | macOS 13+、Windows 10/11、Linux(Ubuntu 22.04+) | 全平台支持 |
| Node.js | v18 或更高版本 | npm 安装必备 |
| 云服务器(可选) | 腾讯云 Lighthouse、阿里云无影云电脑、轻量服务器 | 推荐2核4G以上,带宽5M+ |
| AI模型API密钥 | 通义千问、GLM-4、MiniMax、DeepSeek、OpenAI等 | 国内模型延迟低、性价比高 |
| 消息通道 | Telegram、钉钉、飞书、iMessage(Mac独享) | 至少准备一个 |
本地安装详细教程(Mac/Windows/Linux通用)
步骤1:一键安装 OpenClaw
npm install -g openclaw@latest
如果之前装过 clawdbot,建议先卸载:
npm uninstall -g clawdbot
步骤2:运行安装向导
openclaw onboard
向导会提示:
- 同意用户协议:输入 yes
- 选择配置模式:推荐“快速配置”:Quick Setup
- 选择AI模型:推荐国内模型如 GLM-4 或通义千问
- 输入对应的 API Key:密钥会在这一步验证
- 选择是否安装系统守护进程:推荐安装,便于后台运行
步骤3:启动网关
openclaw gateway --port 18789 --verbose
成功后,浏览器打开 http://127.0.0.1:18789 即可进入Web控制面板。
步骤4:安装守护进程(推荐,保持常驻)
openclaw onboard --install-daemon
openclaw daemon start
查看状态:
openclaw daemon status
云服务器部署(推荐新手,最安全)
国内两大云厂商已推出专属镜像,基本开箱即用。
| 方案 | 价格参考(2026年2月) | 优点 | 推荐指数 |
|---|---|---|---|
| 腾讯云 Lighthouse | 2核2G ≈20元/月 | 专属Moltbot镜像,一键部署 | ★★★★★ |
| 阿里云无影云电脑 | 2核4G ≈99元/月(含Windows) | 支持钉钉/飞书原生集成 | ★★★★☆ |
| 阿里云轻量应用服务器 | 2核4G ≈50元/月 | 灵活,可自装Docker | ★★★★☆ |
以腾讯云 Lighthouse 为例:
- 购买带“openclaw”标签的镜像实例
- 登录服务器(SSH)
- 执行 openclaw onboard(镜像已预装)
- 配置模型和Telegram/钉钉通道
- 通过SSH隧道在本机浏览器访问控制面板:
ssh -N -L 18789:127.0.0.1:18789 user@你的服务器IP
然后打开 http://127.0.0.1:18789
配置AI模型(大脑)
OpenClaw 支持几乎所有主流模型,推荐优先级:
| 优先级 | 模型 | 优点 | 获取API Key方式 |
|---|---|---|---|
| 1 | GLM-4(智谱AI) | 国产最强、速度快、价格低 | 智谱AI官网注册 |
| 2 | 通义千问(阿里云) | 与阿里云部署深度集成 | 阿里云百炼平台 |
| 3 | DeepSeek-V3 | 性价比极高 | DeepSeek官网 |
| 4 | MiniMax-Text-01 | 长上下文 | MiniMax官网 |
| 5 | GPT-4o / Claude 3.5 | 国际最强(需科学上网) | 对应官网 |
配置方式:
- 向导中直接输入
- 或手动编辑 ~/.openclaw/openclaw.json
{
"llm": {
"provider": "openai-compatible",
"apiKey": "your-key",
"baseUrl": "https://api.zhipu.ai/v4",
"model": "glm-4-7b-chat"
}
}
连接消息通道(让AI听得到你说话)
方式1:Telegram(最简单,全球通用)
- 打开 Telegram,搜索 @BotFather
- 发送 /newbot → 命名 → 获取 Token
- 在服务器执行 openclaw onboard,继续配置,选择 Telegram,粘贴 Token
- 给你的机器人发任意消息,会返回配对码
- 执行:
openclaw pairing approve telegram xxxxxxxx
完成!现在直接在 Telegram 私聊机器人即可对话。
方式2:钉钉(企业/工作场景首选)
- 钉钉开放平台 → 企业内部开发 → 创建机器人应用
- 获取 AppKey 和 AppSecret
- 开通必要权限(Card.Streaming.Write 等)
- 安装官方连接器插件:
openclaw plugins install https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git
- 在 openclaw.json 中添加 dingtalk 配置(见上文内容5)
- 重启网关:openclaw gateway restart
- 在钉钉搜索机器人名称开始对话,支持流式输出、图片、Markdown
方式3:iMessage(Mac独享,最丝滑)
Mac 用户可在向导中选择 iMessage,安装 imsg 工具后按提示完成数据库路径配置与手机配对。
常见问题与解决方案
问题1:网关启动后报错 1006(WebSocket异常)
原因:守护进程未正确安装,尤其在root用户或无user systemd环境下。
解决:
loginctl enable-linger root
export XDG_RUNTIME_DIR=/run/user/0
openclaw daemon install
openclaw daemon start
openclaw daemon status
问题2:模型调用失败,提示 invalid api key
检查 baseUrl 是否正确(国内模型通常不是 openai.com),并确认密钥有余额。
问题3:技能无法使用
执行:
openclaw plugins update
openclaw plugins list
从 https://clawdhub.com/ 安装最新技能包。
问题4:想在公网访问控制面板(不推荐)
强烈建议仅本地访问!如必须远程,务必启用 gatewayToken 认证,并通过 SSH 隧道访问。

实战经验分享:我用 OpenClaw 干了什么
- 每日信息汇总:让它每天8点自动抓取RSS、微信公众号文章,整理成Markdown周报,通过Telegram推送。
- 代码助手:直接发“帮我写一个Python爬虫抓取某网站数据”,它会给出完整代码并解释。
- 工作自动化:在钉钉里@机器人“帮我写今天的工作日报”,3秒出稿,准确率90%以上。
- 文件管理:指令“把桌面所有图片按日期分类归档到相册文件夹”,瞬间完成。
- 跨平台提醒:它同时连着Telegram和钉钉,任何平台发消息都能收到。
使用一个月后,明显感觉时间碎片被充分利用,许多重复性工作彻底解放。
安全须知:能力越强,责任越大
OpenClaw 拥有文件读写、执行命令、网络请求等权限,使用不当可能造成严重后果。请务必:
- 网关只绑定 127.0.0.1,绝不暴露公网
- 启用 gatewayToken 或 password 认证
- API Key 存放环境变量,不明文写配置文件
- 敏感操作先在虚拟机或沙箱测试
- 定期查看日志:journalctl –user -u openclaw-gateway.service -f
结语
无论你是还在搜索“OpenClaw怎么装”的老用户,还是刚刚听说 OpenClaw 的新手,按照本文步骤操作,最快30分钟就能拥有一个功能强大的私人AI助手。推荐新手优先选择腾讯云或阿里云的官方镜像,既安全又省心;技术爱好者则可以本地深度定制,充分发挥其插件化架构的无限可能。
开始行动吧,让 OpenClaw 成为你2026年的效率神器!
延展阅读:
ChatGPT3.5——AI人工智能是什么玩意?探索充满无限奥秘的人工智能。