WinlatorXR
881.97M · 2026-02-04
OpenClaw（原Clawdbot，曾用名Moltbot）是一款开源的高权限AI智能体框架，允许用户在本地环境中部署具备系统级操作能力的AI助手。该项目在短短几周内经历了三次命名变更：从最初的Clawdbot，到因商标问题更名为Moltbot，最终在2025年1月正式定名为OpenClaw。本指南将统一使用"OpenClaw"指代该工具，但命令行操作中可能仍会看到clawdbot或openclaw的用法，这取决于您安装的版本。
OpenClaw采用独特的"网关+渠道"架构设计：
选择Kimi 2.5（特别是Kimi Code版本）作为OpenClaw的底层模型具有以下优势：
推荐配置：
重要安全提示： 由于OpenClaw具备执行系统命令、读写文件的高权限特性，强烈建议在以下环境部署：
绝对避免在生产环境服务器或存储重要数据的机器上直接安装，以防AI误操作导致数据丢失。
如果您选择手动安装而非使用阿里云一键部署，需要准备以下环境：
步骤1：安装Git
sudo apt update
sudo apt install git -y
步骤2：安装Node.js 22 推荐使用NVM（Node Version Manager）管理Node版本：
国内用户使用Gitee镜像加速：
curl -o- | bash
海外用户使用官方源：
curl -o- | bash
重新加载环境变量并安装Node 22：
source ~/.bashrc
nvm install 22
node -v # 确认输出v22.x.x
OpenClaw提供了一键安装脚本，支持跨平台部署：
curl -fsSL | bash
该脚本会自动检测操作系统，安装必要的依赖，并配置基础环境。安装过程通常需要3-5分钟，取决于网络状况。
安装完成后，运行初始化命令：
openclaw onboard
关键配置节点详解：
1. 风险确认 首次运行会显示免责声明，使用左右方向键选择"Yes"确认您理解AI助手的高权限风险，按回车继续。
2. 模式选择
选择QuickStart进入下一步。
3. 模型提供商配置 在Model/auth Provider选择界面，选择Kimi Code API Key。
关键提示：Kimi、MiniMax、GLM等国内模型分为国际版和国内版。OpenClaw默认集成的是国际版接口地址（platform.moonshot.ai），如果您购买的是国内版Kimi Code套餐，可能需要手动调整API端点配置。
输入您从Moonshot AI平台获取的API Key：
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
4. 默认模型设置 选择将Kimi设为默认模型（Set as default），这样在后续对话中无需每次都指定模型。
5. 聊天界面选择 系统会询问"Where do you want to hatch your bot?"（在哪里孵化您的机器人）：
建议：新手选择Web UI更友好，但TUI在远程服务器上更稳定。两者可同时安装，通过openclaw tui或openclaw web分别启动。
6. Skill选择 初次配置建议先跳过（选择"No"），待系统运行正常后再通过插件机制添加Skill。如果已有特定需求（如需要Git操作、文件搜索等），可以在此勾选相应Skill。
7. Hooks配置（重要） 强烈建议开启以下三个Hook：
| Hook名称 | 功能描述 | 必要性 |
|---|---|---|
| Startup Injection | 会话开始时注入Markdown文件（类似README），提供上下文指引 | |
| Operation Logging | 记录会话中执行的所有命令与操作上下文，便于审计和排错 | |
| Session Summary | 新会话开始时保存当前会话上下文摘要，实现跨会话记忆 |
使用空格键选中这些选项，回车确认。
8. 网关重启 如果系统检测到已有网关运行或之前安装过，建议选择重启（Restart）以确保配置生效。
初始化完成后，通过以下命令验证安装：
启动TUI界面：
openclaw tui
启动Web界面（默认端口3000）：
openclaw web
如果成功进入对话界面，说明基础安装完成。此时您可以通过终端或网页与OpenClaw进行交互，但尚未接入飞书等IM平台。
飞书接入是OpenClaw最具实用价值的配置之一，它允许您通过手机端的飞书App随时与AI助手交互，实现真正的移动办公自动化。
OpenClaw通过插件机制支持飞书接入。在终端执行：
openclaw plugins install @m1heng-clawd/feishu
或旧版命令（取决于您的OpenClaw版本）：
clawdbot plugins install @m1heng-clawd/feishu
安装成功后会显示插件信息，包括版本号和基本使用说明。
步骤1：登录飞书开放平台 访问 open.feishu.cn/app?lang=zh… 并使用企业管理员账号登录。
步骤2：创建应用 点击"创建企业自建应用"，填写：
步骤3：添加机器人能力 在应用管理页面左侧导航栏，点击"添加应用能力" → 选择"机器人" → 点击"添加"。这一步是必需的，因为后续的权限申请和事件订阅都依赖于机器人能力。
步骤4：获取凭证 进入"凭证与基础信息"页面，复制以下两个关键参数：
安全提示：App Secret相当于应用密码，请妥善保管，不要泄露到公共仓库。
回到终端，执行以下命令配置飞书连接参数：
# 设置App ID
openclaw config set channels.feishu.appId "cli_xxxxxxxxxx"
# 设置App Secret
openclaw config set channels.feishu.appSecret "xxxxxxxxxx"
# 启用飞书渠道
openclaw config set channels.feishu.enabled true
# 设置连接模式为WebSocket（推荐，稳定性更好）
openclaw config set channels.feishu.connectionMode websocket
# 配置私聊策略（pairing表示需要配对，open表示开放）
openclaw config set channels.feishu.dmPolicy pairing
# 配置群聊策略（allowlist表示白名单，open表示开放）
openclaw config set channels.feishu.groupPolicy allowlist
# 群聊中需要@机器人才能触发（减少误触发）
openclaw config set channels.feishu.requireMention true
关键命令：重启网关 配置完成后，必须重启网关才能生效：
openclaw gateway restart
常见错误：如果在飞书端配置事件订阅时提示"未建立长连接"，90%是因为忘记执行gateway restart命令。
步骤1：事件配置 进入飞书应用的"事件与回调"页面：
添加必要事件： 点击"添加事件"，在"消息与群组"分类下勾选：
步骤2：权限配置 进入"权限管理"页面，点击"批量开通权限"或逐个搜索添加以下权限：
用户身份权限（User Scopes）：
contact:user.base:readonly —— 获取用户基本信息应用身份权限（Tenant Scopes）：
im:message —— 收发消息的基础权限im:message.p2p_msg:readonly —— 读取私聊消息（需要机器人能力）im:message.group_at_msg:readonly —— 读取群聊中被@的消息（需要机器人能力）im:message:send_as_bot —— 以机器人身份发送消息im:resource —— 上传图片或文件资源快捷导入方式：部分飞书版本支持JSON批量导入，可使用以下JSON：
{
"scopes": {
"tenant": [
"contact:user.base:readonly",
"im:ch@t",
"im:ch@t:read",
"im:ch@t:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": []
}
}
创建版本： 进入"版本管理与发布"页面，点击"创建版本"：
申请发布： 提交发布后，需要企业管理员审核。如果是个人测试，可以创建"试用版本"直接发布。
移动端测试： 打开飞书App，在搜索框输入应用名称（如"OpenClaw助手"），找到机器人后：
如果需要更灵活的群聊控制，可以通过以下配置实现：
开放群聊（无需白名单）：
openclaw config set channels.feishu.groupPolicy open
openclaw config set channels.feishu.allowFrom ['*']
openclaw gateway restart
白名单模式（仅特定群可用）：
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.allowFrom ['oc_xxxxxxxx', 'oc_yyyyyyyy'] # 群ID列表
群ID获取方法：在飞书群设置中查看"群ID"（需要管理员权限），或通过机器人被加入群时触发的事件日志获取。
为确保服务稳定性，建议配置备用模型。当Kimi 2.5服务不可用时，自动切换到其他模型：
# 添加备用模型（以通义千问为例）
openclaw models fallbacks add qwen/qwen-coder-plus
# 查看当前模型列表
openclaw models list
# 切换默认模型（临时）
openclaw models set kimi-code/kimi-for-coding
OpenClaw的核心价值在于其丰富的Skill生态系统。访问社区精选库： github.com/VoltAgent/a…
常用Skill推荐：
Skill安装示例：
# 搜索Skill（部分版本支持）
openclaw skills search git
# 安装Skill
openclaw skills install git-helper
开启Memory Hook后，OpenClaw会自动维护长期记忆。您还可以通过以下命令管理会话：
# 开启新会话（清除当前上下文）
/new
# 查看会话历史（取决于具体Skill）
/history
# 手动保存会话摘要
openclaw session save "项目名称-进度讨论"
通过飞书接入后，您可以在手机上进行简单的代码审查：
配置定时任务Skill后，可以实现：
当收到服务器告警时：
df -hQ：配置事件订阅时提示"未建立长连接" A：检查以下几点：
openclaw gateway restartopenclaw logs或openclaw gateway --verboseQ：机器人显示已上线，但发送消息无响应 A：排查步骤：
im.message.receive_v1事件im:message相关权限Q：群聊中@机器人无反应 A：
requireMention: true但未正确@机器人groupPolicy是否为open或该群在白名单中im:message.group_at_msg:readonly权限Q：安装时提示"npm install failed"或内存错误 A：这是Node.js内存不足导致的。解决方案：
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
Q：Kimi API返回错误 A：检查：
kimi-code/kimi-for-coding而非旧版名称）长期运行稳定性：
pm2或systemd将OpenClaw网关作为系统服务运行，避免SSH断开后进程终止响应速度优化：
~/.openclaw目录，其中包含所有配置和记忆数据groupPolicy: open，防止机器人被滥用OpenClaw可以加载Claude Code的Skill文件，实现生态共享：
# 让OpenClaw模拟Claude Code的Skill行为
"你可以模拟我的Claude Code Skill操作方式..."
或直接导入Skill文件到~/.openclaw/skills目录。
如果不想手动配置环境，可以使用阿里云轻量应用服务器的一键部署镜像：
OpenClaw支持同时接入多个IM平台：
# 同时启用飞书和T@elegrimm
openclaw config set channels.feishu.enabled true
openclaw config set channels.telegram.enabled true
openclaw gateway restart
这样您可以在飞书、T@elegrimm、Discord等多个渠道同时使用同一个AI助手，所有会话上下文共享。
通过本指南的详细配置，您已经成功搭建了一套基于Kimi 2.5的智能助手系统，并通过飞书实现了移动端的无缝接入。这套系统的核心价值在于：
随着OpenClaw生态的快速发展，未来可以期待更多原生Skill的支持、更完善的Web管理界面，以及更智能的多Agent协作能力。建议定期关注官方文档更新和社区Skill仓库，持续发掘OpenClaw+Kimi 2.5组合的无限可能。
快速参考命令卡：
openclaw tui # 启动终端界面
openclaw gateway restart # 重启网关（配置后必做）
openclaw config get channels.feishu # 查看飞书配置
/new # 开启新会话（TUI内）
祝您使用愉快，打造属于自己的超级AI助手！
本指南基于OpenClaw 2025年1月版本编写，部分命令和界面可能随版本更新有所变化，请以官方最新文档为准。
参考链接：news.qq.com/rain/a/2026…
