OpenClaw 中文站

外观

安装引导 ​

新手安装引导中心

2 个准备
4 步养虾，让 🦞 OpenClaw 跑起来

无需阅读，点点选选就搞定。

当前组合

部署平台
🖥 本地安装
系统环境
 macOS
API Key 准备
🔑 待获取

第一步

平台与环境

当前步骤

已自动识别  macOS ，你只需要确认或修正。

1. 先确认 🦞 OpenClaw 跑在哪里

第一步：选择路径

先决定 🦞 OpenClaw 跑在哪里

选一个就行。

2. 确认当前系统

识别错了再改。

当前建议

 macOS · 本地首选

查看系统文档

直接在 Terminal 里继续。

  • 适合想先在自己的 Mac 上跑通的用户。
  • 先打开 Terminal，后面的安装命令就在这个窗口里执行。

现在这样做

先打开 Terminal，确认等会儿在哪个窗口执行命令

查看 macOS 文档

这一步不用先学命令，只要先把终端窗口打开。

  1. 按 ⌘ Command+Space 打开 Spotlight 搜索。
  2. 输入 `Terminal`。
  3. 按 ↩ Enter，打开 Terminal 窗口。
  4. 确认后面看到的安装命令就在这个 Terminal 窗口 里执行。

如果你想用命令直接打开 Terminal

open -a Terminal

这样算准备好了

  • 你已经打开 Terminal 窗口。
  • 窗口里可以粘贴命令并按 ↩ Enter 执行。
  • 你知道接下来的安装命令就在这个 Terminal 窗口 里执行。

常见问题

  • 找不到 Terminal：先按 ⌘ Command+Space 搜索，不要自己在应用列表里翻。
  • 复制后没有反应：回到 ⌘ Command+V，再按 Terminal 窗口 粘贴。
  • 不确定是否打开对了：Terminal 窗口 通常是一个可以输入命令的黑色或浅色窗口。

确认后会自动滚到“获取 API Key”。

第二步

获取 API Key

先拿到 API Key，再继续安装。

🔑 获取 API Key

前往模型供应商网站

选一个，去拿 Key。

前往获取 API Key
前往获取 API Key
前往获取 API Key
查看模型总览

现在这样做

回到 OpenClaw 后这样填

阿里百炼 API KeyOpenClaw 配置 FAQ

以下写法按阿里百炼 Coding Plan。

安装向导里先选通用模型（OpenAI 兼容）

API Key

从阿里云控制台复制你的 Coding Plan API Key

Base URL

https://coding.dashscope.aliyuncs.com/v1

模型名

qwen3-coder-plus

备选模型

qwen3-max-2026-01-23
  1. 先去阿里云控制台创建或复制 API Key。
  2. 回到安装向导，切到“通用模型（OpenAI 兼容）”。
  3. 把 API Key、Base URL、模型名依次填进去。
  4. 先用 `qwen3-coder-plus`，能跑通再换别的。

这样算准备好了

  • 你已经拿到阿里百炼 Coding Plan 的 API Key。
  • 你知道 Base URL 要填 `coding.dashscope.aliyuncs.com/v1`。
  • 你知道模型名先填 `qwen3-coder-plus`。

常见问题

  • 如果你拿的是 Coding Plan Key，不要填普通 DashScope 兼容地址。
  • 找不到 Key：继续在控制台里找“API Key”或“创建密钥”。
  • 模型先不要自己乱试，先用 `qwen3-coder-plus` 跑通。

确认后会自动滚到“安装 / 部署”。

开始执行

完整步骤始终可见，当前步骤更突出

确认平台并拿到 API Key 后，安装步骤会自动高亮。

03

安装 / 部署

在 macOS 上安装 🦞 OpenClaw。

完成标准：终端里执行 `openclaw --version` 能看到版本号，且不再提示找不到命令。
安装说明macOS 平台文档

04

初始化 / 首次配置

运行首次配置。

完成标准：完成后已写好首份配置，并填好 阿里百炼 Coding Plan 的 API Key。
安装向导模型快速入门

05

开始使用

打开界面，开始第一步操作。

完成标准：你已经打开 Dashboard 或 TUI，并看到可继续操作的界面。
DashboardControl UI

06

安装完成

恭喜安装成功，开始您的养虾 🦞 之旅。

完成标准：安装引导到这里就完成了，接下来直接去玩、去聊、去分享。

补充说明

有问题，检查这里

这不是主流程的一部分。只有打不开、没反应时再看。

先看整体状态

openclaw status

自动检查常见问题

openclaw doctor

再看网关状态

openclaw gateway status

排查顺序

  • 先看 `openclaw status`，判断 OpenClaw 有没有正常起来。
  • 再跑 `openclaw doctor`，它会提示常见配置问题。
  • 如果前两项正常但还是不能用，再看 `openclaw gateway status`。
配对说明入门指南

补充说明

先把最容易卡住的问题放在页内

优先回答会打断安装推进的高频问题，而不是把用户再次送回文档迷宫。

为什么要先确认平台与环境？

因为很多新手不是命令不会写，而是不知道应该在哪个窗口里执行命令。先把平台与环境确认好，后面的步骤才不会走错。

为什么要先拿 API Key？

因为初始化时就要填模型凭证。先把 API Key 拿到手，后面就不会卡在配置页面里来回找。

跑起来后下一步做什么？

先用 Dashboard 或 Control UI 发出第一条测试消息，再根据需要补做配对、渠道接入和远程访问。原则是先跑起来，再做扩展。