doc: openclaw guide-macos

Author: Maotechh

.gitignore

@@ -0,0 +1,3 @@
+/.obsidian
+.DS_Store
+/.claude

.obsidian/app.json

@@ -13,18 +13,21 @@ tags:
 
 # Windows 环境下 OpenClaw 完全部署与配置教程
 
+[macOS 安装教程点我](https://geekpie.club/posts/blog/2026-03-10-openclaw-macos/)
 OpenClaw 是近期备受关注的开源 AI Agent 工具，但官方对 Windows 的原生生态支持相对有限。在实际部署过程中，经常会遇到关于 Node.js 环境、执行策略设限和依赖下载的问题。
 
 本文将结合实际安装记录以及社区的解决方案，提供一份详尽的 Windows 端安装、配置直至接入工具及大模型的完整流程。
 
 ---
 
-## 一、 环境准备
+## 一、环境准备
 
 由于 OpenClaw 对 Node.js 版本有要求，为避免后续权限和全局变量导致的问题，强烈建议使用 nvm（Node Version Manager）来进行环境管理。
 
 ### 1. 安装 nvm for Windows
 
+> **⚠️ 强烈注意**：在安装 nvm 之前，**如果你的电脑上已经安装过 Node.js，请严格卸载旧版本！** 包括清理掉全局模块和环境变量（如 `C:\Program Files\nodejs` 等），否则安装 nvm 后可能会导致极其混乱的路径冲突。
+
 前往 GitHub Releases 页面下载最新的 `nvm-setup.exe`：[nvm-windows releases](https://github.com/coreybutler/nvm-windows/releases)
 
 安装过程保持默认并一路 Next 即可。
@@ -53,7 +56,7 @@ nvm use 22.22.0
 
 ---
 
-## 二、 安装与启动 OpenClaw
+## 二、安装与启动 OpenClaw
 
 ### 1. 核心安装命令
 
@@ -106,18 +109,53 @@ openclaw onboard --flow quickstart
 
 ![API Key配置](/res/api-key-config.png)
 
-- **连接频道/Tools/Skills**：官方建议 Windows 原生最好通过 WSL2 运行飞书等 IM 插件，因此在此步骤的连接频段建议先 `skip`，后续单独安装管理。
+- **Select Channel/Search Provider/Skills**：官方建议 Windows 原生最好通过 WSL2 运行飞书等 IM 插件，因此在此步骤的连接频段建议先 `skip`，后续单独安装管理。
 
 ![跳过通讯配置](/res/skip-channel.png)
 
-- **Hooks**：全部勾选。
+- **Hooks**：全部勾选。上下箭头选择，空格选中/取消选中，回车提交。
 - **Hatch your bot**：选择 `open in web ui`，将启动网关服务并在浏览器弹出控制台页面 `http://127.0.0.1:18789/`。控制台启动完成并可发消息回复，即代表基础运行成功。
 
 ![Web控制台](/res/openclaw-web.png)
 
 ---
 
-## 三、 接入飞书平台应用全流程
+## 三、配置 AI 模型
+
+如果在初始化向导中跳过了模型配置，或者后续需要额外接入其他 AI 模型（如 DeepSeek、豆包等），可以通过命令行进行配置：
+
+### 1. 查看可用模型
+
+```powershell
+openclaw models list
+```
+
+### 2. 配置 API Key 与默认模型
+
+以配置 DeepSeek 为例：
+
+```powershell
+openclaw config set models.deepseek.apiKey "your-api-key-here"
+openclaw config set agents.defaults.model "deepseek/deepseek-chat"
+```
+
+支持的模型提供商包括：
+- Anthropic Claude
+- OpenAI GPT
+- DeepSeek
+- 豆包（Doubao）
+- Google Gemini
+- 本地模型（Ollama）
+
+### 3. 验证配置
+
+```powershell
+openclaw health
+```
+
+---
+
+## 四、接入飞书平台应用全流程
 
 ### 1. 手动安装飞书插件
 由于初始化向导在 Windows 可能报错缺失路径，请在 PowerShell 中直接调用 CLI 执行：
@@ -173,7 +211,7 @@ openclaw plugins install @m1heng-clawd/feishu
 
 ---
 
-## 四、 常用命令排查与修复（排查/修复必备）
+## 五、常用命令排查与修复（排查/修复必备）
 
 如果在后续配置、开发途中遭遇服务状态异常卡死，下列终端命令将非常高效：
 
@@ -194,5 +232,7 @@ openclaw logs follow
 openclaw restart
 ``` 
 
+完整文档：[https://docs.openclaw.ai](https://docs.openclaw.ai)
+
 整个配置与连通流程到此全部走通。
 —— GeekPie 社团，2026 年 3 月 9 日