很多人听说 OpenClaw 之后,第一个问题是:我不会写代码,能装吗?
能。
安装 OpenClaw 不需要懂编程,只需要会复制粘贴命令,能看懂中文提示。整个过程大概 15 分钟,本文把每一步都写清楚了,遇到问题对照文末的常见报错处理就行。
开始之前,先准备好这两样东西
第一:一个 AI 模型的 API Key
OpenClaw 本身免费,但需要接入一个 AI 模型才能工作。推荐新手用 DeepSeek,原因很简单:国内可以直接访问,注册送免费额度,价格便宜,效果好。
获取方式:打开 platform.deepseek.com,注册账号,进入”API Keys”页面,点”创建 API Key”,复制保存好那串以 sk- 开头的字符串。
第二:一台能开终端的电脑
Windows 用”命令提示符”或”PowerShell”,macOS 用”终端”,Linux 用你熟悉的 Shell。不需要提前安装任何东西,下面会一步一步来。
第一步:安装 Node.js
OpenClaw 基于 Node.js 运行,先把它装好。
打开浏览器,访问 nodejs.cn(国内镜像,速度快),下载标注”长期维护版”(LTS)的安装包,双击安装,一路点”下一步”,保持默认选项即可。
安装完成后,打开终端,输入:
node -v
如果看到类似 v20.11.0 这样的版本号,说明安装成功。版本号大于 18 就可以,不需要是最新版。
第二步:安装 OpenClaw 中文版
终端里输入以下命令,回车:
npm install -g openclaw-cn --registry https://registry.npmmirror.com
后面那段 --registry 是切换到国内镜像,下载速度会快很多,建议带上。
安装过程大概需要 1-3 分钟,看到类似下面的输出就是成功了:
added 312 packages in 2m
npm notice created a lockfile...
验证一下:
openclaw --version
输出 OpenClaw v0.1.8-cn 说明安装正常。
如果提示”openclaw 不是内部命令”或”command not found”,说明 npm 全局路径没有加入系统环境变量。Windows 用户重启终端再试;macOS 用户在终端执行
export PATH="$PATH:$(npm bin -g)"后再试。
第三步:初始化配置
输入:
openclaw init
程序会问你几个问题,按提示填写即可:
? 选择 AI 模型提供商:DeepSeek(推荐)
? 请输入你的 DeepSeek API Key:sk-xxxxxxxxxxxxxxxx
? 选择接入平台(可多选):钉钉
? 是否开启 Web Dashboard:是
✓ 配置文件已生成:config.yml
API Key 就是第一步里保存的那串字符,直接粘贴进去。
第四步:接入钉钉(以钉钉为例)
这一步需要你在钉钉里创建一个机器人,把 Webhook 地址填进配置文件。
在钉钉里操作:
打开你想接入的钉钉群 → 点右上角”…”→ 群设置 → 智能群助手 → 添加机器人 → 自定义 → 填写机器人名称(比如”AI 助手”)→ 安全设置选”加签”→ 点完成。
完成后你会看到一个 Webhook 地址(以 https://oapi.dingtalk.com/robot/send?access_token= 开头)和一个加签密钥(以 SEC 开头),把这两个都复制保存好。
填入配置文件:
用文本编辑器打开 config.yml,找到 platforms 部分,填入:
platforms:
dingtalk:
webhook: https://oapi.dingtalk.com/robot/send?access_token=你的token
secret: SEC你的加签密钥
保存文件。
第五步:启动,开始用
终端里输入:
openclaw start
看到以下输出说明一切正常:
🦞 OpenClaw v0.1.8-cn 启动中...
✓ DeepSeek API 连接成功
✓ 钉钉机器人已激活
✓ Dashboard 地址:http://localhost:3000
🚀 OpenClaw 已就绪,等待指令
打开浏览器访问 http://localhost:3000,可以看到 Web 管理界面。
然后去钉钉群,@你刚才创建的机器人,发一句”你好”,它应该会回复你。
常见报错和解决方法
npm 下载太慢或超时
执行命令时加上 --registry https://registry.npmmirror.com,切换国内镜像源。
提示”EACCES: permission denied”
Windows:用管理员身份重新打开 PowerShell 再执行。macOS:命令前加 sudo,即 sudo npm install -g openclaw-cn。
API Key 验证失败
检查 Key 是否完整复制,前后有没有多余空格。DeepSeek Key 以 sk- 开头,注意区分字母 O 和数字 0。
钉钉机器人没有回应
先确认 OpenClaw 服务正在运行(终端没有报错),再检查 Webhook 地址和 Secret 是否完整填写,注意 Secret 要包含开头的 SEC。
重启电脑后服务停了
OpenClaw 默认不随系统启动。如果想让它一直在后台跑,安装 pm2:
npm install -g pm2
pm2 start openclaw -- start
pm2 save
pm2 startup
执行完最后一条命令,按照它给出的提示操作,之后每次开机 OpenClaw 会自动启动。
装好之后,建议先在钉钉群里试几个简单的指令,比如让它整理一段文字、查个问题、发条消息,感受一下它能做什么。