OpenClaw 安装踩坑记录

一、安装步骤

1. 环境准备

确保本地已安装 Node.js（建议v16+）和 npm/yarn 包管理器，终端可正常执行命令。

2. 核心安装命令

# 全局安装 OpenClaw 核心工具
npm install -g openclaw
# 验证安装
claw -v

二、常见问题解决

1. 飞书插件重复安装报错

报错信息

Failed to install @m1heng-clawd/feishu: plugin already exists: /Users/sunwenwen/.openclaw/extensions/feishu (delete it first)

解决方法

插件已存在导致安装冲突，先删除原有插件目录再重装：

# 删除已存在的飞书插件目录
rm -rf /Users/sunwenwen/.openclaw/extensions/feishu
# 重新安装飞书插件
claw plugin install @m1heng-clawd/feishu

2. Kimi API 配置错误导致 401 权限报错

报错信息

{"error":{"message":"Invalid Authentication","type":"invalid_authentication_error"}}

问题原因

将 Kimi (Moonshot) 官方 API Key 错误配置为 kimicode 相关密钥，密钥不匹配导致身份验证失败。

解决方法

1. 登录月之暗面开发者平台（https://platform.moonshot.cn/），获取正确的 Kimi API Key（以 sk- 开头）；
2. 替换配置中错误的密钥，确保 Authorization: Bearer 后为正确的 Kimi API Key；
3. 测试验证：

curl https://api.moonshot.cn/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer 正确的Kimi API Key" -d '{"model":"moonshot-v1-8k","messages":[{"role":"user","content":"hello"}]}'

三、验证安装

执行 claw plugin list 查看已安装插件，飞书插件正常显示且 Kimi API 测试返回正常回复，即安装配置完成。

总结

1. OpenClaw 核心安装仅需全局执行 npm 命令，验证版本即可确认基础安装成功；
2. 飞书插件重复安装报错需先删除原有目录，再重新执行安装命令；
3. Kimi API 401 报错源于密钥配置错误，需替换为月之暗面官方生成的正确 API Key；
4. BouncyCastle 是证书加解密场景的依赖库，按需引入即可。