OpenClaw GitHub安装指南：官方详细步骤
来源：互联网 2026-05-10 21:09:21安装前准备 动手之前，咱们先看看需要准备好哪些“食材”。 大模型选择：官方首推 Kimi（Moonshot AI）、OpenAI、Anthropic 这几家，选个你手头有 API 的就行。 系统要求：门槛不算高。Windows 10 以上、macOS 12 以上，或者 Ubuntu 22.04 这类
安装前准备
动手之前，咱们先看看需要准备好哪些“食材”。
大模型选择：官方首推 Kimi（Moonshot AI）、OpenAI、Anthropic 这几家，选个你手头有 API 的就行。
长期稳定更新的攒劲资源： >>>点此立即查看<<<
系统要求：门槛不算高。Windows 10 以上、macOS 12 以上，或者 Ubuntu 22.04 这类主流 Linux 发行版都能跑。
依赖条件：核心是 Node.js（版本不能低于 v22）。好消息是，如果你用下面的一键脚本安装，它会自动帮你搞定 Node.js 和 npm/pnpm。只有走源码编译这条路，才需要提前备好 Git。
内存要求：至少给 2GB，不过现在电脑内存都不小，给到 4GB 或以上体验会更流畅。
网络环境：安装过程需要下载安装包和依赖，保持网络畅通。
权限要求：这是关键一步。在 Windows 上，记得要用管理员身份打开 PowerShell；如果在 Linux 或 macOS 上，则需要准备好 sudo 权限。
第一步：安装 OpenClaw（新手入门首选，3 分钟完成）
对于刚上手的朋友，这是最省心的路径。官方的一键脚本能自动检测环境、安装所需依赖，帮你绕过所有手动配置的坑。
具体操作因系统而异：
macOS / Linux
打开你的终端（Terminal），把下面这行命令贴进去，回车。接下来，就泡杯茶等着脚本自动安装依赖和 OpenClaw 本体吧，主要依赖就是 Node.js。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell 管理员模式）
操作顺序很重要：先在开始菜单搜索“PowerShell”，然后右键选择“以管理员身份运行”。
在打开的管理员 PowerShell 窗口里，执行这条命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
之后，脚本会自动完成从检测 Node.js 到配置 OpenClaw 的全过程，你只需耐心等待。
第二步：入门新手引导（配置模型）
安装成功只是开始，接下来这个交互式向导会带你完成最核心的配置。
安装成功后，终端会显示如下画面。这里需要你确认知情，用键盘左右方向键选择 Yes，然后回车。
接着，选择 QuickStart（快速安装模式），敲回车确认。
重头戏来了：选择模型。OpenClaw 创始人推荐的是 Moonshot AI（Kimi K2.5）、Open AI 或 Anthropic。你可以按需选择，本次演示就以国内用户常用的 Kimi K2.5 为例。
Moonshot AI（Kimi K2.5）配置步骤
首先，为了更稳定的连接，中国用户请选择 Moonshot AI .cn 这个接入点。
现在，你需要去获取 API Key。打开浏览器，访问 https://platform.moonshot.cn/console 并登录你的 Kimi 账号。
在控制台页面，找到左侧的 API Key 管理，点击“创建 API Key”，然后把生成的那一串密钥字符复制下来。
回到 OpenClaw 的配置终端，粘贴刚才复制的 API Key，回车。接着，在模型列表里选择 Moonshot/Kimi-K2.5，再次回车确认。
下一步，选择与 OpenClaw 交互的载体。作为初次体验，我们可以先跳过其他选项，直接用 tui（文本用户界面）。
选择网络搜索提供商时，自然就选 Kimi。
这时，需要你再回一次 Kimi 平台，专门为搜索功能创建一个 API Key。
复制这个新的 Key，回到 OpenClaw 配置终端粘贴，回车确认。
接下来的一系列配置，主要是为你的 OpenClaw 安装技能包。先选择 Yes 来启用技能配置。
在技能列表里，用空格键勾选你想安装的技能，然后回车确认安装所有已勾选的。
后面的几个服务，如 Google Places、Notion API、Open AI 语言服务、Sag 服务以及自动化 Hook，作为初次体验，我们都可以选择 No 或跳过，以简化配置。
第三步：使用 TUI 快速体验，开始畅聊
配置终于接近尾声。选择 TUI 并敲击回车，你的专属“小龙虾”助手就准备就绪，可以开始对话了。
第四步：查看 OpenClaw 状态
体验过后，你可能想看看它的运行状态。先连续按两次 Ctrl + C 退出 TUI 界面。
在终端输入 openclaw status，可以查看当前的核心状态。
输入 openclaw gateway status，则可以查看网关状态。
想再次打开聊天界面？输入 openclaw tui 就能随时返回。
常见问题及解决方案：未找到 OpenClaw
有时候，明明安装成功了，却在终端里敲 openclaw 命令没反应。别急，大概率是路径问题。可以按下面几步排查：
首先，检查 Node.js 是否真的装好了：node -v
然后，看看全局包安装在哪个目录：npm prefix -g
最后，检查这个目录是否在你的系统 PATH 环境变量里：echo “\$PATH”
如果发现那个 bin 目录不在 PATH 里，就需要手动把它加进去。编辑你的 shell 配置文件（比如 ~/.zshrc 或 ~/.bashrc），加入这一行：
export PATH="\$(npm prefix -g)/bin:\$PATH"
保存后，别忘了新开一个终端窗口，让配置生效。
结语
搞定！恭喜你成功打通了 OpenClaw 从入门到部署的全流程。
这份保姆级教程到此就全部解锁完毕了。你已经完成了从零到一的本地部署挑战，成功装备上了这款开源的 AI 智能体工具——你的专属“小龙虾”助手。现在，它已经全链路调试完毕，正式上线待命。各种技能随时可用，交互对话毫无限制。接下来，就带着你的新 AI 搭档，去探索更多提升效率的场景，解锁那些隐藏的玩法，正式开始你的 AI 应用之旅吧！
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
