OpenClaw 安裝與 Claude Code Bridge 技能配置

OpenClaw 是什麼？

OpenClaw 是一個 AI Agent 編排框架，三層架構中的第二層。它負責：

任務理解與拆解
Skills 管理（可復用的能力模塊）
通過 Bridge 機制調用其他工具（Claude Code、終端等）

步驟 1：安裝 OpenClaw

# 通過 npm 安裝
npm install -g openclaw

# 或從源碼安裝
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

驗證：

openclaw --version

步驟 2：初始化配置

openclaw init

這會創建 ~/.openclaw/ 目錄：

~/.openclaw/
├── openclaw.json        # 主配置
├── agents/              # 子 Agent 定義
├── skills/              # Skills 目錄
├── workspace/           # 工作空間
├── plugins/             # 插件
├── memory/              # 長期記憶
└── logs/                # 日誌

步驟 3：配置 LLM 後端

編輯 ~/.openclaw/openclaw.json：

{
  "models": {
    "default": "deepseek",
    "providers": {
      "deepseek": {
        "api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
        "base_url": "https://api.deepseek.com/v1",
        "models": ["deepseek-chat", "deepseek-reasoner"]
      },
      "modelstudio": {
        "api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
        "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "models": ["qwen-max", "qwen-plus", "qwen-coder-plus"]
      }
    }
  }
}

步驟 4：安裝 Claude Code Bridge 技能

這是連接 OpenClaw 和 Claude Code 的關鍵橋樑。

4.1 安裝技能

# 從技能市場安裝
openclaw skill install claude-code-bridge

# 或手動安裝
cd ~/.openclaw/skills
git clone https://github.com/openclaw/skills-claude-code-bridge.git claude-code-bridge

4.2 配置 Bridge

openclaw skill config claude-code-bridge

編輯打開的配置文件：

{
  "claude_code": {
    "binary_path": "/opt/homebrew/bin/claude",
    "default_model": "claude-sonnet-4-20250514",
    "timeout_seconds": 300,
    "max_concurrent_sessions": 3,
    "workspace": "~/.openclaw/workspace/claude-code",
    "auto_compact": true,
    "compact_threshold": 80000
  },
  "fallback": {
    "enabled": true,
    "provider": "deepseek",
    "model": "deepseek-chat"
  }
}

4.3 驗證 Bridge

openclaw skill test claude-code-bridge

預期輸出：

✓ Claude Code binary found at /opt/homebrew/bin/claude
✓ Claude Code version: 1.x.x
✓ API connection verified
✓ Bridge ready

步驟 5：配置 Hermes ↔ OpenClaw 連線

讓 Hermes Agent 能調用 OpenClaw：

在 Hermes 端配置

~/.hermes/config.yaml：

integrations:
  openclaw:
    enabled: true
    endpoint: "http://localhost:3001"  # OpenClaw API 端口
    api_key: "oc_xxxxxxxxxxxx"

在 OpenClaw 端配置

~/.openclaw/openclaw.json：

{
  "server": {
    "port": 3001,
    "host": "127.0.0.1",
    "api_keys": ["oc_xxxxxxxxxxxx"]
  }
}

步驟 6：啟動 OpenClaw

# 開發模式
openclaw serve --dev

# 生產模式
openclaw serve

# 後台運行
openclaw serve --daemon

步驟 7：端到端測試

通過飛書向 Hermes 發送：

通過 OpenClaw 調用 Claude Code，在 OpenClaw 項目目錄下創建一個 README_CN.md 文件，內容為項目的中文簡介。

完整流程：

飛書 → Hermes 接收
Hermes → OpenClaw API 傳遞任務
OpenClaw → Claude Code Bridge → Claude Code 執行
Claude Code 創建文件 → 返回結果
OpenClaw → Hermes 回傳
Hermes → 飛書回覆用戶

常用管理指令

# 查看運行狀態
openclaw status

# 查看已安裝的 Skills
openclaw skill list

# 查看 Claude Code Bridge 狀態
openclaw skill status claude-code-bridge

# 查看日誌
openclaw logs --tail 50

# 重啟服務
openclaw restart