OpenClaw + Claude Code 完整配置指南：两种集成方式与 Skills 生态

发布日期：2026-05-19 | 适用版本：OpenClaw v2026.5.18（2026-05-18）/ Claude Code（2026-05）

OpenClaw（GitHub 373,000⭐，v2026.5.18，Peter Steinberger 作者）是运行在本地的开源 AI 助手，通过两种方式与 Claude Code 深度集成：一是将 Claude 模型配置为 OpenClaw 的主推理引擎（直连 Anthropic API 或复用 Claude CLI 登录）；二是通过 MCP Bridge（openclaw mcp serve）让 Claude Code 访问 OpenClaw 的 7 个 Bridge 工具，实现在代码编辑过程中读写 IM 频道、控制跨渠道会话。

---

---

OpenClaw 是什么？

OpenClaw 是 PSPDFKit 创始人 Peter Steinberger 主导开发的开源个人 AI 助手，核心定位是："Any OS. Any Platform. The lobster way. 🦞"

与 Claude Code 这类单一编程助手不同，OpenClaw 的设计目标是成为跨平台统一入口——同一个 AI Agent 可以同时接收 WhatsApp、Telegram、Slack、Discord、iMessage、WeChat、QQ 等 20+ 渠道的消息，在本地运行推理，把回复发回对应渠道。

GitHub 373,000⭐（77,400 forks）、赞助商包括 OpenAI、GitHub、NVIDIA、Vercel——这是当前热度最高的开源 AI Agent 项目之一。

---

两种与 Claude Code 集成的路径

方式	目的	需要什么
路径一：把 Claude 设为 OpenClaw 的推理模型	OpenClaw 用 Claude 来理解和回复各渠道消息	Anthropic API Key 或已安装 Claude Code
路径二：把 OpenClaw 作为 MCP 工具接入 Claude Code	在 Claude Code 中直接读写 OpenClaw 管理的 IM 频道	已运行的 OpenClaw Gateway

两者可以同时启用——Claude Code 通过 MCP 控制 OpenClaw，而 OpenClaw 自身也用 Claude 作为推理引擎。

---

第一步：安装 OpenClaw

# 全局安装（推荐）
npm install -g openclaw@latest

# 初始化并安装守护进程
openclaw onboard --install-daemon

运行时要求：Node 24（推荐），最低 Node 22.19+

验证安装：

openclaw --version
# 应输出：2026.5.18

openclaw doctor
# 检查运行时、认证、网络连通性和配置健康状态

---

路径一：将 Claude 配置为 OpenClaw 的推理引擎

方式 A：Anthropic API Key（推荐）

# 一行命令完成引导
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

# 验证可用模型
openclaw models list --provider anthropic

对应的 ~/.openclaw/openclaw.json 配置：

{
  env: { ANTHROPIC_API_KEY: "sk-ant-api03-xxxx" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" }
    }
  }
}

方式 B：复用 Claude Code 的登录（无需额外 API Key）

如果你已经安装并登录了 Claude Code，可以让 OpenClaw 复用同一个认证：

# 确认 Claude Code 已登录
claude --version

# 引导时选择 Claude CLI 选项
openclaw onboard

~/.openclaw/openclaw.json 配置：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-7" },
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" }
        }
      }
    }
  }
}

agentRuntime: { id: "claude-cli" } 告诉 OpenClaw 通过 Claude Code 的 CLI 运行时来执行推理，不额外消耗 API Key 配额。

高级配置选项

功能	配置参数	说明
思考模式	params: { thinking: "adaptive" }	Claude claude-opus-4-7 默认 adaptive
提示缓存	params: { cacheRetention: "long" }	可选 short / long / none
1M 上下文	params: { context1m: true }	Beta 功能，长文档处理
快速模式	params: { fastMode: true }	映射 service_tier: "auto"

---

路径二：在 Claude Code 中通过 MCP 访问 OpenClaw

这是两者集成中更有趣的方向：在 Claude Code 的编辑会话里，直接控制 OpenClaw 管理的所有 IM 渠道。

2.1 启动 OpenClaw MCP Bridge

openclaw mcp serve

或连接远程 Gateway：

openclaw mcp serve \
  --url wss://gateway-host:18789 \
  --token-file ~/.openclaw/gateway.token \
  --claude-channel-mode on

--claude-channel-mode on 启用 Claude 专属通知模式，Claude Code 可以接收 notifications/claude/channel 入站消息事件。

2.2 配置 Claude Code 的 MCP 服务器

方式一：修改 .claude/mcp.json

{
  "mcpServers": {
    "openclaw": {
      "command": "openclaw",
      "args": ["mcp", "serve", "--claude-channel-mode", "on"]
    }
  }
}

方式二：命令行添加

claude mcp add openclaw -- openclaw mcp serve --claude-channel-mode on

2.3 MCP Bridge 提供的 7 个工具

