OpenClaw 完整安装配置操作与选择指南。
wget https://open-claw.org.cn/install-cn.sh
执行完 sh脚本之后 会直接进入 如果终端的话 只要脚本成功
按 openclaw onboard 的实际流程编排，跟着选就行。

---

🛑 第一步：继续当前的安装

你当前停在风险确认界面：

I understand this is powerful and inherently risky. Continue?
│  ○ Yes / ● No

用键盘方向键选中 Yes，然后按回车继续。

💡 这只是一个免责声明。因为 OpenClaw 要对接你本地的大模型 API Key 并执行系统命令，必须由你亲自授权确认。

之后所有步骤的选择都参照下文。

---

🗺️ 第二步：Installation Mode（安装模式）

屏幕会提示你选择安装模式：

选项	说明	适合人群
QuickStart（快速开始）	只配置模型认证 + Gateway 网关，其余用默认值	新手、想快速体验
Advanced（高级模式）	完整配置工作区、网关、渠道、Skills、守护服务等 7 个步骤	需要深度定制

🟢 你应该选：QuickStart

因为我们是纯命令行服务器，先快速跑通核心链路（模型 + 飞书），后面随时可以通过重新运行 openclaw onboard 或 openclaw configure 来补配其他选项。

---

🧠 第三步：Model / Auth（模型选择与认证）

这一步给 OpenClaw 接入一个大模型作为它的“大脑”。OpenClaw 本身不带模型，需要你提供 API Key。

3.1 模型提供商选择

屏幕会列出众多支持的服务商，例如 OpenAI、Anthropic、Moonshot / Kimi、DeepSeek、MiniMax、GLM、Custom Provider 等。

🟢 你应该选：Moonshot / Kimi（即月之暗面的 Kimi 大模型）

选择理由：在国内主流模型中，Kimi K2.5 的工具调用能力和 Agent 任务完成率最高，与 OpenClaw 的“动手干活”定位最匹配。同时它拥有 256K 超长上下文，AI 不容易在执行长任务时“失忆”。

备选方案：

• DeepSeek V3.2：编程能力强、延迟低，适合偏代码场景。
• 通义千问 (qwen)：阿里云百炼平台接入顺畅，有免费额度。
• 如果你已有其他模型的 API Key：选择对应的模型名均可，国内用户也可选 MiniMax 或 GLM。

3.2 输入 API Key

选定 Kimi 后，向导会提示你输入 API Key。

🟢 你的操作：

1. 浏览器访问 https://platform.moonshot.cn（月之暗面控制台）
2. 注册/登录 → 进入「API Key 管理」→ 点击「新建 API Key」
3. 复制生成的 sk- 开头的密钥
4. 回到终端，粘贴 API Key 并按回车（终端内输入时不会显示任何字符，这是正常的安全机制）

⚠️ Kimi 的 API 基本按量付费，首次注册可能赠送免费额度。更省钱的玩法：如果你的任务偏重长上下文推理，用 Kimi K2.5；日常简单对话可备选 DeepSeek。

3.3 选择默认模型

输入 Key 后，向导通常会自动检测可用的模型列表，让你选择一个默认模型。

🟢 你应该选：moonshot-v1-auto 或 kimi-k2.5（按列表实际显示为准，选带 “Kimi” 字样的最新版本即可）

---

📁 第四步：Workspace（工作空间）

设定你的 AI 助手存放文件、记忆和技能的目录。

? Workspace directory: (~/.openclaw/workspace)

🟢 你应该选：直接按回车（使用默认路径 ~/.openclaw/workspace）

无需改动，按回车继续。

---

🌐 第五步：Gateway（网关配置）

配置 OpenClaw 网关的监听地址和端口。

5.1 监听地址

? Gateway host: (127.0.0.1)

• 127.0.0.1：仅本机访问（最安全）
• 0.0.0.0：允许局域网内其他设备访问

🟢 你应该选：直接按回车（127.0.0.1）

因为你是 Ubuntu Server 命令行环境，不需要 Web 图形界面。安全第一。

5.2 端口号

? Gateway port: (18789)

