默认配图

OpenClaw 安全配置指南:7 步收紧权限,避免公网暴露、越权执行与恶意 Skills

OpenClaw 安全配置的核心是收紧 Gateway、认证、沙箱、工具权限和 Skills 来源。正式使用前,应先把控制面和数据边界定清楚。 一、先看整体关系 本地部署不等于天然安全。真正的风险来自暴露端口、过宽权限、不可信输入和未经审查的技能。 OpenClaw 配置关系 OpenClaw 配置关系 1 本地绑定 2 认证密钥 3 沙箱限制 4 工具白名单 5 Skills 审查 按顺序处理,可以把部署、权限、渠道和验证拆开检查,减少混在一起排错。 二、把风险边界先拆开 复杂任务要先看输入、权限、执行和输出的边界。边界清楚后,再写命令、接模型或接渠道,排错会更可控。 任务边界拆分 任务边界拆分 输入与控制面 执行与数据面 外部输入 任务解释 工具执行 数据输出 把输入、权限和输出边界拆开,能更快判断哪里需要收紧。 部署前安全检查项 必做项为什么gateway.bind 设为 loopback避免 Gateway 直接暴露到局域网或公网gateway.auth 使用 token 或 password防止任何能碰到端口的人直接接管控制面agents.defaults.sandbox 开启并限制 workspaceAccess降低文件系统和命令执行的爆炸半径tools.profile 收紧,并禁止 group:automation、group:runtime 等高危工具减少越权执行、自我修改配置和定时后门使用独立机器、VM 或容器,并配独立 OS 用户和独立浏览器资料把个人账号、SSH 密钥、浏览器登录态从运行时里剥离出去 主要风险类型 风险面典型问题可能后果网关暴露把 Gateway 绑定到 lan、公网代理或错误的 Docker 暴露路径未授权访问、远程控制、令牌泄露工具权限过宽exec、gateway、文件工具、浏览器工具一起开放误删文件、执行命令、自改配置不可信输入邮件、网页、附件、日志都可能携带提示词注入越权读取、外发数据、错误执行供应链第三方 Skills 或插件未审查就安装凭证泄露、后门、持久化 风险不在于“本地部署”这四个字本身,而在于你把什么数据、什么账号、什么权限放进了这个运行时里。只要运行环境里有真实邮箱、真实浏览器会话、SSH 密钥、生产环境访问权限,OpenClaw 一旦被误导或被利用,问题就会直接变成真实损失。 公开风险事件与案例 过去几个月里,OpenClaw 的风险已经不只是理论讨论。 2026-02-23,Meta 研究员 Summer Yue 披露 OpenClaw 在邮箱整理任务中忽略“先确认再执行”的限制,最终误删了大量邮件。2026-01-29,OpenClaw 修复了 CVE-2026-25253,该问题可导致网关令牌泄露,并进一步演变为高风险控制面接管。2026-02,研究人员披露 ClawHub 上存在大批恶意 Skills,利用用户“先装再看”的习惯窃取密钥、执行外连或建立持久化后门。2026-02,StepSecurity 还披露过一次围绕 cline@2.3.0 的供应链事件,恶意安装脚本会在用户机器上静默安装 OpenClaw。 这些案例说明一件事:你不能把“我会小心使用”当成主要安全措施。真正有效的办法,永远是把权限收紧、把运行环境隔离、把可疑扩展挡在外面。 OpenClaw 最小安全基线 下面这个配置更适合单人、自建、偏保守的默认部署。它不是万能模板,但足够作为起步基线。 如果你确实需要写文件、跑命令或做浏览器自动化,不要把这些权限全局放开,而是按单个 Agent、单个工作区、单个任务去加。安全的关键不是“绝对不开”,而是“只在必要范围内开”。 OpenClaw 安全加固步骤 1. 持续更新到当前稳定版本 原理很简单:安全基线不是“达到某个历史版本号就万事大吉”,而是“始终跑当前稳定版,然后复核当前配置”。以 CVE-2026-25253 为例,它在 2026-01-29 就已经修复,但后面仍有新的安全公告持续发布。 建议做法: 如果你的运行环境是 Windows CLI,官方向导仍然优先建议使用 WSL2。原生 Windows 不是不能跑,但部署和排障路径会更复杂。 2. 将 Gateway 保持为本地绑定 官方配置参考里,gateway.bind 的默认值是 loopback。这意味着 Gateway 默认应该只监听本机,而不是默认开在 0.0.0.0。 正确思路不是“先对外监听,再靠运气别被扫到”,而是: 本机管理时,保持 loopback远程访问时,优先走 SSH 隧道、Tailscale 或可信反向代理只有你明确知道自己在做什么时,才使用 lan 或 custom 检查方式可以这样做: 如果你还想看端口监听结果: macOS / Linux 可用 lsof -i :18789Windows 可用 netstat -ano | findstr :18789 注意一件容易踩坑的事:配置里的 bind 应使用 loopback、lan、custom 这样的模式值,而不是直接把 127.0.0.1 或 0.0.0.0 写回配置里。官方已经把这些字面 IP 视为旧别名。 3. 启用并校验 Gateway 认证 OpenClaw 文档已经把 Gateway 认证列为默认要求项。很多教程的真实问题,不是“认证默认没开”,而是把认证写错了位置,结果以为自己开了,实际上配置根本没生效。 最稳妥的写法是: 生成 token 可以用: 验证不要去依赖文档外的私有接口,优先用公开接口或 CLI: 不带 token 的请求应该失败;只有带正确认证的客户端才能访问。 4. 正确配置沙箱作用域与工作区权限 OpenClaw 的沙箱配置在 agents.defaults.sandbox 下,不是顶层随便加一个 sandbox.mode 就算完成。更重要的是,改完沙箱后,不能只重启 Gateway,还需要重建沙箱运行时。 建议至少明确这三个点: mode: 建议 all,如果你想保留主会话在宿主机上,再考虑 non-mainscope: 建议 agent 或 sessionworkspaceAccess: 默认思路应是 none 或 ro,只有在确实需要写入时才用 rw 示例: 改完以后执行: 这一步很重要,因为现有沙箱容器不会因为你改了配置就自动变成新规则。 5. 按场景收紧工具权限 当前官方工具体系里,真正危险的不是某一个单点,而是几个能力同时叠加: group:runtime:exec、processgroup:fs:read、write、edit、apply_patchgroup:automation:cron、gatewaybrowser 与 web_*:可把不可信输入直接喂给高权限 Agent 对大部分用户来说,最保守的起点应是: 如果你确实需要命令执行或文件写入,请按任务场景单独放权: 场景推荐策略只做消息代答profile=messaging,禁用 group:runtime、group:fs、group:automation只读总结资料允许 web_search / web_fetch,禁用 write、edit、apply_patch、exec编码或自动化测试开沙箱,workspaceAccess=rw,exec.ask=always,保留 gateway 和 cron 为禁用状态,除非确有刚需 6. 将运行环境与真实身份分离 官方安全文档给出的建议很明确:如果一个 Agent 是团队共享或工具权限较高的运行时,就应该放在独立机器、VM 或容器里,并且使用独立的 OS 用户、独立浏览器资料和独立账号。 这意味着: 不要把你的个人 Apple、Google、微信、密码管理器会话放进同一个运行时不要把能登录生产环境的 SSH 密钥放到同一台机器不要让运行 OpenClaw 的系统用户拥有 sudo、管理员或不必要的共享目录权限 只要你把“个人浏览器资料 + 公司账号 + SSH 密钥 + 高权限 Agent”放到一台机器里,任何一次配置失误都会让损失成倍放大。 7. 建立 Skills、插件与日志审查机制 第三方 Skills 和插件本质上是在扩展你的信任边界。能装,不代表该装;能运行,也不代表该长期保留。 建议把下面这些动作做成例行检查: 如果某个 Skill 是通过 ClawHub 安装的,优先按它的来源管理工具去卸载;如果是你自己放进工作区的本地 Skill,就按目录级别清理后再复查 openclaw skills list。不要在没有确认安装来源的情况下,盲删配置目录或直接执行不明脚本。 异常响应流程 如果你已经观察到 CPU 异常飙升、文件被误删、陌生外连、账单暴涨或行为明显偏离预期,不要先跟 Agent 对话解释原因,先把爆炸半径收住。 1. 停止服务并切断外联 必要时再配合宿主机层面的网络断开或进程级排查。尽量不要直接用 killall node 或 taskkill /F /IM node.exe 这种“一锅端”命令,它们很可能会把机器上其他无关的 Node 进程一起杀掉。 2. 轮换可能受影响的凭证 优先处理这些: gateway.auth.token 或 gateway.auth.password模型 API Key消息平台 Token浏览器登录态和 OAuth 授权任何已经挂到运行时里的 SSH 密钥或第三方凭证 3. 复核日志、会话与近期配置变更 官方建议至少复核以下对象: Gateway 日志会话转录文件最近的配置变更,特别是 gateway.bind、gateway.auth、工具权限、插件变化最新一次 openclaw security audit --deep 的结果 如果你用了自定义 logging.file,以它为准;否则按当前运行环境去看默认日志位置。 4. 完成审计后再恢复服务 恢复前至少再跑一次: 如果你无法解释异常行为的来源,或者怀疑宿主机本身已经被污染,不要硬恢复,直接进入重建流程。 重建与卸载条件 有三种情况,重装通常比继续修补更稳: 你怀疑运行时已经被持久化后门污染你无法确认哪些凭证已经被读取或外发你准备把这台机器重新划回高信任环境 现在官方已经提供了内置卸载命令,优先用它,而不是手写一大串清理命令: 如果 CLI 已经损坏或缺失,再走官方文档里的手动服务移除路径。 参考核对 OpenClaw 官方安全文档:https://github.com/openclaw/openclaw/blob/main/docs/gateway/security/index.mdOpenClaw Gateway 配置参考:https://github.com/openclaw/openclaw/blob/main/docs/gateway/configuration-reference.mdOpenClaw Tools 文档:https://github.com/openclaw/openclaw/blob/main/docs/tools/index.mdOpenClaw 沙箱文档:https://github.com/openclaw/openclaw/blob/main/docs/gateway/sandboxing.mdOpenClaw 卸载文档:https://docs.openclaw.ai/install/uninstallTechCrunch 事件报道:https://techcrunch.com/2026/02/23/a-meta-ai-security-researcher-said-an-openclaw-agent-ran-amok-on-her-inbox/CVE-2026-25253 报道:https://thehackernews.com/2026/02/openclaw-bug-enables-one-click-remote.htmlStepSecurity 供应链事件:https://www.stepsecurity.io/blog/cline-supply-chain-attack-detected-cline-2-3-0-silently-installs-openclawBitdefender 公网暴露报告:https://www.bitdefender.com/en-us/blog/hotforsecurity/135k-openclaw-ai-agents-exposed-online 常见误区 Gateway 暴露到外网 控制面一旦可被外部访问,令牌和远程执行风险都会放大。 工具权限全开 文件、命令、浏览器和自动化工具同时开放,会扩大误操作后果。 不审查第三方 Skills 未经审查的 Skills 可能携带越权读取、外发数据或持久化逻辑。 方法对比 处理项适合场景确认重点 Gateway 绑定部署第一步减少外部访问 认证方式连接前阻止未授权控制 工具权限正式使用前限制执行范围 Skills 审查安装前降低供应链风险 用「Claw龙虾部署大师」减少前置配置成本 一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。 模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。 本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

