经过前面两篇的理论学习，现在是时候动手实践了。本文将手把手带你从零开始搭建第一个 Harness，使用目前落地性最强的开源方案之一——OpenClawX。
一、OpenClawX 简介
OpenClawX（俗称「龙虾」）是基于 Hermes Agent 的社区增强版，强化了系统级操作权限和多渠道统一交互能力。它支持：
- 桌面端应用（Windows/macOS/Linux）
- CLI 命令行工具
- Web Gateway 界面
- IM 集成（飞书/钉钉/Telegram/微信）
二、安装方式选择
| 方式 | 适用场景 | 难度 |
|---|---|---|
| npm 安装 | 使用 CLI 或自建 Gateway | ⭐⭐ |
| Desktop 安装包 | 仅用桌面端，无需 Node | ⭐ |
| Docker | 容器化部署，团队协作 | ⭐⭐⭐ |
三、Desktop 安装（推荐新手）
macOS 安装步骤
- 下载
.dmg安装包 - 将
OpenClawX.app拖到「应用程序」文件夹 - 打开终端，执行以下命令解除安全限制：
xattr -cr /Applications/OpenClawX.app - 正常打开应用即可
Windows 安装步骤
- 下载
.exe安装程序 - 双击运行，按向导完成安装
- 首次启动可能需要允许防火墙访问
四、npm 安装（CLI 用户）
如果你更喜欢命令行，或者需要自建 Gateway：
# 全局安装 npm install -g @next-open-ai/openclawx # 登录模型提供商（以 DeepSeek 为例） openbot login deepseek YOUR_DEEPSEEK_API_KEY # 直接对话 openbot "总结一下当前有哪些技能"
五、配置 API Key
首次启动后，需要配置模型提供商的 API Key：
- 国内用户推荐：Kimi（Moonshot）
- 访问 https://platform.moonshot.cn/console
- 注册登录后，点击左侧「API Key 管理」
- 创建 API Key 并复制
- 海外用户推荐：Anthropic Claude 或 OpenAI
- 在 OpenClawX 设置中粘贴 API Key
- 选择默认模型（如 kimi-k2.6）
六、基础使用
1. 对话中切换 Agent
OpenClawX 支持在对话中快速切换不同的 Agent：
//select # 列出所有可用 Agent //代码助手 # 切换到名为「代码助手」的 Agent // # 切回主 Agent
2. 创建自定义 Agent
在对话中直接创建新 Agent：
创建一个前端开发专家，擅长 React 和 TypeScript，名字叫「前端助手」
系统会提示你确认创建，创建后可以用 //前端助手 切换。
3. 安装技能（Skill）
技能是 Agent 的能力扩展，以 Markdown 文件形式存在：
# 为当前 Agent 安装 PDF 处理技能 安装技能 owner/pdf-skill
七、Gateway Web 配置
启动 Gateway 获得完整的 Web 配置界面：
openbot gateway --port 38080 # 然后访问 http://localhost:38080
Web 界面提供更丰富的配置选项：
- Agent 管理（创建、编辑、删除）
- 技能市场浏览和安装
- MCP 服务器配置
- 通道集成（飞书/钉钉/Telegram）
- 任务调度设置
八、实战：创建一个 B站下载助手
让我们实战创建一个能下载 B站视频的 Agent：
- 在对话中输入：
创建一个专家，能下载 B站视频并保存到本地，名字叫「B站助手」 - 确认创建后，输入：
切换到该 Agent//B站助手 - 发送视频链接：
下载这个视频：https://www.bilibili.com/video/BV1xx411c7mD - Agent 会自动使用浏览器工具获取信息，使用 bash 工具执行下载
九、常见问题
| 问题 | 解决方案 |
|---|---|
| macOS 提示「已损坏」 | 执行 xattr -cr /Applications/OpenClawX.app |
| API Key 无效 | 检查 Key 是否复制完整，是否已充值 |
| 工具执行失败 | 检查 Docker 是否安装，沙箱权限设置 |
| 无法切换 Agent | 确保使用 // 前缀，Agent 名称正确 |
十、总结
恭喜！你已经成功搭建并运行了第一个 Harness。OpenClawX 的直观设计让新手也能快速上手，而其强大的扩展能力又能满足进阶需求。
下一篇文章，我们将探讨如何让 Agent 越用越聪明——构建验证闭环。
📚 Harness Engineering 入门到实战系列
本系列手把手教你从零开始掌握 Harness Engineering：