🟢 你应该选：直接按回车（18789）

⚠️ 如果将来提示端口被占用，可用 lsof -i:18789 查看并杀掉占用进程，或换一个端口。

5.3 认证 Token

向导会自动生成一个 Gateway 认证 Token。请务必将这个 Token 复制并保存好，它是你后续通过 Web 控制台管理 OpenClaw 的钥匙。如果遗忘，可用 openclaw dashboard --no-open 找回。

---

📢 第六步：Channels（配置飞书消息渠道）

QuickStart 模式下，这一步可能会被跳过。

• 如果此处直接出现了 Feishu 选项，你可以当场配置。
• 如果跳过了，别担心，后面我们单独用插件命令来配置飞书，效果完全一样。

💡 我建议先跳过，统一用下文「第四部分」的插件方式配置飞书，更灵活可控。

---

⚙️ 第七步：Daemon（安装守护进程）

? Install gateway as a background daemon? (Y/n)

• Y（是）：网关以后台系统服务方式运行，关掉终端也不停，且开机自启。
• n（否）：网关仅当前终端前台运行，关终端就停。

🟢 你应该选：Y（安装守护进程）

因为你是服务器 7×24 小时运行，必须选 Y，确保 OpenClaw 一直在后台待命。

---

🔧 第八步：Skills（技能包）

? Install default skill pack? (Y/n)

Skills 是 OpenClaw 的“技能插件”，给 AI 增加网页搜索、文件处理等扩展能力。

🟢 你应该选：n（跳过）

先用最精简的核心链路跑通，之后需要什么技能再按需安装，避免环境复杂化。

---

✅ 第九步：Health Check（健康检查）

向导完成后会自动进行健康检查，验证配置写入成功、API Key 有效、网关能正常启动。

看到绿色对勾 ✅ 即代表一切就绪。

---

🔌 第四部分：对接飞书（核心步骤）

上面的基础安装完成后，OpenClaw 核心已在后台运行。现在安装飞书插件并与你的飞书账号绑定。

4.1 在服务器上安装飞书插件

在终端中执行：

openclaw plugins install @m1heng-clawd/feishu

安装过程需要 1-2 分钟，看到 success 相关字样即为成功。完成后重启 OpenClaw 让插件生效：

openclaw restart

4.2 在飞书开放平台创建应用

1. 浏览器访问 https://open.feishu.cn/，用飞书管理员账号登录
2. 进入「开发者后台」→ 点击「创建企业自建应用」
3. 填写应用名称（随意，例如“我的龙虾助手”）→ 确认创建
4. 进入应用详情 → 点击「添加应用能力」→ 选择「机器人」→ 开启
5. 左侧找到「凭证与基础信息」→ 复制 App ID 和 App Secret 备用

4.3 配置应用权限

左侧菜单进入「权限管理」，搜索并开通以下权限：

权限名称	用途
im:message	发送和接收消息
im:message.p2p_msg:readonly	读取单聊消息
contact:user.base:readonly	获取用户基本信息

4.4 将凭证填入 OpenClaw

回到服务器终端执行：

openclaw feishu-connect

按提示依次输入刚才复制的 App ID 和 App Secret。插件会自动完成与飞书服务器的握手绑定。

4.5 发布应用

回到飞书开放平台，点击右上角「创建版本」→ 填写版本号（如 1.0.0）→ 确认发布。不发布的话，飞书机器人不会生效。

4.6 在飞书中测试

打开飞书手机或电脑客户端，进入「工作台」→ 搜索你刚才创建的应用名称，点击机器人头像，发送一条消息，如果几秒内收到 OpenClaw 的 AI 回复，说明飞书对接成功。

---

🔁 第五部分：日常维护命令速查

场景	命令
查看网关运行状态	openclaw gateway status
查看实时错误日志	openclaw logs --follow --level error
重启 OpenClaw	openclaw restart
重新进入配置向导	openclaw onboard
更新飞书插件	openclaw plugins update @m1heng-clawd/feishu

---

祝一切顺利！OpenClaw 核心链路一旦打通，AI 助手就能在飞书里随时待命了。