手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

AI Agent 上手指南

AI Agent(智能体)入坑指南

智能体工具箱

  • 打造你的第一个 AI Agent
  • OpenClaw (Clawdbot) 攻略
  • OpenClaw 一键搞定
  • RoxyBrowser (openclaw) 教程
  • 用 CrewAI 搭建智能体
  • LangChain 开发智能体
  • Claude Code 快速上手
  • OpenCode 新手入门
  • Skills 技能包指南
  • OpenCode skills 解析
  • Qoder 命令行工具
  • Trae Solo

PYTHON 手搓智能体

OPENCLAW (CLAWDBOT) 全面解析

OpenClaw(最早叫 Clawdbot,中间改过一次名也可以叫 Moltbot)是 2026 年 1 月突然在圈子里火起来的开源个人 AI 助手,操刀人是 Peter Steinberger(PSPDFKit 的创始人)。
简单来说,OpenClaw 就是一个能真正干活的智能体。你给它下个指令,它不光陪聊,还能直接去操作系统、上网查资料、回邮件、整理各种文件、设置提醒,甚至自己写代码跑程序。
OpenClaw 的核心玩法,就是把“本地算力”和“大模型 Agent 自动化”结合到了极致,绝对是开发者的效率神器。
它的终极目标是让 AI 别光动嘴皮子给建议,而是要把整个工程任务直接落地搞定。
手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!
这中间还有个小插曲,因为 Anthropic 在 1 月 27 日发了律师函,说 Clawd / Clawdbot 跟他们的 Claude 名字太像了,容易混淆。所以项目组当天紧急改名叫 Moltbot(意思是脱壳的小龙虾,吉祥物也换成了小龙虾 Molty 🦞),不过功能完全没变,老命令 clawdbot 照样能用。
Moltbot 只是为了避风头临时起的过渡名,OpenClaw 才是官方定下来的最终大名。
手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!
所以,Clawbot、Moltbot 和 OpenClaw 其实就是同一个开源项目,名字的变化过程是这样的:
Clawdbot → Moltbot → OpenClaw

名称 时间节点 来龙去脉 实际关系
Clawdbot / Clawbot 2025 年底到 2026 年 1 月初 最初的名字;玩的是 Claude 和 claw(龙虾钳)的谐音梗 也是它最早在 GitHub 上露面的身份
Moltbot 2026 年 1 月 27 日 怕侵权 Anthropic 商标被强制改名 中间过渡用的;代码和功能跟 Clawdbot 没区别
OpenClaw 2026 年 1 月 30 日以后 为了长远发展和强调开源,抛弃了版权纠纷的名字 现在的官方正统名称,以后文档和仓库都认准这个

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

安装攻略

OpenClaw 的安装设计得特别傻瓜化,就算你不是程序员也能轻松搞定。
硬件门槛(不挑机器):

  • 配置:极低,有 2GB 内存就能跑。
  • 环境:Mac、Windows、Linux 通吃,需要装 Node.js (pnpm) 或者直接用 Docker。

1、懒人推荐(一键脚本):

直接打开终端,把下面的命令粘贴进去回车就行。
macOS/Linux 用户:

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

Windows 用户:

#PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

#CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

这一步会自动帮你装好 Node.js(22 以上版本)并把基本配置搞定。

2、手动挡安装

前提是你已经装好了 Node.js ≥22 并且配好了环境。
用 npm 安装:

npm i -g openclaw

或者用 pnpm:

pnpm add -g openclaw

装完之后,初始化一下并把后台服务(launchd / systemd 用户服务)装上:

openclaw onboard

3、源码编译(极客模式)

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install

pnpm ui:build   # 第一次跑得先编译前端界面
pnpm build      # 编译整个后端项目

# 初始化 OpenClaw 并且把它设为开机自启
pnpm openclaw onboard --install-daemon

# 开发模式:代码改了会自动重启网关
pnpm gateway:watch

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

配置指南

强烈建议直接用那个一键脚本。
它会自动检查你的环境,缺啥补啥,还能顺手启动引导流程。
在这个过程中,它会提醒你这只“龙虾”能力很强,但权限高了风险也大。这时候直接选 yes(选 no 就不给你装了)。
接着我们选 QuickStart(快速启动)模式。
然后就是配置大脑——大模型。在 Model/Auth Provider 里选你的 AI 供应商,不管是国外的还是国内的都支持。
要是没有国外的账号,填咱们国内的 Qwen(通义千问)、MiniMax、智谱的 API key 也完全没问题。
之后会让你选聊天工具,国外那些要是没有,就选最后一个。
剩下的配置,比如端口 Gateway Port,默认 18789 就挺好;包管理器选 npm 就行,基本上一路回车按 Yes。
遇到选 Skills(技能)的时候,挑几个自己顺眼的,或者直接按空格跳过也行。

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!
那些乱七八糟的 API key,手里没有的就直接选 no。
最后那三个钩子建议开启,主要是为了保存引导日志和对话记录。
全搞定后,浏览器会自动弹出来访问 http://127.0.0.1:18789/chat,这就是你的控制台了。
你可以试着让它搜搜最新的科技新闻。
想看它运行状态怎么样,敲这个命令:

