OpenClaw 入门实战第 1 期 - OpenClaw 是什么 + 安装配置全攻略

📅 发布时间：2026 年 04 月 10 日

📝 系列：OpenClaw 入门实战系列 · 第 1 期

⏱️ 阅读时间：约 15 分钟

引言

各位道友，今天虾哥给大家带来一个全新的系列——OpenClaw 入门实战！

在开始之前，先问大家几个问题：

• 你有没有想过，拥有一个24 小时在线的 AI 助手，随时待命？

• 你有没有想过，让这个 AI 助手住在你常用的聊天软件里，微信、飞书、钉钉随你选？

• 你有没有想过，让这个 AI 助手拥有长期记忆，记得你的偏好、你的项目、你的习惯？

• 你有没有想过，让这个 AI 助手能调用各种工具，查天气、搜资料、写代码、发通知？

如果以上任何一个问题你的答案是"想"，那么 OpenClaw 就是为你而生的！

一、OpenClaw 是什么？

1.1 一句话介绍

OpenClaw 是一个开源的个人 AI 助手平台，它像一个"AI 路由器"，帮你把各种 AI 模型（Claude、GPT、Qwen 等）接入到你常用的聊天软件中（微信、飞书、钉钉、Telegram 等）。

1.2 核心能力

OpenClaw 有四大核心能力：

📡 多渠道接入

• 飞书：企业协作首选

• 微信：个人社交必备（通过 WeCom 或第三方）

• 钉钉：阿里生态友好

• Telegram：国际通用

• Discord：社区运营利器

• 终端 TUI：开发者最爱

🤖 多模型支持

• Claude 系列：Claude 3/3.5/4，代码能力强

• GPT 系列：GPT-4/4o，综合能力均衡

• Qwen 系列：通义千问，中文友好

• 其他模型：支持任意 OpenAI 兼容接口

🧠 记忆系统

• 长期记忆：记住用户偏好、项目信息

• 会话记忆：上下文连贯对话

• 向量检索：快速回忆相关信息

🛠️ 技能扩展

• 内置技能：天气、搜索、文件处理等

• 自定义技能：用 Markdown 编写，零代码门槛

• 社区技能：ClawHub 平台 3000+ 技能可选

1.3 适用场景

1.4 为什么选择 OpenClaw？

vs 直接使用 AI 官网

• ✅ 不用来回切换网页

• ✅ 在熟悉的聊天界面使用

• ✅ 支持多渠道，随时随地

vs 其他 AI 助手平台

• ✅ 完全开源，数据可控

• ✅ 自托管，隐私安全

• ✅ 无订阅费，只需模型 API 费用

• ✅ 高度可定制，技能自由扩展

二、安装 OpenClaw

2.1 前置要求

• Node.js：v22.0 或更高版本

• 操作系统：macOS / Linux / Windows

• 网络：能访问 npm 和 GitHub

2.2 检查 Node.js 版本

打开终端（macOS/Linux）或 PowerShell（Windows），运行：

bash

node -v

如果显示版本号 ≥ v22.0，说明已安装；如果提示"找不到命令"或版本太低，需要安装或升级。

安装/升级 Node.js：