OpenClaw安全 AI智能体部署 Gateway认证
2026/05/29
默认配图

OpenClaw 怎么卸载?先删主程序再清残留的完整教程

OpenClaw 卸载要按运行状态、主程序、配置目录和启动入口分层处理。只删一个目录,常会留下网关、计划任务或旧工作区数据。 一、先看整体关系 卸载链路里最容易漏掉的是后台服务和用户目录。先把运行入口停下来,再处理文件和配置,重装时才不容易读到旧状态。 OpenClaw 配置关系 OpenClaw 配置关系 1 停止网关 2 卸载主程序 3 清配置和工作区 4 检查启动入口 按顺序处理,可以把部署、权限、渠道和验证拆开检查,减少混在一起排错。 先处理什么 先确认 OpenClaw 的网关或后台服务没有继续运行。先卸载主程序,再删除配置和工作区数据。如果你准备重新安装,先把旧残留清干净,避免新版本继续读旧数据。 注意事项 不要在网关运行时直接删目录,容易提示占用。OpenClaw 的残留不只在安装目录里,配置、缓存、skill、agent 和记忆数据也要一起看。如果你只是临时不用,先保留工作区数据,后面重装会更方便。 1. 先停网关,再卸载主程序 卸载 OpenClaw 的第一步,不是删文件,而是先把它从运行状态停下来。这样后面的删除动作才不会被占用。 操作步骤 先执行 openclaw gateway stop,停止网关服务。如果命令还可用,再执行 openclaw uninstall 或对应的卸载命令。如果你是通过 npm 安装的,也要把全局包一起移除。 这一步完成后,主程序一般就已经从系统入口里退出来了。 2. 再清配置目录和工作区数据 OpenClaw 真正容易残留的地方,不是程序本体,而是用户目录里的配置和状态文件。这里如果不清,后面很容易出现重复配置或者安装不干净的问题。 重点检查的位置 ~/.openclaw~/.openclaw-<profile>工作区数据和日志目录你自己单独指定过的配置路径与 skill、agent、记忆相关的文件夹 如果你只是想换机器重装,这一步尤其重要,因为旧配置经常会影响新安装的初始状态。 3. 再检查启动项和计划任务 有些用户觉得 OpenClaw 卸载后还在后台出现,原因通常不是主程序没删,而是启动项、计划任务或系统服务还在。 需要确认的项目 Windows 的计划任务macOS 的 launchd 项Linux 的 systemd 用户服务是否还有和 OpenClaw 相关的开机入口 如果你发现它还会自己启动,通常就是这里没清掉。 4. 用「Windows优化大师」一键清理 OpenClaw 不想手动找目录时,可以直接用 「Windows优化大师」 的软件管理处理 OpenClaw。卸载后,软件会继续找出残留文件、关联记录和无效快捷方式,确认后一起清理,适合想一次清掉 OpenClaw 的 Windows 用户。 清理时重点看安装目录、用户目录里的旧配置、无效快捷方式和注册表关联项。确认旧 profile、Skills、工作区数据不再需要后,一键清理这些残留,能减少后续重装时继续读到旧配置的情况。 常见误区 网关未停就删目录 网关还在运行时,配置目录和日志文件可能被占用,删除失败后还会留下半截残留。 只清安装目录 OpenClaw 的 profile、Skills、agent 记忆和工作区常在用户目录里,不能只看程序目录。 重装前不清旧配置 旧 token、旧网关和旧渠道配置会影响新版本初始化,准备重装时要单独确认。 方法对比 处理项适合场景确认重点 先停网关正在运行或提示占用避免后台进程锁文件 清用户目录准备重装或换环境减少旧配置干扰 查启动项卸载后仍自启定位残留入口 用「Claw龙虾部署大师」减少前置配置成本 一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。 模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。 本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