openclaw status

常用指令表

openclaw gateway           # 启动 WebSocket 网关(后面可以加 --port 改端口)
openclaw gateway start     # 启动服务
openclaw gateway stop      # 停车熄火
openclaw gateway restart   # 重启一下
openclaw channels login    # 扫码登录 WhatsApp
openclaw channels add      # 添加 Telegram/Discord/Slack 机器人(记得带 --token)
openclaw channels status --probe      # 看看各个通道通不通
openclaw onboard # 重新跑一遍设置向导(加 --install-daemon 可装守护进程)
openclaw doctor --deep     # 深度体检加自动修复
openclaw config get|set|unset    # 查配置 / 改配置 / 删配置
openclaw models list|set|status  # 看看模型能不能用
openclaw models auth setup-token # 设置 Anthropic 的认证

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

聊天通道管理

  • WhatsApp:openclaw channels login(或者扫 QR 码)
  • Telegram:openclaw channels add --channel telegram(需要 Bot Token)
  • Discord:openclaw channels add --channel discord(需要 Bot Token)
  • iMessage:macOS 原生就能连
  • Slack:openclaw channels add --channel slack(需要 Bot Token)

工作区解剖(WORKSPACE ANATOMY)

  • AGENTS.md:告诉它怎么干活的指令书
  • USER.md:你的个人偏好设置
  • MEMORY.md:它的长期记忆库
  • HEARTBEAT.md:例行检查清单
  • SOUL.md:设定它的人格和语气
  • IDENTITY.md:名字和主题设定
  • BOOT.md:启动时的加载项
  • 根目录位置:~/.openclaw/workspace

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

聊天框里的快捷指令

  • /status:看看健康度和上下文
  • /context list:看看谁在贡献上下文
  • /model <m>:换个脑子(切换模型)
  • /compact:清理一下窗口空间
  • /new:重开一局
  • /stop:闭嘴/停手
  • /tts on|off:开关语音朗读
  • /think:开启深度思考模式

