☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
图:openclaw 怎么装,小白也能看懂的安装步骤
不少朋友第一次听说 OpenClaw 时,最常问的一句是:我完全不会编程,能顺利装上吗?
完全可以。
安装 OpenClaw 并不要求任何编码基础,只需掌握复制粘贴命令、能理解中文提示即可。全程耗时约 15 分钟,本文已将每一步拆解得足够细致,若中途遇到异常,可直接参考文末的典型错误排查指南。
安装前,请先确认以下两项准备就绪
第一:一个可用的 AI 模型 API Key
OpenClaw 本体免费开源,但需调用外部大模型才能运行。对新手而言,DeepSeek 是更友好的选择——无需科学上网、注册即送试用额度、响应稳定且性价比高。
获取方式:访问 platform.deepseek.com 完成注册,进入「API Keys」页面,点击「创建 API Key」,将生成的以 sk- 开头的密钥完整复制并妥善保存。
第二:一台支持终端操作的电脑
Windows 系统可使用「命令提示符」或「PowerShell」;macOS 用户请打开「终端」;Linux 用户则任选常用 Shell 即可。无需预先安装其他工具,后续步骤会手把手引导。
第一步:安装 Node.js
OpenClaw 依赖 Node.js 运行环境,因此需优先安装。
请在浏览器中打开 nodejs.cn(国内镜像站,下载更快),下载标注为「长期维护版(LTS)」的安装包,双击运行后一路点击「下一步」,保持默认设置即可完成安装。
安装完毕后,打开终端,输入以下命令:
<code>node -v</code>
若返回类似 v20.11.0 的版本号,则表示安装成功。只要版本 ≥ 18 即可满足要求,不必追求最新版。
第二步:安装 OpenClaw 中文版
在终端中输入如下命令并回车执行:
<code>npm install -g openclaw-cn --registry https://registry.npmmirror.com</code>
末尾的 --registry 参数用于指定国内镜像源,大幅提升下载速度,强烈建议保留。
整个安装过程通常耗时 1–3 分钟,当看到类似以下输出时,说明安装已完成:
<code>added 312 packages in 2mnpm notice created a lockfile...</code>
随后验证是否安装成功:
<code>openclaw --version</code>
若显示 OpenClaw v0.1.8-cn,即代表安装无误。
第三步:初始化配置
在终端中执行:
<code>openclaw init</code>
程序将依次提出几个问题,请根据提示填写对应内容:
<code>? 选择 AI 模型提供商:DeepSeek(推荐)? 请输入你的 DeepSeek API Key:sk-xxxxxxxxxxxxxxxx? 选择接入平台(可多选):钉钉? 是否开启 Web Dashboard:是✓ 配置文件已生成:config.yml</code>
其中 API Key 就是你第一步中复制保存的那串字符,直接粘贴即可,注意不要遗漏或误加空格。
第四步:对接钉钉(以钉钉为例)
此步骤需要你在钉钉群内新建一个自定义机器人,并将获得的 Webhook 地址与加签密钥填入配置文件。
具体操作如下:
进入目标钉钉群 → 点击右上角「…」→「群设置」→「智能群助手」→「添加机器人」→「自定义」→ 输入机器人名称(如“AI 助理”)→ 安全设置选择「加签」→ 点击「完成」。
完成后,页面会显示一个 Webhook 地址(以 https://oapi.dingtalk.com/robot/send?access_token= 开头)以及一个加签密钥(以 SEC 开头),请一并复制保存。
接着编辑配置文件:
用任意文本编辑器打开项目根目录下的 config.yml,定位到 platforms 区域,按格式填写信息:
<code>platforms:dingtalk:webhook: https://oapi.dingtalk.com/robot/send?access_token=你的tokensecret: SEC你的加签密钥</code>
修改完成后记得保存文件。
第五步:启动服务,正式使用
在终端中输入:
<code>openclaw start</code>
若出现如下输出,说明所有组件均已正常加载:
<code>? OpenClaw v0.1.8-cn 启动中...✓ DeepSeek API 连接成功✓ 钉钉机器人已激活✓ Dashboard 地址:http://localhost:3000? OpenClaw 已就绪,等待指令</code>
此时打开浏览器,访问 http://localhost:3000,即可进入可视化管理后台。
然后回到钉钉群中,@你刚刚创建的机器人,发送一句“你好”,它应能即时响应。
常见报错及应对方案
npm 下载缓慢或连接超时
执行命令时加上 --registry https://registry.npmmirror.com 参数,强制使用国内镜像源。
提示 “EACCES: permission denied”
Windows 用户:请右键以「管理员身份运行」PowerShell 后重试;macOS 用户:在命令前添加 sudo,例如 sudo npm install -g openclaw-cn。
API Key 校验失败
检查是否完整复制了密钥,首尾是否有隐藏空格;确认 Key 是以 sk- 开头的标准格式,注意区分字母 O 和数字 0。
钉钉机器人无响应
首先确认 OpenClaw 服务仍在运行(终端未报错退出),再核对 config.yml 中的 Webhook 地址和 Secret 是否准确无误,特别注意 Secret 必须包含开头的 SEC 前缀。
重启电脑后服务自动停止
OpenClaw 默认不随系统开机自启。如需长期后台运行,可借助 pm2 工具实现:
<code>npm install -g pm2pm2 start openclaw -- startpm2 savepm2 startup</code>
执行最后一条命令后,按终端给出的操作指引完成配置,此后每次开机 OpenClaw 将自动启动。
安装完成后,建议先在钉钉群中尝试几条基础指令,比如让机器人帮你润色文案、解答常识问题、定时发送提醒等,快速熟悉它的能力边界与交互逻辑。


