OpenClaw卸载 残留清理 软件管理
2026/05/29
默认配图

Claw龙虾部署大师 QQ 接入指南:8 步完成机器人配置

QQ 接入要先在 QQ 开放平台准备机器人,再把 App ID 和 Secret 配到「Claw龙虾部署大师」里,最后用测试消息确认链路。 一、先看整体关系 QQ 接入的关键是密钥和机器人状态。平台侧创建成功后,再回到本地配置,能减少反复排错。 OpenClaw 配置关系 OpenClaw 配置关系 1 开放平台 2 创建机器人 3 复制密钥 4 配置接入 5 发送测试消息 按顺序处理,可以把部署、权限、渠道和验证拆开检查,减少混在一起排错。 第 1 步,登录 QQ 开放平台并绑定 QQ 号 打开QQ开放平台:https://q.qq.com/qqbot/openclaw/ 登录需要绑定的QQ号 第 2 步,创建 QQ 机器人 点击【创建机器人】 第 3 步,复制 App ID 与 App Secret 备用 将生成的 App ID 和 App Secret 分别复制粘贴出来备用 第 4 步,在 QQ 会话中确认机器人创建成功 查看QQ会话列表,确认机器人已创建成功。 第 5 步,在 「Claw龙虾部署大师」中选择 QQ 接入 在桌面上打开 「Claw龙虾部署大师」,点击 【手机远程】,选择连接【QQ】 第 6 步,填写 App ID / Secret 并验证保存 将前面复制的 APP ID 与 Client Secret 分别复制粘贴到对应输入栏后,点击【验证配置】→【保存并连接】 第 7 步,在手机 QQ 中向机器人发送测试消息 在手机QQ上打开机器人的聊天窗口发送一条消息,机器人有消息响应后就可以使用啦 第 8 步,如何断开 QQ 接入 如后续需要取消连接QQ,可重新打开连接页面,点击【断开连接】 常见误区 密钥复制错误 App ID 和 Secret 要完整复制,前后空格也会导致验证失败。 未完成平台审核 机器人未启用或权限未通过时,本地配置无法真正连通。 只保存不测试 保存成功不等于消息链路正常,必须发送测试消息。 方法对比 处理项适合场景确认重点 平台配置创建机器人拿到密钥 本地接入填写配置建立连接 消息测试配置完成后确认可用 用「Claw龙虾部署大师」减少前置配置成本 一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。 模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。 本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