关键路径指引(ESSENTIAL PATH MAP)

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

  • 主配置文件:~/.openclaw/openclaw.json
  • 默认工作区:~/.openclaw/workspace/
  • 代理状态存放:~/.openclaw/agents/<cid>/
  • OAuth 和 API 密钥库:~/.openclaw/credentials/
  • 向量索引数据库:~/.openclaw/memory/<cid>.sqlite
  • 全局通用技能:~/.openclaw/skills/
  • 网关日志文件:/tmp/openclaw/*.log

语音与 TTS 设置

  • 土豪版:OpenAI / ElevenLabs
  • 白嫖版:Edge TTS(不用 API Key)
  • 自动朗读:messages.tts.auto: "always"

记忆与模型控制

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

  • 搜记忆库:memory search "X"
  • 换模型:models set <model>
  • 认证配置:models auth setup
  • 看日志:memory/YYYY-MM-DD.md

钩子与技能扩展

  • ClawHub 市场:clawhub install <slug>
  • 查看钩子:openclaw hooks list

疑难杂症排查

  • 私信不回 → 去配对列表里点批准
  • 群里装死 → 检查一下是不是设置了提及才回复
  • 认证失效 → 跑一遍 models auth setup-token
  • 网关挂了 → doctor --deep 救一下
  • 记忆错乱 → 重建索引试试

自动化与研究能力

  • 浏览器控制:browser start/screenshot
  • 子代理管理:/subagents list/info
  • 定时任务:cron list/run <cid>
  • 心跳检测:heartbeat.every: "30m"

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

云端一键部署

现在各大云平台都适配这个智能体了,要是嫌本地安装麻烦,可以直接用云端镜像一键起飞:

  • 阿里云:去官网搜 ECS 里的 clawdbot 活动
  • 腾讯云:开发者社区里有专门的部署文章
    用他们的镜像,点一下就能装好。

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

指令速查表

OpenClaw 常用命令汇总如下:

指令 用途 备注 / 参数
openclaw status 检查 Gateway 活没活着 能看健康度和上下文
openclaw health 基础体检 查核心、依赖和环境
openclaw doctor 综合诊断+开药方 加上 --deep 查得更细
openclaw onboard 新手引导向导 第一次用必跑
openclaw onboard --install-daemon 装成系统服务 可以在后台一直跑
openclaw onboard --uninstall-daemon 卸载后台服务 数据还在,放心
openclaw configure 交互式配置 设模型、通道、凭证这些
openclaw config get <path> 查某个配置项 用 JSON 路径查
openclaw config set <path> <value> 改配置 支持 JSON5 或纯文本
openclaw config unset <path> 删掉某个配置 移除键值对
openclaw channels list 看看登了哪些号 WhatsApp / Telegram 等
openclaw channels login 登新号 扫码或者授权
openclaw channels add 加机器人通道 Telegram / Discord / Slack
openclaw channels status --probe 通道测通 看看网通不通
openclaw skills list 技能列表 已装的和能用的
openclaw skills info <skill> 技能详情 看版本和参数
clawhub install <slug> 从市场装技能 官方技能库
openclaw hooks list 看钩子列表 事件触发机制
openclaw plugins list 插件列表 看装了啥插件
openclaw plugins install <id> 装插件 比如 @openclaw/voice-call
openclaw plugins enable <id> 启用插件 一般得重启网关才生效
openclaw models list 模型列表 看看哪些验证过了
openclaw models status 模型状态 现在能不能用
openclaw models auth setup-token 配模型鉴权 官方推荐姿势
openclaw memory search "X" 搜长期记忆 向量检索
openclaw memory index 重建记忆索引 记忆出 bug 了用这个
openclaw logs 看日志 默认是聚合显示的
openclaw logs --follow 实时盯日志 --json / --plain / --limit
openclaw gateway install 装网关服务 注册成系统守护进程
openclaw gateway start 启动网关 系统服务模式
openclaw gateway stop 停掉网关
openclaw gateway restart 重启网关 改完配置记得跑这个
openclaw gateway status 查网关服务状态 跟 openclaw status 不一样
openclaw browser start 启动浏览器代理 搞自动化用的
openclaw browser screenshot 网页截图
openclaw subagents list 列出子代理
openclaw cron list 列出定时任务
openclaw cron run <id> 手动跑定时任务
openclaw uninstall 连服务带数据一起删 官方卸载方式
openclaw uninstall --all --yes --non-interactive 全自动彻底卸载 状态、工作区、插件全删
openclaw uninstall --state 只删状态文件 工作区数据保留
openclaw uninstall --workspace 删工作区 代理和工作区数据清空
openclaw uninstall --service 只卸载系统服务 数据不动
openclaw uninstall --dry-run 模拟卸载 只是演习,不真删

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

为啥这玩意儿最近这么火?

  • 真有了点“钢铁侠 JARVIS”的意思:读写文件、跑终端命令、控制浏览器、收发邮件、管日历、写代码、订票、清空收件箱,它全能干。
  • 本地优先+记性好:所有的对话上下文是跨平台共享的,USER.md 和 memory/ 目录让它越用越顺手,越用越聪明。
  • 模型通吃:Claude、Gemini、OpenAI、Ollama 本地模型、Pi,想用啥用啥。
  • 技能生态炸裂:ClawdHub 上已经有 500 多个社区贡献的技能了(Slack、Discord、GitHub、浏览器控制、macOS UI 自动化……)。
  • 安装简单得像 npm install,但实际能力却非常“辛辣”(开发者自己说的)。
    它最核心的本事包括:
  • 把一句人话拆解成一步步可执行的操作
  • 自动去跑终端命令
  • 创建和修改项目文件
  • 跑代码并且自己检查结果
  • 看见报错了能自己修
    跟 Claude Code 或者 OpenCode 这种主要用来补全代码的工具不一样,OpenClaw 更像是一个有执行权限的工程经理。
  • Claude Code 和 OpenCode 强项在于代码写得好不好,懂不懂逻辑。
  • OpenClaw 强项在于能自动把整个工程流程跑完。
    手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!
    | 能力维度 | OpenClaw | Claude Code | OpenCode |
    | :— | :— | :— | :— |
    | 任务规划 | 很强 | 一般 | 一般 |
    | 自动执行 | 全套 | 部分 | 部分 |
    | 自我修复 | 有 | 没 | 没 |
    | 工程级操作 | 硬核 | 硬核 | 一般 |
    | 本地自动化 | 原生自带 | 较弱 | 较弱 |

手把手教你一键部署OpenClaw(Clawdbot),2分钟搞定!

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