OpenClaw-CN 安装与使用教程(Linux 环境)

OpenClaw-CN 安装与使用教程(Linux 环境)

本教程基于实际成功安装流程整理,适用于 Debian/Ubuntu 系统,已解决常见兼容性问题(如 报错)。
文档:http://clawd.org.cn/start/getting-started.html


  • 操作系统:Ubuntu/Debian(root 或具有 sudo 权限的用户)
  • 网络:可访问 npm 官方源(如遇慢速可配置国内镜像)
  • 推荐 Node.js 版本:v22.x LTS(v18 可能存在兼容性问题)

步骤 1:安装 Node.js 与 npm(如未安装)


✅ openclaw 安装 验证:


步骤 2:安装 pnpm 包管理器


步骤 3:配置 pnpm 全局 bin 目录(关键!)


🔍 验证配置:


步骤 4:升级 Node.js 至 v22 LTS(推荐,避免兼容问题)


⚠️ 重要:Node.js v18 可能因 限制导致 启动失败,强烈建议升级至 v22

步骤 5:全局安装 OpenClaw-CN


✅ 成功标志:


步骤 6:验证安装




这里有一个安装向导,我们(使用箭头或者空格)选择YES,选择快速安装。

1月31日这个版本增加了国内的硅基流动、阿里云百炼、DeepSeek等模型厂商。

由于Agent有可能消耗上万token,费用不好控制。我选择的是OpenCode Zen,从如下地址获取API key:https://opencode.ai/auth
选一个free的免费模型。

模型选择完成后,接下来选择通道。

  1. 跳过通信通道配置:选择“Skip for now”(后续专门配置飞书);
  2. 技能配置:选择“No”(暂不配置,后续可按需扩展);
  3. Hooks配置:选择“Skip for now”(暂不启用);
  4. 启动方式选择:选择“TUI”(终端聊天界面),出现聊天界面后输入“Hello”测试,确认安装成功;
  5. 关闭TUI界面:按ctrl+c退出,后续通过Web UI或飞书交互。


问题 原因 解决方案 未安装 pnpm 执行 未配置全局 bin 目录 执行 Node.js 版本过低(v18)或非法 NODE_OPTIONS 升级至 Node.js v22(使用 ) 命令未找到 PATH 未包含 pnpm bin 检查 是否含

🔍 排查技巧:



定期更新


卸载














版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:Ai探索者,转载请注明出处:https://javaforall.net/254250.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午1:17
下一篇 2026年3月13日 下午1:17


相关推荐

关注全栈程序员社区公众号