Claw龙虾部署大师 QQ接入 QQ机器人
2026/05/29
默认配图

国产 AI 大模型怎么选?按场景和预算快速对比指南

国产 AI 大模型要按场景选择。写作、编程、推理、长文档和多模态关注点不同,先定任务,再看预算和接入方式。 一、先看整体关系 模型选择不适合只看热度。OpenClaw 接入模型前,应先确认任务类型和预算,再决定用哪一类模型做主力。 OpenClaw 配置关系 OpenClaw 配置关系 1 任务场景 2 上下文长度 3 推理/代码 4 多模态 5 调用成本 按顺序处理,可以把部署、权限、渠道和验证拆开检查,减少混在一起排错。 先看这三个判断标准 先看你最常做的任务是写作、编程还是推理。再看你愿意接受免费版、低成本 API 还是企业级方案。最后看你是否需要长文档、多模态或者私有化部署。 按场景怎么选 1. 写作和内容生成 如果你最常做的是写文章、改文案、整理表达,可以优先看中文体验更顺手的模型。它们通常更适合日常写作、总结和内容润色。 2. 编程和开发 如果你的重点是代码、接口、脚本和工具链,优先看编程能力强、上下文处理稳定的模型。对开发者来说,输出是否稳定,比“会不会说话”更重要。 3. 数学和推理 如果你经常处理逻辑题、数据分析、方案推导和复杂判断,更适合选推理能力强的模型。它们在结构化分析和步骤推演上通常更稳。 4. 长文档和调研 如果你经常读长报告、合同、论文或者大篇幅资料,就要优先考虑长上下文能力。这样可以少切片、少丢信息,整理起来更顺。 5. 多模态和办公协作 如果你还要处理图片、语音、视频或者日常办公协作,可以看多模态能力更完整的模型。它们更适合做综合助理,而不只是文本问答。 横向对比 模型更适合的场景常见优势可能短板豆包写作、日常问答、多模态中文体验顺手复杂代码不一定最强通义千问编程、多语言、企业接入开发适配度高创意写作未必是第一选择DeepSeek推理、代码、成本敏感场景性价比高多模态体验要看具体版本Kimi长文档、调研、复杂整理长文本处理强不一定适合所有高频场景智谱GLMAgent、开发、工具链工程化能力强普通用户感知未必最强 常见误区 只看模型热度 热度高不等于适合当前任务,写作、代码和长文档的评价指标不同。 忽略上下文长度 长资料整理时,上下文长度会直接影响信息是否丢失。 只看免费额度 长期使用还要看稳定性、速率限制和 API 成本。 方法对比 处理项适合场景确认重点 写作模型内容生成和改写中文表达更顺 代码模型脚本和工程任务结构化输出更重要 长文档模型资料整理减少切片和遗漏 用「Claw龙虾部署大师」减少前置配置成本 一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。 模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。 本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

国产AI大模型 模型选择 AI对比
2026/05/29
默认配图

Claw龙虾部署大师 飞书接入指南:扫码或填 App ID 两种连接方式

飞书接入有扫码和已有机器人两种路径。先选连接方式,再完成机器人应用、权限和测试消息验证。 一、先看整体关系 飞书接入要同时看本地配置和飞书开放平台状态。已有机器人接入时,App ID、Secret 和权限范围都要对齐。 OpenClaw 配置关系 OpenClaw 配置关系 1 选择方式 2 扫码或填 App ID 3 创建机器人 4 授权权限 5 测试消息 按顺序处理,可以把部署、权限、渠道和验证拆开检查,减少混在一起排错。 第 1 步,在 「Claw龙虾部署大师」中选择飞书接入 在桌面上打开 「Claw龙虾部署大师」,点击 【手机远程】,选择连接【飞书】 第 2 步,使用飞书扫一扫扫描连接二维码 打开手机的飞书,右上方使用扫一扫,扫描软件上出现的二维码 第 3 步,在飞书中创建机器人应用 给机器人设置好名称,依次点击【立即创建】→ 【继续创建】→ 【打开应用】 第 4 步,向机器人发送测试消息 接着打开机器人的聊天窗口发消息测试一下,有消息响应即可正常使用啦~ 第 5 步,使用「已有机器人」接入(可选) 如果之前已在飞书后台创建了机器人,可以点击下方【已有机器人】 接着访问飞书开放平台:https://open.feishu.cn/app 打开已创建的机器人 左侧点击【凭证与基础信息】 → 将 App ID 和 App Secret 都分别复制粘贴到配置页面上,点【验证配置】→ 【保存连接】即可 第 6 步,如何断开飞书连接 如果后续需要取消连接飞书,可重新打开连接页面,点击【断开连接】 常见误区 权限范围不足 机器人能创建不代表能收发消息,应用权限要单独确认。 密钥填错环境 测试环境和正式环境的 App ID/Secret 不要混用。 群聊未添加机器人 机器人未进入目标群时,本地配置正常也收不到消息。 方法对比 处理项适合场景确认重点 扫码接入快速连接少填配置 已有机器人企业已有应用要核对密钥权限 测试消息完成后确认收发 用「Claw龙虾部署大师」减少前置配置成本 一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。 模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。 本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

