很多人听说 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 会自动启动。


装好之后,建议先在钉钉群里试几个简单的指令,比如让它整理一段文字、查个问题、发条消息,感受一下它能做什么。