文档建议反馈控制台
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
发布

OpenClaw + Claude Code：2 种模式 + 4 层架构，让 AI 开发助手持续跑起来

两个系统通过 ACP 协议通信，实现了真正可持续运行的开发工作流。 1. 架构本质：不是工具，是协作系统 很多人第一次接触 OpenClaw 时会问：这不就是个聊天机器人框架吗？...支持的工具包括 Pi、Claude Code、Codex、OpenCode、Gemini CLI、Kimi 等。...，使用 runtime="subagent" 如果你遇到这个错误： Sandboxed sessions cannot spawn ACP sessions because runtime="acp"...除了命令行，还可以通过 sessions_spawn API 启动会话： { "task": "Review the PR and fix any failing tests", "runtime...后端插件缺失 运行 /acp doctor 检查，安装 acpx 插件 ACP is disabled by policy ACP 全局禁用 设置 acp.enabled=true ACP agent

2.7K10

深入剖析了 OpenClaw中 ACP Agents 的全方位实现机制

ACP 定义了一套标准的通信接口，使得 OpenClaw 能够像调用本地函数一样，启动并控制任何兼容 ACP 的外部进程。...当用户在聊天中输入“用 Codex 修复这个测试失败”时，OpenClaw 会自动识别意图，通过 ACP 后端插件（如 acpx）启动一个 Codex 实例，将其绑定到当前的对话线程中，并实时流式传输其执行结果...ACP 会话请求（例如 /acp spawn codex --thread auto），OpenClaw 会启动一个 ACP 会话，并将该会话的 ID 与当前线程的 ID 关联起来，存储在会话元数据中...如果当前渠道不支持线程绑定，OpenClaw 会返回明确的错误提示，告知用户该功能不可用，建议切换到支持的渠道或使用 --thread off 模式。...7.1 常见故障排除表  症状可能原因解决方案 ACP runtime backend is not configured后端插件未安装或禁用运行 openclaw plugins install

2.7K21
    • 您找到你想要的搜索结果了吗？
    是的
    没有找到

    OpenClaw ACP Agents：在消息平台中统一管理 Claude Code 和 Codex 等 10+ 编码智能体

    OpenClaw 的 acpx 插件把这套协议接到了消息平台,让你能在 discord、 telegram 里直接驱动 Codex、 Claude Code、 gemini CLI 等 10+ 编码智能体...Prompt Turn 流程 3.Openclaw acpx 插件：核心实现 OpenClaw 通过 acpx 插件提供完整的 ACP 实现. acpx 是一个 typescript 编写的插件, GitHub...cli cursor 原生支持 cursor cli copilot 原生支持 github copilot cli pi pi-acp pi coding agent openclaw 原生支持 openclaw...实战指南：从安装到使用 安装 acpx 插件 # 安装插件 openclaw plugins install acpx # 启用插件 openclaw config set plugins.entries.acpx.enabled...验证部署的网关版本 确认部署源包含 ACP 支持 打开临时会话测试： use the sessions_spawn tool with runtime： "acp", agentId： "codex",

    1.6K00

    深入探讨 npm run start 遇到 spawn EINVAL 时的含义与应对思路

    spawn EINVAL 的含义通常可以理解为: Node.js 在使用内部 API 调用命令时得到了一个 Invalid Argument 的错误。...还可能出现一个更常见的场景，比如 Windows 上的命令与 Unix 系统不同，脚本中带有一些仅适用于 Linux 的命令，从而导致在 Windows 环境下执行出现 EINVAL 错误。...spawn 允许我们像在终端那样逐行执行命令，如果 spawn 的参数出现问题，或者命令路径没有找到，可执行文件名在当前系统不可用，也会报出类似 spawn EINVAL 的错误。...如果脚本要调用的工具并没有被正确安装，也会出现找不到可执行文件，从而引发 spawn EINVAL。某些情况下，操作系统的权限控制也会导致 spawn EINVAL。...当 somecommand 并不存在或无执行权限，就会在 spawn 时触发 EINVAL。如果没有明确的 CLI 或可执行文件，应该改用 node index.js 或者其他正确的入口文件。

    1.7K10

    openclaw v2026.3.28更新详解：模型适配、插件增强、多平台优化一网打尽

    一、版本概览 openclaw于2026年3月29日正式发布v2026.3.28最新版本，本次更新包含多项Breaking变更与功能优化，覆盖模型提供商适配、配置管理、插件系统、多平台交互、容器部署、CLI...• 新增Grok网页搜索插件引导：在openclaw onboard和openclaw configure --section web流程中，提供可选的x_search设置，包含共享xAI密钥的模型选择器...CLI后端与启动优化 • 捆绑的Claude CLI、Codex CLI、Gemini CLI推理默认配置迁移至插件层面，新增Gemini CLI后端支持。...Podman容器简化 • 简化当前无root用户的容器设置，将启动助手安装至~/.local/bin目录。...• 状态展示：openclaw daemon status优先展示轻量级探测的网关关闭原因， concrete认证/配对失败信息替代通用超时提示。 （五）CLI工具与配置管理 1.

    1.6K10

    OpenClaw网关怎么重启？常用命令+报错解决方法

    一、快速重启（最常用）根据你的部署方式和需求，选择以下任一命令即可完成网关重启：场景命令最常用（systemd托管）systemctl --user restart openclaw-gateway CLI...提供了内置的 CLI 命令来管理网关：# 标准重启openclaw gateway restart# 带详细日志重启openclaw gateway restart --verbose# 查看状态后再决定是否重启...f openclaw# 或查找进程ID后强制结束ps aux | grep openclawkill -9 三、重启失败排查3.1 端口被占用错误信息：Error: listen EADDRINUSE...openclaw gateway --force3.2 systemd 不可用错误信息：systemctl --user unavailable: spawn systemctl ENOENT 说明：这通常发生在容器环境中...3.3 配置错误导致启动失败排查步骤：# 运行诊断openclaw doctor --fix# 查看详细日志openclaw logs --follow# 检查配置文件cat ~/.openclaw/openclaw.json

    8.1K30

    老周虾扯：OpenClaw 架构原理与核心机制深度解析

    ，负责： WebSocket 连接管理：所有客户端（CLI、App、WebChat）通过 WS 连接到 Gateway 消息路由：将来自各渠道的消息路由到对应的 Agent 会话 工具调用代理：浏览器控制...加载配置（openclaw.json） 2. 初始化认证模块（auth.ts） 3. 启动 HTTP 服务（server-http.ts） 4....链 错误分类（账单错误、限速错误、模型不可用等） 八、Skills 平台 8.1 Skills 架构 Skills 是 OpenClaw 的扩展机制，本质是注入到 System Prompt 的指令文件...三种 Skills 类型： 类型 位置 说明 内置 Skills skills/ 目录 随 OpenClaw 发布 托管 Skills ~/.openclaw/skills/ 通过 ClawHub 安装...Multi-Agent） 10.1 设计理念 OpenClaw 支持 Agent 间协作，主 Agent 可以 spawn 子 Agent 执行并行任务： 主 Agent │ ├─ sessions_spawn

    1.1K10

    openclaw v2026.4.24 发布：Google Meet 深度集成、DeepSeek V4 上线、浏览器自动化与插件架构全面升级

    插件 / Voice Call • 跨进程内插件上下文重用 webhook 运行时，避免当 agent 工具或 CLI 命令在 Gateway 已拥有语音 webhook 端口时出现 EADDRINUSE...插件 / 运行时依赖 • 隔离用于捆绑插件运行时依赖修复的内部 npm 缓存，并让包更新刷新/验证已当前的安装，使失败的更新或 sudo doctor 运行可以通过重新运行 openclaw update...• 在同步 npm 安装开始前记录捆绑插件运行时依赖暂存，并包含经过时间，使升级后的首次启动在依赖修复期间看起来不再卡住。...认证 / Codex • 在新安装时从 Codex CLI 凭证引导 openai-codex:default，而不替换稍后本地刷新的 OpenClaw OAuth 令牌。...插件 SDK / 工具结果转换 • 绑定中间件详情，验证原地结果突变，并将失败关闭的中间件回退标记为规范错误状态。

    46610

    openclaw v2026.3.11正式发布：安全强化、内核优化与跨平台体验全面升级

    • 插件运行安全限制：未认证的插件HTTP路由不再继承网关的管理权限，即admin级方法如sessions.delete将被完全阻断，保证插件仅能在授权范围内执行。...• 新的入门检测机制可识别需要共享认证令牌的远程网关，并给出定位说明。 • LaunchAgent安装路径安全加固，防止组/全局可写导致的启动失败。...（7）执行与命令行增强 • 子命令环境增加OPENCLAW_CLI标识，用于区分子进程来源。 • 归档与提取机制强化，针对tar与外部安装过程增加安全展开策略，预防符号链接逃逸。...五、整体总结 代码地址：github.com/openclaw/openclaw openclaw v2026.3.11是一次跨层级的稳定发行，涵盖安全加固、跨平台交互、AI模型扩展、插件生态整合、运行时优化和多沟通渠道的全模块升级...运维与CLI工具完善：从技能输出到命令关闭均更稳定。 5. 网关与ACP插件体系成熟化：实现多层会话恢复与桥接兼容。 · 我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。

    69410

    openclaw v2026.3.23 发布：模型接入、插件体系、CLI、代理与安全能力全面进化的里程碑版本

    一、版本概览：一次“基础设施级”的大版本更新 openclaw v2026.3.23 是一次覆盖模型接入、插件运行时、CLI、代理系统、浏览器自动化、安全机制与控制台 UI 的全方位升级版本。...Bundled 插件运行时重新随 npm 包发布 修复以下问题： • WhatsApp • Matrix • 其他插件 runtime-api.js 缺失 效果： • 全局 npm 安装不再失败 • 插件运行时表面完整恢复...插件安装、卸载与兼容性修复 • 安装时根据当前运行时版本校验插件 API • 修复 ClawHub 版本常量过期导致的安装失败 • 卸载支持： • clawhub: • 不带版本号的包名 • 旧插件 allow...Failover 逻辑更精准 • 仅将真正的瞬时错误标记为可重试 • 避免： • 账单错误 • 认证错误 • 格式 / 上下文错误 被误判为可回退 2....• npm 包必须包含： • 既有 bundled 插件 • Control UI 静态资源 • 缺失即发布失败 十二、总结：为什么 v2026.3.23 是必升版本 代码地址：bgithub.xyz

    62010

    openclaw v2026.3.24 版本发布：从OpenAI模型与Embedding到Teams与Slack交互 全链路体验与稳定性一次补齐

    一、版本更新概览 openclaw于2026年3月25日正式发布v2026.3.24版本，本次更新聚焦OpenAI生态兼容、智能体工具能力、多平台交互体验、技能安装与管理、CLI与容器支持、UI界面优化...CLI/update更新前置检查 • 在openclaw update执行全局包安装前，预检查目标npm包的engines.node要求 • 过时Node运行时会触发清晰的升级提示，而非尝试安装不支持的最新版本...Slack线程 • Docker/安装：通过openclaw-gateway路由安装时的配置写入，避免预启动openclaw-cli共享网络命名空间循环，解决全新Docker安装在网关启动前失败的问题...• 网关/通道：保持通道启动顺序，同时隔离各通道启动失败，单个故障通道不再阻塞后续通道启动 • Discord/网关监控：将网关错误处理集中到生命周期管理的监控器中，统一分类早期、活跃、后期拆除阶段的Carbon...恢复#General主题1路由，支持原生命令、交互回调、入站消息上下文与回退错误回复 • Telegram/出站错误：保留可操作的403成员/阻止/踢出详情，将机器人非成员视为永久交付失败，停止重试无效聊天

    46410

    OpenClaw.NET 兼容性目录指南（Compatibility Catalog）

    ； 典型诊断码： 诊断码 含义 config_one_of_mismatch 配置不满足 oneOf 约束 unsupported_cli_registration 插件尝试注册不支持的 CLI 命令.../ expectedSkillNames 完整暴露； incompatible 插件：执行安装、加载，断言加载失败且诊断码集合至少包含 expectedDiagnosticCodes 中的全部条目。...（如"配置 schema 错误，请参考插件文档"） 与 NativeAOT 的关系 OpenClaw.NET 的 NativeAOT 约束直接影响清单的加载与序列化方式： 嵌入资源：compat/public-smoke.json...先行验证 "expected tool not found" 插件未声明该工具或工具名拼写错误 校对 expectedToolNames 与插件运行时实际暴露的工具名 编译期错误 "npm-plugin...=1 后重试 clawhub 安装失败 Node.js 未安装或版本过低 安装 Node.js 20+ 并确保 npx 可用 expectedDiagnosticCodes 不匹配 错误码命名变更或新增

    10710

    OpenClaw本地部署教程和常见问题汇总

    如果端口被占用，使用其他端口 openclaw gateway --port 18790 4.2 服务启动后自动停止 症状：启动后几秒自动关闭 原因： 配置文件错误 API Key 无效 磁盘空间不足...openclaw sudo systemctl start openclaw 4.5 升级后服务无法启动 症状：更新 OpenClaw 后 Gateway 启动失败 解决方案： # 1....专区查看：https://cloud.tencent.com/developer/article/2624973 5.1 飞书插件安装失败 错误信息： spawn npm ENOENT 原因：...restart 重启服务 openclaw gateway --verbose 前台启动（看日志） openclaw gateway install 安装系统服务 6.3 插件管理 命令 功能...openclaw plugins list 列出插件 openclaw plugins install 安装插件 openclaw plugins remove 卸载插件

    10.9K35

    OpenClaw Zalo 个人号插件 (Zalo Personal Plugin) 指南

    zalo (保留)：预留给未来可能出现的 Zalo 官方企业 API (Official API) 集成。运行架构运行位置：插件直接运行在 OpenClaw Gateway 进程内部。...部署注意：如果你使用远程 Gateway，必须将插件安装并配置在运行 Gateway 的那台机器上，然后重启 Gateway。️...restart方式 B：本地开发模式# 安装插件链接openclaw plugins install ....四、登录与管理 (CLI)由于是非官方协议，登录通常需要通过扫码认证。所有操作通过 openclaw channels 命令完成。1....消息发送失败1. 对方不是好友 (若策略为 pairing)。2. 触发风控。检查 dmPolicy 配置；暂停发送，冷却账号 24 小时。找不到群组群组 ID 错误或权限不足。

    39320

    OpenClaw 密集更新，小龙虾在持续进化：记忆永不忘记、话题绑定助手、更安全

    2.4 未来可能的玩法 想象一下： • 有的插件专门帮你总结每天的对话，生成日报 • 有的插件能把重要的对话自动保存到你的笔记软件 • 有的插件能跨多个会话共享记忆 这个插件接口就像是打开了一扇门，未来会有越来越多有趣的插件出现...4.5 扩展依赖烘焙：预安装你需要的扩展 另一个实用的功能是 OPENCLAW_EXTENSIONS。 你可以在构建镜像时指定要预安装的扩展，这样镜像启动时就已经包含了你需要的扩展，不用再等安装了。...否则，启动、配对或 TUI 可能会失败。 为什么要这样改？ 以前 OpenClaw 会自动猜测你想用哪种认证方式，但这样容易出错。现在要求你明确指定，更安全也更可靠。...步骤四：验证 启动后检查一下： • 绑定关系还在吗？ • 各渠道功能正常吗？ • 日志里有没有错误？ 6.3 如果出问题了怎么办？...• 试试新的多阶段构建镜像 • 用 OPENCLAW_EXTENSIONS 预安装你需要的扩展 • 试试 slim 变体 如果你是插件开发者： • 研究一下 Context Engine 插件接口 •

    1.5K10

    OpenClaw插件配置文件中最常见的错误类型及解决方案

    插件配置文件（如OpenClaw中~/.openclaw/openclaw.json）是插件正常运行的核心。一旦配置有误，轻则功能异常，重则服务启动失败。...以下是插件配置文件中最常见的错误类型及解决方案，适用于sliverp/qqbot等基于OpenClaw的插件。1.❌JSON格式语法错误这是最常见、也最容易被忽视的问题。...❌缺少必要字段插件启动时会校验必需参数。...❌多插件配置冲突若同时安装多个通道插件（如qqbot+telegram），可能因共用字段名冲突。...参考官方示例查看sliverp/qqbot仓库中的example.config.json。配置文件虽小，却是系统稳定运行的基石。养成规范编辑、及时验证的习惯，可大幅减少“神秘启动失败”类问题。

    1.5K30

    OpenClaw 多 Agent 协作研发：5 个 AI 员工，从需求到代码自动流转

    ，Director 用高质量模型 bindings：飞书账号绑定到 Director，其他 Agent 不直接与用户交互 步骤 3：配置飞书集成 3.1 安装飞书插件 openclaw plugins...**错误处理**：如果某个子任务失败，继续执行其他任务，最后汇总错误信息 4....{ "path": "~/.openclaw/skills/code-analyzer", "enabled": true } ] } 步骤 7：启动系统 # 启动...❌ sessions_spawn 当 maxSpawnDepth >= 2 时，深度 1 的编排器额外获得： ✅ sessions_spawn ✅ subagents ✅ sessions_list...错误处理 ✅ 推荐做法： Director 监控所有子任务状态 单个子任务失败不影响其他任务 记录详细错误日志 提供重试机制 ❌ 避免做法： 忽略子任务失败 一个任务失败就停止整个流程 错误信息不清晰

    3.3K12

    【保姆级教程】手把手教你安装OpenClaw并接入飞书，让AI在聊天软件里帮你干活

    ：检测系统环境安装必要依赖（Node.js 等）下载 OpenClaw 核心文件配置环境变量启动配置向导注意：如果命令执行后，还是报错，可以自己到官网下载node安装包，自己安装node环境，注意版本最好在...）给应用添加机器人六）给应用配置权限把即时通讯相关的权限全部开通：七）创建版本并发布来到飞书客户端进行审批：八）安装飞书插件打开powershell，输入以下命令，安装飞书插件：openclaw plugins...install @m1heng-clawd/feishu安装成功后，再打开一个新的命令窗口，开始配置飞书插件：输入命令：openclaw config选择渠道:选择配置链接:输入飞书的AppID，AppSecrect...停止服务openclaw update更新到最新版本openclaw doctor诊断问题openclaw uninstall卸载 OpenClaw八、常见问题解答Q1: 安装飞书插件提示：spawn...：openclaw doctor 检查问题如提示网络问题，检查防火墙设置Q4: API Key 配置错误解决方法：执行：openclaw onboard选择重新配置 API Key确保密钥格式正确Q5:

    324.2K3980

    OpenClaw 插件开发指南

    前置条件OpenClaw已安装npminstall-gopenclaw@latestNode.js22+node--version#需要v22或更高Gateway已运行openclawgatewaystatus...>/工作区插件任意路径（通过plugins.load.paths配置）开发中插件创建目录#WindowsPowerShellmkdir-pC:\Users\的用户名>\.openclaw\extensions.../cd~/.openclaw/extensions/Bash步骤2：创建插件清单openclaw.plugin.json这是必须的文件，用于插件发现和配置验证...：npm包管理└──node_modules/#依赖PlainText常见问题1️⃣插件加载失败#查看详细错误openclawpluginsdoctor#查看日志openclawgatewaylogsBash2️⃣...4️⃣配置不生效确保插件ID匹配（openclaw.plugin.json的id=plugins.entries的键）确保在plugins.allow中重启Gateway参考文档完整插件文档：D:\SoftDev

    68520

    三位一体架构详解 —— 网关层、协议层、智能体系如何协同工作

    插件可同时运行 3 个不同号码状态快照：UI 可实时查看“账号 A 已连接，账号 B 正在重试” 网关层是 OpenClaw 的“外交官”——它不懂 AI，但能和全世界对话。... 多端（Web/iOS/Android/CLI）因此，OpenClaw 定义了 ACP（Agent Client Protocol）——一种专为 AI Agent 设计的轻量级 JSON-RPC 变体。...：智能体直接运行在网关进程中，零网络延迟弹性推理：自动压缩上下文、切换模型、重试失败工具即能力：AI 通过阅读 SKILL.md 学会使用新工具 智能体系是 OpenClaw 的“指挥官”——它不碰网络... 可被 ui/ 和 apps/ios/ 同时引用原子发布：修改协议层，自动触发所有客户端 CI本地开发：pnpm run dev 同时启动网关 + Web UI六、解耦的价值：为什么三层架构至关重要？...✅ 下一篇预告：第 3 篇：ACP 协议设计哲学 —— 为什么 OpenClaw 选择自研 Agent Client Protocol

    35400
    点击加载更多

    相关资讯

    热门标签

    更多标签

    活动推荐

      运营活动

      活动名称
      广告关闭

      腾讯云开发者

      扫码关注腾讯云开发者

      扫码关注腾讯云开发者

      领取腾讯云代金券

      热门产品

      热门推荐

      更多推荐

      Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有

      深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号

      腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号

      领券