Claw龙虾部署大师 飞书接入 飞书机器人
2026/05/29
默认配图

用龙虾写代码做软件的实战部署指南

用龙虾写代码做软件,要把模型、代码仓库、权限、消息入口和审查流程一起配置好。真正可用的 Vibe Coding 需要先跑通最小闭环。 一、先看整体关系 对话式开发不是让模型直接改生产代码,而是把需求、执行、验证和审查放进一条可控链路。 OpenClaw 配置关系 OpenClaw 配置关系 1 消息入口 2 任务解析 3 代码修改 4 测试验证 5 PR 审查 按顺序处理,可以把部署、权限、渠道和验证拆开检查,减少混在一起排错。 二、把风险边界先拆开 复杂任务要先看输入、权限、执行和输出的边界。边界清楚后,再写命令、接模型或接渠道,排错会更可控。 任务边界拆分 任务边界拆分 输入与控制面 执行与数据面 需求 分支 测试 审查 合并 把输入、权限和输出边界拆开,能更快判断哪里需要收紧。 Vibe Coding 是什么?一句话对话就能修 Bug 的工作流 Vibe Coding(对话式开发)是一种把"提需求 → 改代码 → 跑测试 → 提 PR"压缩成一次自然语言对话的工程流程。用户在飞书里描述需求,OpenClaw 机器人(龙虾)接收并编排任务,由 OpenCode 完成分支创建、代码修改、测试执行、Pull Request 提交,再由 GitHub Copilot 完成审查,人工只需在最后做合并决策。 这套流程的三个核心价值: 降低动手门槛:开发者不再需要切换到 IDE,产品经理等非开发角色也可以通过飞书直接提交代码修改需求。 全流程可追溯:每一次对话都沉淀为具体的 PR、commit、审查记录。 角色解耦:OpenClaw 负责消息编排,OpenCode 负责编码重活,GitHub Copilot 负责审查,飞书负责人机交互。 本文基于 2026 年 4 月最新的模型与工具文档,给出从零部署到第一次合并 PR 的完整操作步骤,全程使用 Kimi K2.5 作为走查示例,并在后文给出 GLM-4.7、DeepSeek-V3.2、Doubao-Seed-Code 的等价配置。 最小可行技术栈(MVP)对照表 Vibe Coding 的最小可行技术栈由四层构成。下表列出每一层的作用与是否可替代。 层级组件作用是否可替代 人机交互飞书接收自然语言需求、推送 PR 通知与审查结果可替换为企业微信或 Slack,但要重新对接 OpenClaw 消息通道 编排层OpenClaw 机器人(龙虾)解析需求、调用 OpenCode、轮询状态、回推消息不建议替换;替代方案需要自写 shell 桥接 + 会话管理 执行层OpenCode 编码 Agent拉分支、改代码、跑测试、提 commit、建 PR可替换为 TRAE、Cline、Aider 等,但 OpenCode 同时支持多家模型后端,切换成本最低 模型层Kimi K2.5 / GLM-4.7 / DeepSeek-V3.2 / Doubao-Seed-Code为 OpenCode 提供推理与代码生成能力四家互为备份,按额度、延迟、上下文窗口择优 审查层GitHub Copilot Code Review自动审查 PR 并留意见可用 CodeRabbit / Graphite 等,但审查调用入口与回传结构不同 部署前的前置条件 在服务器上开始安装之前,需要先备齐以下五项前置条件。任一项缺失都会导致后续"跑第一条任务"阶段失败。 一台可访问公网且已接入飞书通道的 OpenClaw 机器人服务器。 一个有效的模型 API Key(本文默认使用 Kimi K2.5,其它可选见下一节对照表)。 一个 GitHub Fine-grained Personal Access Token,已授权目标仓库。 目标仓库已存在,且 Token 的账号对其具有写入权限。 服务器的 Shell 环境支持 Bash、Zsh 或 PowerShell(Windows 还需 Git for Windows)。 模型选型与 API Key 获取 OpenCode 通过标准 Messages API 或 OpenAI 兼容端点对接模型。下表对照了四家常见模型的 API 入口、推荐 model id 与控制台位置。 Kimi K2.5:model id 以 kimi-k2.5 / kimi-k2.6 为主,API 入口使用 Moonshot,控制台是 platform.moonshot.ai。 GLM-4.7:model id 使用 glm-4.7,Max 套餐可选 glm-5.1,控制台在智谱或 z.ai。 DeepSeek-V3.2:非思考任务用 deepseek-chat,推理任务用 deepseek-reasoner,控制台是 platform.deepseek.com。 Doubao-Seed-Code:代码任务可用 doubao-seed-code-preview-latest,控制台在火山方舟 Ark。 创建 Kimi K2.5 API Key 访问 platform.moonshot.ai,用邮箱或微信登录。 右上角进入 API Keys(或账户设置 → API Keys)。 点击 新建 API Key,命名为 openclaw-vibe-coding 便于后续审计。 复制生成的 Key(只显示一次),立即存入密码管理器。 在服务器 Shell 启动脚本写入环境变量(OpenClaw 启动时需继承): 来源:Kimi API Platform 官方指南 platform.kimi.ai/docs/guide/agent-support。 创建 GitHub Fine-grained Token GitHub 官方路径:Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token。 在 Token 表单中需要设置以下选项: 字段建议值说明 Token nameopenclaw-vibe-coding便于审计 Expiration30 或 90 天与内部密钥轮换周期对齐 Repository accessOnly select repositories仅勾选目标仓库,最小权限 ContentsRead and write允许读写仓库文件 Pull requestsRead and write允许创建和管理 PR IssuesRead and write允许读写 Issue MetadataRead-onlyGitHub 自动勾选,不需要手动开启 生成后保存 Token 并配置 Git credential: Fine-grained Token 可以限定到单个仓库,安全级别高于 Classic Token。建议不要使用拥有所有仓库权限的 Classic Token。 来源:GitHub 官方文档 docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens。 安装 OpenCode 编码 Agent OpenCode 是面向终端的开源编码 Agent,原生支持多家模型后端。官方安装方式按平台分为以下四类,来源 opencode.ai/docs。 macOS / Linux / WSL 原生安装 macOS(Homebrew) Windows(Scoop / Chocolatey) 全平台备选,npm npm 方式要求 Node.js ≥ 18。原生安装不依赖 Node.js,生产环境推荐原生路径。 安装后校验 opencode auth list 会列出当前已注册的模型提供方。任一提供方缺少 Key 时,在下一步补上即可。 配置 OpenCode 对接模型 配置分为两步:写入对应提供方的 API Key 环境变量,再在 OpenCode 里用 /models 选择模型。 第一步,导出模型环境变量 以 Kimi K2.5 为例: 其它模型的环境变量名: 模型环境变量名说明 Kimi K2.5MOONSHOT_API_KEYOpenCode 自带 Moonshot 插件 DeepSeek-V3.2DEEPSEEK_API_KEYOpenCode 自带 DeepSeek 插件 GLM-4.7ZAI_API_KEY 或 ZHIPU_API_KEY通过 Z.AI 或 open.bigmodel.cn 入口 Doubao-Seed-CodeVOLCENGINE_ARK_API_KEY火山方舟控制台获取 第二步,在 OpenCode 里选模型 启动 OpenCode 并进入模型选择菜单: 在 OpenCode 界面内输入: 菜单里选中 moonshot/kimi-k2.5(或对应模型)。之后所有会话默认使用该模型。想切换只需再次 /models 重选。 固化配置(可选) 若要避免每次启动都选模型,在仓库根目录写 opencode.json: 对于 OpenCode 尚未内置的自定义兼容端点,则在 opencode.json 的 provider 段声明 npm、baseURL、apiKey、models 四项,具体字段以 opencode.ai/docs/providers 为准。 安装 gh CLI 并完成认证 OpenCode 在创建 PR 时会调用 gh 命令。gh 的官方安装方式按平台分为三类。 Debian / Ubuntu 官方仓库 GitHub CLI 官方推荐使用带签名的 keyring 安装,避免发行版自带版本落后: macOS Windows 认证 来源:GitHub CLI 官方仓库 github.com/cli/cli 的 install_linux.md 与 install_windows.md。 启用 OpenClaw 机器人(龙虾)的编码能力 OpenClaw 默认使用 messaging 工具配置档,只能收发消息。要执行代码操作(调用 OpenCode、运行 git、读写仓库目录),必须切换到 coding 或 full 档。 以下命令以 OpenClaw 官方文档为准: 配置完成后依次安装三个技能。安装顺序有讲究:skill-vetter 是安全守卫,要第一个装,后续每次安装技能都会先扫描来源。 各技能的作用对照: 技能作用首跑是否必装 skill-vetter自动扫描技能是否存在 API Key 窃取等安全风险必装 opencode包装 OpenCode 的调用、会话管理、错误重试必装 github查询 PR 审查状态,支持 Cron 轮询后推送到飞书建议在最小闭环跑通后再装 说明:上述 clawhub / openclaw config 命令形式以 OpenClaw / 「Claw龙虾部署大师」 官方文档为准,生产部署前请以服务器内 openclaw --help 与 clawhub search 的实际输出为准。 配置工作区规则 AGENTS.md AGENTS.md 是 OpenCode 启动时读取的项目级规则文件,告诉它"项目规范是什么、哪些文件不要碰、commit 怎么写"。在仓库根目录运行: 进入后输入 /init,OpenCode 会扫描仓库并自动生成 AGENTS.md 草稿。手工补充后提交到版本库,OpenCode 后续的改动会自动遵循该文件。 对 OpenClaw 编排侧,还需要一份 IDENTITY.md 告诉它何时调 OpenCode、怎么汇报、失败怎么处理。默认路径 ~/.openclaw/workspace/IDENTITY.md: 跑通第一次对话式开发 第一次跑通有两个阶段:服务器端自检、飞书端发送真实需求。 第一阶段,服务器 30 秒自检 三条命令都通过,即可进入第二阶段。任一失败跳到本文的"常见排障"小节。 第二阶段,飞书里发第一条真实需求 发送前请确认:目标仓库存在、Token 已授权该仓库、模型 API 额度未耗尽。下面是一条可直接使用的需求模板: 完整闭环分四步: 发送需求:飞书自然语言消息到群 @龙虾。 收到 PR 摘要:机器人回传 PR 编号、修改文件列表、diff 预览。 审查 diff:点击 PR 链接在浏览器里查看代码。 确认合并:在飞书里回复"合并并清理分支",机器人执行 squash merge + 删除远程分支。 对话式开发的架构总览 下面这张 SVG 流程图概括了一条完整的飞书消息在 Vibe Coding 中的生命周期,从需求输入到合并结束。 常用对话场景与指令模板 Vibe Coding 的实际工作场景集中在四类任务。下面给出四条经过验证的飞书消息模板,可直接复制后替换占位符使用。 场景 1,一句话修 Bug OpenClaw 会调用 OpenCode 完成:创建分支 openclaw/fix-null-user → 修改 user.ts → 运行 npm test → commit → push → gh pr create。 场景 2,多文件重构 多文件重构任务要在需求里显式列出目录范围与验证方式,避免 OpenCode 扫描整个仓库。 场景 3,从 Issue 到 PR 全链路 场景 4,非开发者提交文案修改 产品经理或运营可以直接使用这条模板,OpenClaw 会代替人工走完整 Git 流程。合并决策仍由具备写权限的开发者完成。 Copilot 自动审查与分支保护 生产仓库强烈建议同时启用 Copilot 自动审查与分支保护。两项配置在 GitHub 2026 年的 Rulesets 体系下已整合到同一入口。 启用 Copilot 自动审查 GitHub 已将这项能力从旧的 Settings → Copilot → Code review 路径迁移到 Rulesets 体系。新路径: 打开仓库 Settings。 左侧栏点击 Rules → Rulesets。 点击 New ruleset → New branch ruleset。 在 Branch rules 区勾选 Automatically request Copilot code review。 Target branches 选择 main(或主干分支)。 保存。 来源:GitHub 官方文档 docs.github.com/en/copilot/using-github-copilot/code-review/using-copilot-code-review。 启用分支保护 两条路径均可用,Rulesets 是 GitHub 推荐的新入口: 入口路径 传统 Branch protection rulesSettings → Branches → Branch protection rules → Add rule 现代 RulesetsSettings → Rules → Rulesets → New branch ruleset 两个入口都可以配置以下三项: Require a pull request before merging(合并前必须走 PR)。 Require approvals(至少 1 个审批,推荐 1 个人工 + 1 个 Copilot)。 Require status checks to pass(CI 通过才能合并)。 手动请求 Copilot 审查 在 PR 页面右侧 Reviewers 菜单直接勾选 Copilot,或用命令行: 注意:不存在通过评论 @copilot 自动触发审查的命令,必须走 Reviewers 菜单或 gh 命令。 启用 Cron 自动轮询 PR 审查状态 在最小闭环之外,可以给 OpenClaw 配置一条 Cron,每 5 分钟轮询一次所有 openclaw/ 前缀分支的开放 PR,只在出现新审查结果时推送飞书。 收到飞书推送后,用户有三种回复策略: 回复"按建议修改":OpenClaw 调用 OpenCode 逐条修复 Copilot 意见,更新 PR 并重新请求审查。 回复"忽略建议并合并":OpenClaw 执行 squash merge。 回复"我来看看":不触发任何自动动作,由人工后续处理。 这条路径被称为"人在回路"(human-in-the-loop)模式,适合生产仓库。全自动合并(Copilot approved 即触发 merge)只建议用于文档仓库或个人项目。上述 openclaw cron 命令形式以 OpenClaw 官方文档为准。 提升代码质量的两种工程化手段 在仓库根目录维护 AGENTS.md AGENTS.md 是 OpenCode 读取上下文时的首要参考。把项目规范写在这里,OpenCode 后续的改动会自动遵循,减少审查返工。示例: 遵循 Conventional Commits v1.0.0 Conventional Commits v1.0.0 官方规范的消息结构为 <type>[optional scope]: <description>。强制类型只有三种: 类型含义对应 SemVer feat新功能MINOR fixBug 修复PATCH BREAKING CHANGE破坏性变更(在 footer 或 type 后加 !)MAJOR 另外 Angular 约定的常用类型(非强制但社区通用): build:构建系统或依赖变更。 chore:杂务(不影响代码或测试的维护)。 ci:CI 配置变更。 docs:只改文档。 style:格式化、空白,不影响含义。 refactor:重构(不新增功能也不修 Bug)。 perf:性能优化。 test:新增或修改测试。 来源:conventionalcommits.org/en/v1.0.0。 常见排障与诊断命令 Vibe Coding 的故障面集中在四个环节:OpenCode 调用、PR 推送权限、Copilot 审查触发、代码修改质量。以下四个诊断路径覆盖了约 90% 的首跑失败场景。 OpenCode 调用失败 先按顺序跑这四个诊断: 常见原因: opencode 技能未安装:执行 clawhub install opencode。 模型 API Key 未设置或过期:检查 MOONSHOT_API_KEY / DEEPSEEK_API_KEY / ZAI_API_KEY / VOLCENGINE_ARK_API_KEY 是否写入 Shell 启动脚本。 OpenCode 二进制不在 PATH 中:检查 ~/.local/bin 是否在 $PATH。 模型额度耗尽:去对应平台的计费页查当月用量(Kimi 在 platform.moonshot.ai/billing,DeepSeek 在 platform.deepseek.com/usage)。 PR 创建失败(Permission denied) 常见原因: Fine-grained Token 没有勾选目标仓库。 Token 已过期(默认 30 天)。 组织仓库需要单独的 SSO 授权(登录 GitHub 组织页手动授权)。 git-credentials 中的用户名拼错。 Copilot 审查一直 pending 仓库未启用 Copilot 自动审查(回到上一节的 Rulesets 路径检查)。 组织未开通 Copilot Business / Enterprise 许可。 PR 改动文件数 > 300,Copilot 可能超时。 PR 含大体积二进制文件。 代码修改不符合预期 仓库缺少 AGENTS.md,OpenCode 没有足够上下文。 需求描述过于模糊:改为在飞书里指定具体文件路径。 仓库体量过大:在需求中限定"只修改 src/api 下的文件"。 模型能力不足:/models 切换到更强模型(例如把 GLM-4.5-Air 换成 GLM-4.7 或 Kimi K2.5)。 常见问题(FAQ) Vibe Coding 需要会编程吗? 不需要会写代码,但需要能说清楚需求。产品经理或设计师可以用自然语言描述"把首页标题从 X 改成 Y",OpenClaw 和 OpenCode 会完成具体改动并提 PR。最终是否合并仍由有写权限的开发者确认。 只用飞书能给公司代码库提 PR 吗? 可以。前提是服务器上的 OpenClaw 机器人已经接入飞书通道、OpenCode 已安装并配好模型 API Key、GITHUB_TOKEN 已授权目标仓库。达成这三条后,飞书里的一句话即可驱动一次完整的 PR 流程。 Vibe Coding 会不会把测试或密钥误改掉? OpenCode 默认只做代码变更与建议,不会自动合并。涉及敏感文件(.env、密钥、CI 配置)时需要在 AGENTS.md 里显式标注"不要修改"。生产仓库建议同时启用分支保护,强制 PR + 人工审批。 四家模型怎么选? 按三条标准择优:任务复杂度(长上下文重构优先 Kimi K2.5 的 256K 窗口;短平快改动用 DeepSeek-V3.2 或 GLM-4.5-Air 即可)、预算(DeepSeek 按量计费单价最低,GLM 提供月付 Coding Plan)、延迟(就近机房,国内访问火山方舟 Ark 最稳)。切换只需 /models 重选,无需改代码。 安装了 opencode 技能还需要装 github 技能吗? 首跑不需要。OpenCode 自带 gh 调用,能直接创建 PR。github 技能的作用是让 OpenClaw 主动轮询 PR 审查状态并回推飞书通知,属于增强能力,最小闭环跑通后再加。 OpenCode 和 GitHub Copilot 是竞品吗? 不是。在 Vibe Coding 架构里它们是协作关系:OpenCode 写代码并提交 PR,GitHub Copilot 审查 PR 并留意见。一个做"生产者",一个做"质检员"。 生产环境可以开全自动合并吗? 不建议。全自动模式(Copilot approved → 自动 merge)仅适合低风险仓库(文档、个人项目)。生产仓库必须保留人工合并环节,并同时配置 Rulesets 下的 Require approvals。 模型 API 额度不够怎么办? 登录对应平台的用量页:Kimi platform.moonshot.ai/billing、DeepSeek platform.deepseek.com/usage、智谱 open.bigmodel.cn/usercenter、火山方舟 console.volcengine.com/ark。短期可升级套餐或开通 Coding Plan 月付包;长期建议按需求分配独立 API Key 与预算上限,隔离不同项目成本。 飞书之外还能用企业微信、Slack 吗? 可以。OpenClaw 的消息编排层与具体 IM 通道解耦,只要把对应通道的 Bot Token 按官方文档配置进去即可。OpenClaw 原生支持飞书、Telegram、Discord、iMessage、Slack 等十余种工具。 部署清单总结 回到整体流程,Vibe Coding 的部署可以归结为下面这张清单: 服务器:已接入飞书的 OpenClaw 机器人 + 工具配置档设为 coding。 凭证:模型 API Key(Kimi / GLM / DeepSeek / Doubao-Seed-Code 四选一)+ GitHub Fine-grained PAT。 CLI:OpenCode 原生安装 + gh CLI 官方源安装,二者均通过 --version 校验。 技能:skill-vetter → opencode → 可选 github,按此顺序安装。 工作区规则:仓库根目录 AGENTS.md 写项目规范;~/.openclaw/workspace/IDENTITY.md 写编排策略。 仓库配置:Settings → Rules → Rulesets 配置分支保护 + Copilot 自动审查。 首跑任务:从一条可逆的小改动开始(例如改 README),确认闭环后再扩展到多文件重构。 完成上述七步后,把飞书里的一句话变成一次合规 PR 的全链路就跑通了。 如果不想手动搭建服务器、装依赖、配置通道,可以使用 「Claw龙虾部署大师」完成 OpenClaw 机器人的一键部署,部署完成后直接进入本文的"启用编码能力"步骤,跳过基础环境搭建。这一步是可选的,对手动部署流程没有强依赖。 常见误区 没有仓库规则 缺少 AGENTS.md 或项目约束时,模型容易按通用习惯改错位置。 权限给得过大 代码仓库、密钥和部署权限要分层,不要一次全开。 跳过测试和审查 没有测试和 PR 审查,就无法判断一次修改是否可合并。 方法对比 处理项适合场景确认重点 消息入口非开发者提交需求降低沟通成本 仓库规则执行前限制改动范围 PR 审查合并前控制质量 用「Claw龙虾部署大师」减少前置配置成本 一键本地部署 用来处理 OpenClaw 安装、基础环境和本地运行入口,适合不想先花大量时间排查依赖的人。 模型接入 用来把豆包、通义千问、DeepSeek 等模型配置进工作流,适合需要先跑通 AI 助手底座,再继续配置渠道和任务的人。 本地安全部署 适合把数据、账号和运行环境留在本机或指定设备上,再按文章里的步骤继续收紧权限、接入渠道或验证任务。

Vibe Coding 对话式开发 OpenCode
2026/05/29

客服
扫描与客服沟通

回顶部
提示

正在拉起鸿蒙应用市场,如遇无法拉起/无法下载的情况,可使用鸿蒙设备,自行前往应用市场,搜索「Win解压缩」安装。

知道了