好的这就将您提供的四个链接内容整合成一份完整的笔记。笔记将涵盖项目背景、核心特性以及最关键的安装部署全攻略。OpenClaw 个人AI助手项目背景与安装部署完全笔记一、项目概览与核心特性OpenClaw是一个开源免费的个人AI助手它的核心理念是让AI真正为你“做事”同时保护你的数据隐私。1.1 核心能力运行在你的设备上支持Mac、Windows、Linux。数据默认私有你的信息只属于你。任意聊天应用集成可通过飞书、企业微信、钉钉、QQ、Telegram、Discord等常用应用与之对话支持私聊和群聊。持久记忆能够记住你的偏好和上下文成为独一无二的、专属你的AI。强大的行动力浏览器控制可以浏览网页、填写表单、从任何网站提取数据。系统访问能够读写文件、运行Shell命令、执行脚本。你可以选择授予完全访问权限或使用沙箱模式。技能与插件支持使用社区开发的“技能”扩展功能甚至可以自己编写新技能。典型应用场景清理收件箱、发送邮件、管理日历、办理在线值机等。1.2 项目资源与社区官方代码仓库GitHub - openclaw/openclaw (主要语言为TypeScript)中文社区分支clawd.org.cn - 专门为中文用户提供服务提供国内镜像加速并定期与上游仓库同步更新。免费教程站Claw101.com - 提供从安装到配置的详细免费教程。以下是中文社区分支https://clawd.org.cn/# 在 PowerShell 中运行使用国内镜像iwr-usebhttps://clawd.org.cn/install.ps1-OutFileinstall.ps1;./install.ps1-Registryhttps://registry.npmmirror.com这个App ID需要去飞书开放平台的后台获取。我来一步步告诉你怎么找到它 获取飞书 App ID 的完整步骤第一步进入飞书开放平台后台打开浏览器访问飞书开放平台https://open.feishu.cn/app用你的飞书账号扫码登录第二步找到你的应用登录后你会看到我的应用页面这里会列出你创建的所有应用 如果你已经创建过应用直接点击你要配置的那个如果还没创建点击**“创建企业自建应用”**填写应用名称随便写比如Claude插件测试填写应用描述上传一个图标可以用飞书默认的点击确定创建第三步找到 App ID进入应用详情页后 在左侧导航栏找到“凭证与基础信息”点击进入后在页面的**“应用凭证”**区域你会看到两个关键信息 App ID以cli_开头- 这就是你要的App Secret- 先不用管后面可能需要第四步复制粘贴直接复制那个以cli_开头的 App ID粘贴到 Claude Code 的输入框里就行。 位置示意图文字版飞书开放平台 我的应用 点击你的应用 ↓ 左侧导航栏凭证与基础信息 ↓ 右侧页面应用凭证区域 ↓ ┌─────────────────────────────────┐ │ App IDcli_9f8d7s6f5dxxx1d │ ← 复制这个 │ App Secret****************** │ └─────────────────────────────────┘⚠️ 常见问题Q我没有创建过应用怎么办A那就按第二步说的先创建一个企业自建应用。创建过程很简单只需要填个名字和描述不需要审核 。Q创建应用需要付费吗A完全免费。企业自建应用在内部使用是不收费的 。QApp Secret 也要填吗A目前 Claude Code 只问你要 App ID先填这个就行。如果后续提示要 Secret再回去复制 。Q为什么我的 App ID 不显示A可能是刚创建的应用还没刷新退出重新进一下应用详情页就好了。你现在就去飞书开放平台找找看复制那个cli_开头的 ID 回来粘贴就行配置OpenClaw飞书消息有两种方式基础对话配置让AI能在飞书聊天和进阶消息发送让AI能发图片等富媒体。根据你的需求我整理了完整流程 一、基础配置让OpenClaw接入飞书1. 安装飞书插件如果你还没装飞书插件先执行openclaw-cn pluginsinstallm1heng-clawd/feishu或者用阿里云教程中的插件名 openclaw-cn pluginsinstallopenclaw-cn/feishu2. 配置飞书凭证方式A通过命令行配置推荐# 进入配置向导openclaw-cn config# 按提示选择# - Local本机# - 选择渠道 → Feishu/Lark# - 输入你的 App ID 和 App Secret# - 域名选择 China# - 确认接受群聊方式B直接设置更快捷openclaw-cn configsetchannels.feishu.appId你的AppIDopenclaw-cn configsetchannels.feishu.appSecret你的AppSecretopenclaw-cn gateway restart启动有问题的。powershell-ExecutionPolicyBypass-Commandopenclaw-cn gateway3. 飞书开放平台必须配置登录飞书开放平台完成以下步骤 步骤操作内容关键点① 创建应用创建企业自建应用已有的话直接用② 添加机器人应用能力 → 添加机器人必选③ 配置事件事件与回调 → 使用长连接接收事件⚠️ 选长连接不要填URL④ 添加事件添加im.message.receive_v1收消息必备⑤ 配置权限批量导入权限JSON见下方权限要全⑥ 发布版本版本管理与发布 → 创建版本必须发布才生效批量导入的权限JSON{scopes:{tenant:[aily:file:read,aily:file:write,im:message,im:message.group_at_msg:readonly,im:message.p2p_msg:readonly,im:message:send_as_bot,contact:user.employee_id:readonly],user:[aily:file:read,aily:file:write]}}4. 配对机器人配置完成后在飞书找到你的机器人发送任意消息它会回复一个配对码在OpenClaw WebUI或终端执行openclaw-cn pairing approve feishu[配对码]️ 二、进阶配置让AI发送图片等富媒体OpenClaw默认的message工具在飞书上不能直接发本地图片会发成文件路径。解决方案是在TOOLS.md里告诉AI正确方法 。1. 编辑TOOLS.md文件在OpenClaw工作区找到或创建TOOLS.md一般在~/.openclaw/或项目根目录添加以下内容## 飞书发图片重要 OpenClaw 的 message 工具目前不能直接在飞书发送本地图片。 **正确方法用 exec 工具执行 curl 调飞书 API分三步** ### Step 1: 获取 tenant_access_token APP_SECRET$(python3 -c import json; cjson.load(open(/root/.openclaw/openclaw.json)); print(c[channels][feishu][appSecret])) TOKEN$(curl -s -X POST https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal \ -H Content-Type: application/json \ -d {app_id:你的APP_ID,app_secret:$APP_SECRET} \ | python3 -c import json,sys; print(json.load(sys.stdin)[tenant_access_token])) ### Step 2: 上传图片获取 image_key IMAGE_KEY$(curl -s -X POST https://open.feishu.cn/open-apis/im/v1/images \ -H Authorization: Bearer $TOKEN \ -F image_typemessage \ -F image/path/to/your/image.png \ | python3 -c import json,sys; print(json.load(sys.stdin)[data][image_key])) ### Step 3: 发送图片消息 curl -s -X POST https://open.feishu.cn/open-apis/im/v1/messages?receive_id_typeopen_id \ -H Authorization: Bearer $TOKEN \ -H Content-Type: application/json \ -d {receive_id:收信人open_id,msg_type:image,content:{\image_key\:\$IMAGE_KEY\}} **注意事项** - 你的 App ID: cli_xxxxx替换 - 你的 open_id: ou_xxxxx替换 - 支持图片格式: JPEG, PNG, WEBP, GIF, TIFF, BMP, ICO2. 工作原理每次OpenClaw启动AI会自动读取TOOLS.md当你说发张图片给我AI会按文档步骤执行用exec获取token上传图片获取image_key调用飞书API发送图片完全不需要改代码纯自然语言配置⏰ 三、定时推送消息到飞书1. 通过对话创建定时任务在OpenClaw对话中直接说每天上午9点给我发送今日天气预报发送到飞书群或者指定Webhook每2小时检查一次服务器状态把结果发到飞书群webhook是https://open.feishu.cn/open-apis/bot/v2/hook/xxxxx2. 获取群机器人Webhook地址如果想推送到指定群飞书群聊 → 设置 → 群机器人添加自定义机器人 → 复制Webhook地址在OpenClaw中创建任务时附上这个地址3. 管理定时任务查看任务列出所有定时任务取消任务取消早间天气预报任务️ 四、常用排查命令用途命令查看插件状态openclaw plugins list重启网关配置生效openclaw gateway restart查看实时日志openclaw logs follow运行诊断openclaw doctor检查飞书通道openclaw config get channels.feishu 总结基础对话装插件配凭证飞书后台事件用长连接图片发送在TOOLS.md写curl步骤AI自动学会定时推送直接对话创建任务可配群Webhook你现在基础配置完成了吗如果遇到具体报错可以发给我帮你排查手机下载之后只需要在飞书上问答机人就可以操作你电脑啦不小心关掉了执行启动网关即可openclaw-cn gateway让openclaw-cn gateway在 Windows 11 上开机自启最推荐的方法是使用它内置的服务安装命令。这个方法最干净、最规范可以让它在后台稳定运行。你只需要在命令提示符管理员模式或 PowerShell管理员模式中运行这一条命令就可以了openclaw-cn gatewayinstall这条命令会帮你完成所有设置主要做这几件事创建自启任务在 Windows 的“任务计划程序”中创建一个名为OpenClaw Gateway或类似名称的开机启动任务。生成启动脚本在 OpenClaw 的配置目录如C:\Users\你的用户名\.openclaw\下生成一个gateway.cmd启动脚本里面包含了正确的环境变量和启动命令。配置开机启动设置好后每次 Windows 启动时openclaw-cn gateway就会在后台自动运行监听默认端口通常是18789。 如果你更喜欢手动设置如果你希望更清楚地知道每一步在做什么或者想自定义一些启动参数也可以手动设置。之前的回复里提到的两种方法依然有效方法A添加到启动文件夹创建一个指向openclaw-cn gateway的快捷方式放入启动文件夹。这个方法最简单直接。方法B通过任务计划程序在“任务计划程序”中创建一个基本任务触发器选“计算机启动时”操作选“启动程序”程序或脚本填openclaw-cn参数填gateway。这个方法最灵活可以设置更复杂的触发条件。⚠️ 一个小提示使用管理员权限无论是运行install命令还是手动创建任务计划都建议在“管理员模式”下进行这样可以避免权限不足导致的问题。如何验证设置好后你可以重启电脑然后打开命令行输入openclaw-cn status来检查网关是否已经成功运行。或者在浏览器中打开http://127.0.0.1:18789如果能访问到 OpenClaw 的界面就说明一切正常。安装完服务后你可以用openclaw-cn status命令来检查一下它是否在后台正常运行。如果遇到问题比如端口被占用随时可以再来问我openclaw-cn update这个命令非常有用它是 OpenClaw 专门用来更新自身的命令。和你之前尝试的gateway install不同update负责的是把程序升级到最新版本而不是让它开机自启。简单来说gateway install是解决“怎么启动”的问题而update是解决“怎么变新”的问题。你现在遇到的“看不到任务”的情况正好可以通过更新来解决——新版本往往能修复一些旧版的安装问题。openclaw-cn update是做什么的这个命令会启动一个安全的更新流程帮你把 OpenClaw 升级到最新版同时确保配置和数据不丢失。它主要有这几种用法命令作用适用场景openclaw-cn update执行标准更新这是最常用的命令会自动完成更新、检查和重启的全过程。openclaw-cn update wizard启动更新向导如果你想一步步跟着提示操作或者想切换更新渠道比如从稳定版切换到测试版可以用这个交互式向导。openclaw-cn update --channel 渠道切换更新频道比如--channel beta可以尝鲜测试版功能--channel stable则是使用稳定版。openclaw-cn update status查看更新状态查看当前版本、更新渠道以及是否有新版本可用。 为什么推荐你现在运行update结合我们之前讨论的“开机自启”问题你现在运行update有几个直接的好处修复安装问题你之前运行gateway install后找不到任务很可能是因为当前版本存在一些小 Bug。新版本通常会修复这类问题更新后再试一次gateway install说不定就成功了。确保配置兼容更新后运行doctor命令可以自动检查和修复配置文件让新版程序能无缝衔接你之前的设置。获取最新功能比如社区提到的新版本对飞书、多Agent路由的支持以及各种优化和汉化都能通过更新获得。 更新的标准流程Windows 11你可以按照下面这个安全流程来操作更新程序本身在管理员模式下的 PowerShell 或 CMD 中运行openclaw-cn update这个命令会帮你把核心程序更新到最新版。运行诊断修复更新完成后务必运行doctor命令进行健康检查和自动修复openclaw-cn doctor这一步非常重要可以解决更新后可能出现的配置不兼容问题。重新安装/重启服务完成以上两步后你再重新尝试设置开机自启或者直接重启网关服务# 重新尝试安装开机自启服务openclaw-cn gatewayinstall# 或者直接重启网关openclaw-cn gateway restart验证结果最后用我们之前提到的方法验证一下openclaw-cn status或者在浏览器打开http://127.0.0.1:18789看看一切是否正常。运行update后建议先用status命令确认一下版本号是否变新了。如果更新后gateway install还是看不到任务随时再叫我咱们一起看看日志排查一下抱歉我之前的回答可能有些歧义。在 OpenClaw 的语境下“清空会话”通常指的是清除某个智能体的对话历史而不是清除我们之间的对话记录。如果你是想清除 OpenClaw 中与 AI 智能体的聊天记录这里有几种方法最简单就是重置openclaw-cn reset删除的目标重新执行配对码即可在客户端任意消息就可以回复你赔对码openclaw-cn pairing approve feishu xxxx 搜索结果分析根据 OpenClaw 官方文档会话管理主要通过以下几种方式实现方法命令/操作说明发送重置命令/new或/reset在任何聊天会话中发送此消息会创建新的会话ID旧对话不会被删除但不再使用。手动压缩/compact发送此消息可以总结旧上下文并释放窗口空间但历史记录仍保留。删除会话文件直接操作文件系统删除~/.openclaw/agents/agentId/sessions/下的对应文件这是彻底清除的方式。CLI查看会话openclaw sessions --json查看所有会话列表及ID便于确认要删除的会话。️ 具体操作步骤如果你想彻底删除某个智能体的某个会话不仅仅是重置推荐这样做查看现有会话可选openclaw sessions--json这会列出所有会话及其sessionId帮助你确认要删除的目标。定位会话文件所有会话文件都存储在网关主机上# 进入对应智能体的会话目录cd~/.openclaw/agents/你的智能体ID/sessions/# 列出所有会话文件ls-la你会看到sessions.json- 存储会话元数据可安全删除单个条目xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.jsonl- 实际的对话记录文件彻底清空某个会话# 方法A只删除对话记录保留元数据下次会自动重建rmsessionId.jsonl# 方法B完全删除整个会话元数据记录# 需要先找到对应的sessionKey然后编辑sessions.json删除对应条目# 或者直接删除整个sessions目录谨慎会删除所有会话 补充说明删除是安全的官方文档指出删除sessions.json中的条目是安全的它们会在下次需要时按需重新创建。Gateway是唯一数据源所有会话状态都由Gateway网关拥有操作文件系统后下次启动网关时会自动生效。重置vs删除/new或/reset只是创建新的sessionId继续对话旧记录仍保留删除文件才是真正的“清空”。已经支持钉钉https://open.dingtalk.com/document/dingstart/build-dingtalk-ai-employees将OpenClaw即原Clawdbot接入钉钉主要有两种成熟且可靠的方法一种是通过云服务商提供的预配置镜像一键部署另一种是使用Docker快速部署社区版。前者适合追求稳定、希望长期使用的用户后者则对个人开发者更为灵活便捷。无论选择哪种方式核心步骤都包括在钉钉开发者后台创建应用以及在OpenClaw中完成相应的配置。下面为你梳理了两种主流的对接方案你可以根据自身情况选择。在开始之前有几件事需要先了解1.OpenClaw本身不具备AI能力它需要对接一个大语言模型如阿里云百炼、华为云MaaS等才能实现智能对话。你需要提前获取一个模型服务的API-Key。你需要一个钉钉企业账号并拥有开发者权限以便在钉钉开放平台创建和管理应用。两种主流对接模式Stream模式推荐通过WebSocket长连接通信无需公网IP和域名配置简单特别适合个人和家庭用户。HTTP模式需要提供公网可访问的Webhook地址适合已经拥有公网服务器或企业内网穿透的场景。2. 在钉钉开发者平台创建应用并获取凭证无论你选择哪家云厂商这一步都是通用的且至关重要。创建应用登录钉钉开发者后台创建一个“企业内部应用”。配置机器人在应用详情页找到“添加应用能力”为应用添加一个“机器人”。在机器人配置中消息接收模式请务必选择“Stream模式”这是无需公网IP的关键。发布应用前往“版本管理与发布”创建一个新版本设置好可见范围后直接发布。获取凭证在“凭证与基础信息”页面复制Client ID和Client Secret。这是后续配置的核心凭证请妥善保存。3. 在云服务器控制台完成最终配置配置模型API在服务器的OpenClaw应用管理页面找到“模型配置”入口填入你在阿里云百炼或华为云MaaS等平台获取的API-Key。配置钉钉通道找到“通道配置”或类似选项将上一步获取的Client ID和Client Secret填入并提交。等待几十秒当状态显示为“运行中”时即表示配置成功。4. 在钉钉中与机器人对话打开钉钉在搜索框中输入你创建的应用名称找到机器人后就可以开始私聊或者在群聊中它进行互动了。如何 **启动终端用户界面模式 **TUI孵化命令解析您使用的命令** openclaw-cn tui - ws://127.0.0.1:18789 - agent main - session main** 是启动OpenClaw终端用户界面的标准命令openclaw-cn tuiopenclaw-cn: 中文版本的OpenClaw命令tui: 启动终端用户界面模式ws://127.0.0.1:18789: 连接到本地Gateway的WebSocket地址agent main: 使用main代理session main: 使用main会话如何快速在TUI中孵化根据知识库中的部署经验要实现快速孵化建议确保Gateway服务已启动openclaw-cn gateway start# 或者powershell-ExecutionPolicyBypass-Commandopenclaw-cn gatewayGateway是OpenClaw的核心服务必须先启动才能连接TUI。选择响应速度快的模型如知识库中提到的选择qwen-flash这类响应速度快的模型原因作为工具人快速响应比深度思考更重要优势成本低适合高频调用场景中文能力强毕竟是国产模型使用本地模型而非云端模型如果条件允许使用本地模型可以避免网络延迟ollama launch openclaw-cn--modelqwen3-coder优化系统资源配置确保有足够的内存知识库提到2GB略显紧张建议配合Swap保持系统资源充足避免其他进程占用过多资源一键启动方案最快速使用Ollama的最新功能可以实现最快速的启动ollama launch openclaw-cn--modelkimi-k2.5:cloud这条命令会自动安装、配置并启动OpenClaw是目前最简单的部署方式。为什么有时候启动快有时候慢可能的原因包括Gateway服务状态不稳定使用的AI模型API响应速度波动网络连接质量特别是使用云端API时系统资源占用情况首次启动需要加载模型和初始化环境如果遇到启动慢的问题可以尝试重启Gateway服务openclaw-cn gateway restart# 或者cmd管理员启动powershell-ExecutionPolicyBypass-Commandopenclaw-cn gateway