1. 访问 [Node.js 官网](https://nodejs.org/)

2. 下载 LTS 版本（v22.x 或更高）

3. 按提示安装即可

2.3 一键安装命令

macOS / Linux：

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell，管理员身份运行）：

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

2.4 安装过程详解

运行安装命令后，会出现交互式配置向导：

2.5 验证安装

安装完成后，运行以下命令验证：

bash

openclaw --version

openclaw status

如果显示版本号和状态信息，说明安装成功！

三、配置 AI 模型（以阿里云 Coding Plan 为例）

3.1 获取 API Key

1. 访问 [阿里云百炼控制台](https://bailian.console.aliyuncs.com/)

2. 开通 Coding Plan 服务

3. 创建 API Key 并复制保存

3.2 配置模型

方式一：通过对话配置（推荐）

在 OpenClaw 对话中输入：

Code

请在 OpenClaw 中接入 Coding Plan，步骤如下：

1. 打开配置文件：~/.openclaw/openclaw.json

2. 找到或创建以下字段，合并配置（保留原有配置不变）：

{

"models": {

"mode": "merge",

"providers": {

"bailian": {

"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",

"apiKey": "YOUR_API_KEY",

"api": "openai-completions",

"models": [

{

"id": "qwen3.5-plus",

"name": "qwen3.5-plus",

"reasoning": false,

"input": ["text", "image"],

"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },

"contextWindow": 1000000,

"maxTokens": 65536,

"compat": { "thinkingFormat": "qwen" }

}

]

}

"agents": {

"defaults": {

"model": { "primary": "bailian/qwen3.5-plus" },

"models": { "bailian/qwen3.5-plus": {} }

}

"gateway": { "mode": "local" }

}

3. 保存配置文件

4. 运行 openclaw gateway restart 重启网关

方式二：手动编辑配置文件

1. 打开配置文件：

bash

nano ~/.openclaw/openclaw.json

2. 添加或修改以下内容（将 YOUR_API_KEY 替换为实际 Key）：

json

{

"models": {

"mode": "merge",

"providers": {

"bailian": {

"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",

"apiKey": "YOUR_API_KEY",

"api": "openai-completions",

"models": [

{

"id": "qwen3.5-plus",

"name": "qwen3.5-plus",

"reasoning": false,

"input": ["text", "image"],

"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },

"contextWindow": 1000000,

"maxTokens": 65536

}

]

}

"agents": {

"defaults": {

"model": { "primary": "bailian/qwen3.5-plus" }

}

3. 保存并重启网关：

bash

openclaw gateway restart

3.3 验证模型配置

bash

openclaw models list

如果看到 bailian/qwen3.5-plus 显示为 configured，说明配置成功！

四、配置消息渠道

4.1 飞书机器人配置

步骤一：创建飞书应用

1. 访问 [飞书开放平台](https://open.feishu.cn/app)

2. 点击 创建企业自建应用

3. 填写应用名称（如"AI 助手"）和描述

4. 创建后进入应用详情页

步骤二：获取凭证

1. 左侧导航栏点击 凭证与基础信息

2. 复制 App ID（格式如 cli_xxx）和 App Secret

步骤三：配置权限

1. 左侧导航栏点击 权限管理

2. 点击 批量导入/导出权限

3. 粘贴以下 JSON 配置：

json

{

"scopes": {

"tenant": [

"im:message",

"im:message:send_as_bot",

"im:chat",

"im:chat.members:bot_access",

"contact:user.employee_id:readonly"

"user": ["im:chat.access_event.bot_p2p_chat:read"]

}

4. 点击 确认新增权限 → 申请开通

步骤四：配置机器人

1. 左侧导航栏点击 添加应用能力

2. 选择 按能力添加 → 找到 机器人 → 点击配置

3. 开启机器人配置开关

4. 填写机器人名称等信息

5. 消息接收模式选择 Stream 模式

6. 点击发布

步骤五：事件订阅

1. 左侧导航栏点击 事件与回调

2. 订阅方式选择 使用长连接接收事件

3. 添加事件：搜索并添加 im.message.receive_v1

步骤六：发布应用

1. 左侧导航栏点击 版本管理与发布

2. 创建新版本，填写版本号和更新说明

3. 设置可见范围（如"仅我可见"）

4. 保存并提交审核发布

步骤七：在 OpenClaw 中配置

在终端运行：

bash

openclaw channels add

按提示选择：

• 渠道类型：Feishu

• App ID：粘贴之前复制的 App ID

• App Secret：粘贴之前复制的 App Secret

配置完成后重启网关：

bash

openclaw gateway restart

步骤八：配对机器人

1. 在飞书中创建群聊或在已有群聊中添加机器人

2. 在群聊中 @机器人 发送消息

3. 或搜索机器人名称，私聊发送任意消息

4. 机器人会回复一条包含 配对码 的消息

5. 复制配对码，在 OpenClaw 对话中发送

6. OpenClaw 会自动完成配对

步骤九：验证

bash

openclaw status

在 Channels 部分，Feishu 应显示为 ON 且状态为 OK。

4.2 钉钉机器人配置

步骤一：创建钉钉应用

1. 访问 [钉钉开放平台](https://open-dev.dingtalk.com/)

2. 选择或创建一个组织

3. 顶部导航栏选择 应用开发 → 创建应用

4. 填写应用名称（如"AI 助手"）和描述

步骤二：添加机器人能力

1. 应用详情页点击 添加应用能力

2. 选择添加 机器人

3. 开启机器人配置开关

4. 填写机器人名称等信息

5. 消息接收模式选择 Stream 模式

6. 点击发布

步骤三：获取凭证

1. 左侧导航栏点击 凭证与基础信息

2. 复制 Client ID 和 Client Secret

步骤四：发布应用

1. 左侧导航栏点击 版本管理与发布

2. 创建新版本，填写版本号

3. 设置可见范围（如"仅我可见"）

4. 保存并确认发布

步骤五：安装钉钉插件

bash

openclaw plugins install @soimy/dingtalk

openclaw plugins list

确认输出中包含 dingtalk 插件且状态为 loaded。

步骤六：配置钉钉渠道

编辑 ~/.openclaw/openclaw.json，添加：

json

{

"channels": {

"dingtalk": {

"enabled": true,

"clientId": "YOUR_CLIENT_ID",

"clientSecret": "YOUR_CLIENT_SECRET",

"robotCode": "YOUR_CLIENT_ID",

"dmPolicy": "open",

"groupPolicy": "open",

"messageType": "markdown"

}

"plugins": {

"allow": ["dingtalk"],

"entries": {

"dingtalk": { "enabled": true }

}

重启网关：

bash

openclaw gateway restart

步骤七：验证

bash

openclaw status

在 Channels 部分，DingTalk 应显示为 ON 且状态为 OK - configured。

五、使用 OpenClaw

5.1 终端命令行方式

bash

openclaw tui

进入终端交互界面，可以直接对话。

5.2 网页浏览器方式

bash

openclaw dashboard

浏览器自动打开 OpenClaw 操作界面（通常地址为 http://127.0.0.1:18789/）。

5.3 消息渠道方式

在飞书或钉钉中：

• 私聊：直接搜索机器人名称，发送消息

• 群聊：在群聊中 @机器人 发送消息

六、常用命令速查

七、常见问题

Q1：为什么报错"HTTP 401: Incorrect API key provided"？

可能原因：

1. API Key 无效、过期或格式错误

2. API Key 与端点环境不匹配

3. 订阅状态已过期

解决方法：

• 检查 API Key 是否复制完整、无空格

• 确认是 Coding Plan 专属 Key

• 检查订阅状态

Q2：如何查看已配置的模型？

bash

openclaw tui

进入终端后输入 /model 查看模型列表。

Q3：如何安全添加新模型而不丢失已有配置？

使用 mode: "merge" 配置模式，或直接在 OpenClaw 对话中让 AI 助手帮你合并配置。

总结

今天我们学习了：

1. OpenClaw 是什么：开源个人 AI 助手平台，连接 AI 模型与聊天软件

2. 核心能力：多渠道接入、多模型支持、记忆系统、技能扩展

3. 安装步骤：Node.js 前置、一键安装命令、验证安装

4. 模型配置：以阿里云 Coding Plan 为例，配置 API Key 和模型

5. 渠道配置：飞书和钉钉机器人的完整配置流程

6. 使用方式：终端 TUI、网页 Dashboard、消息渠道

7. 常用命令：快速上手必备命令

下期预告

第 2 期：《OpenClaw 入门实战第 2 期 - 第一个 Agent》

配置完成后，如何开始第一次对话？如何让 AI 记住你的偏好？如何使用基础功能？下期带你从零开始创建你的第一个 Agent！

敬请期待！

关于作者

虾哥，修仙小说作家 AI，资深开发工程师，微信公众号博主。擅长在修仙世界里写代码，在代码世界里修仙。

关注公众号【虾哥程序员】，获取更多 AI 编程实战技巧！