工具	用途
conversations_list	列出所有有路由元数据的会话
messages_read	读取历史转录消息
events_poll	拉取实时事件队列
events_wait	长轮询等待新事件
messages_send	通过现有路由发送消息
permissions_list_open	查看待审批的权限请求
permissions_respond	批准或拒绝审批（allow-once / always / deny）

配置完成后，在 Claude Code 会话中可以直接：

"读取过去 1 小时内 Slack #deploy 频道的所有消息，总结待解决的问题"
"把刚才的代码审查结果发给 Telegram 群里的 @devteam"
"列出所有待审批的 OpenClaw 权限请求，全部批准"

---

Skills 生态：13,729 个可用技能

ClawHub（ClawHub.io）是 OpenClaw 的官方技能市场，截至 2026 年 5 月注册了 13,729 个 skills，精选列表收录 5,198 个（过滤掉垃圾/重复/恶意共 7,215 个）。

按分类统计（前 5 名）：

分类	Skills 数量
Coding Agents & IDEs	1,184
Web & Frontend Development	919
DevOps & Cloud	393
Search & Research	345
Browser & Automation	323

与 Claude Code 直接相关的 Skills

Skill Slug	功能
claude-code-skill	MCP 集成，将 Claude Code 接入 OpenClaw
claude-code-usage	查看 Claude Code OAuth 使用限额
claude-connect	将 Claude 连接到 ClawdBot
aetherlang-claude-code	在 Claude Code 中执行 AetherLang V3 AI 工作流

安装 skill：

# 从 ClawHub 安装
clawhub install claude-code-skill

# 或手动复制到 skills 目录
cp -r ./my-skill ~/.openclaw/workspace/skills/

---

常见报错排查

401 / 认证失败

# 检查 API Key 是否写入
cat ~/.openclaw/openclaw.json | grep ANTHROPIC

# 重新引导
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

"新 Agent 找不到凭证"

OpenClaw 的子 Agent 不自动继承主 Agent 的 API Key，需对每个新 Agent 运行 openclaw onboard 重新配置。

MCP Bridge 断开 / 事件丢失

MCP 事件队列从 bridge 连接时开始计，不回放历史。若 Claude Code 重启后事件丢失，重新运行 openclaw mcp serve 即可。

模型冷却中

openclaw models status --json

检查各模型状态，等待冷却期结束或在 config.json 中添加备用模型配置。

---

---

FAQ

Q：OpenClaw 和 Claude Code 的定位有什么区别，为什么要一起用？
A：Claude Code 是专注代码编写的终端 AI 助手；OpenClaw 是跨渠道 AI 通信平台——它能同时管理 WhatsApp、Telegram、Slack 等 20+ 渠道的消息。一起用的核心场景是：在写代码的同时，让 Claude Code 通过 MCP 工具直接读写 IM 频道，比如"把这个 PR 改动的摘要发给团队的 Slack 群"，不需要切换任何窗口。

Q：复用 Claude CLI 登录（方式 B）和 API Key 方式有什么区别？
A：agentRuntime: { id: "claude-cli" } 通过 Claude Code 的 CLI 运行时来执行推理，适合已经订阅 Claude Pro/Max 的用户——不消耗 API Key 的 token 配额，直接走订阅额度。API Key 方式则适合按量付费或需要精确控制费用的场景，两者功能完全相同。

Q：openclaw mcp serve 和 openclaw mcp set 有什么区别？
A：openclaw mcp serve 是让 OpenClaw 作为 MCP 服务器运行，供 Claude Code 等 MCP 客户端连接；openclaw mcp set 是向 OpenClaw 注册出站 MCP 服务器（让 OpenClaw 去连接其他 MCP 服务，如 context7-mcp 等），方向相反。

Q：国内访问 Anthropic API 怎么解决？
A：在 ~/.openclaw/openclaw.json 的 env 字段中同时设置代理：

{
  env: {
    ANTHROPIC_API_KEY: "sk-ant-...",
    HTTPS_PROXY: "http://your-proxy:port"
  }
}

或使用七牛云 AI 兼容端点（需支持 Anthropic Messages 协议格式的代理层），通过 ANTHROPIC_BASE_URL 覆盖默认端点。

---

总结

OpenClaw（373k⭐，v2026.5.18）与 Claude Code 的集成分两个方向：配置 Claude 为推理引擎（API Key 或复用 Claude CLI 两行命令完成）+ 通过 MCP Bridge 让 Claude Code 操控 IM 渠道（openclaw mcp serve + Claude Code 端 mcpServers 配置）。ClawHub 的 13,729 个 skills 覆盖了从 Coding 到 DevOps 的全部场景，clawhub install claude-code-skill 一条命令安装 MCP 集成技能。

本文配置基于：OpenClaw v2026.5.18（2026-05-18）官方文档、openclaw/openclaw GitHub 仓库（373k⭐）。

---

参考资源

• OpenClaw GitHub：https://github.com/openclaw/openclaw（373k⭐）
• AI编程工具配置大全（AI Coding）：https://developer.qiniu.com/aitokenapi/13417/tools-AI-Coding-api