# goclaw

**Repository Path**: pershow/goclaw

## Basic Information

- **Project Name**: goclaw
- **Description**: No description available
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# goclaw (🐾 狗爪)

Go 语言版本的 OpenClaw - 一个功能强大的 AI Agent 框架。

[![License](https://img.shields.io/:license-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/github.com/smallnest/goclaw) [![github actions](https://github.com/smallnest/goclaw/actions/workflows/go.yaml/badge.svg)](https://github.com/smallnest/goclaw/actions) [![Go Report Card](https://goreportcard.com/badge/github.com/smallnest/goclaw)](https://goreportcard.com/report/github.com/smallnest/goclaw) [![Coverage Status](https://coveralls.io/repos/github/smallnest/goclaw/badge.svg?branch=master)](https://coveralls.io/github/smallnest/goclaw?branch=master)


![](docs/goclaw.png)

## 功能特性

- 🎨 **Web 控制界面 (New!)**：基于 Lit 的现代 Web UI，支持实时聊天、多视图导航、零依赖部署
- 🔥 **配置热重载 (New!)**：支持配置文件热重载，无需重启服务即可应用配置变更
- 📜 **配置历史和回滚 (New!)**：自动记录配置变更历史，支持一键回滚到之前的配置
- 🧠 **高级内存功能 (New!)**：会话文件索引、搜索结果去重、原子重索引
- ⚡ **Agent 架构优化 (New!)**：并行工具执行、认证配置轮换，显著提升性能和可靠性
- 🛠️ **完整的工具系统**：FileSystem、Shell、Web、Browser，支持 Docker 沙箱与权限控制
- 📚 **技能系统 (Skills)**：兼容 [OpenClaw](https://github.com/openclaw/openclaw) 和 [AgentSkills](https://agentskills.io) 规范，支持自动发现与环境准入控制 (Gating)
- 💾 **持久化会话**：基于 JSONL 的会话存储，支持完整的工具调用链 (Tool Calls) 记录与恢复
- 📢 **多渠道支持**：Telegram、WhatsApp、飞书 (Feishu)、QQ、企业微信 (WeWork)
- 🔧 **灵活配置**：支持 YAML/JSON 配置，热加载
- 🎯 **多 LLM 提供商**：OpenAI (兼容接口)、Anthropic、OpenRouter，支持故障转移
- 🌐 **WebSocket Gateway**：内置网关服务，支持实时通信
- ⏰ **Cron 调度**：内置定时任务调度器
- 🖥️ **Browser 自动化**：基于 Chrome DevTools Protocol 的浏览器控制

## 🎨 Web 控制界面 (New!)

goclaw 现在提供了一个现代化的 Web 控制界面，让您可以通过浏览器与 AI Agent 交互。

### 特性

- ✅ **实时通信**：基于 WebSocket 的实时消息传输
- ✅ **多视图导航**：Chat、Channels、Sessions、Config 多个视图
- ✅ **响应式设计**：支持亮色/暗色主题，自适应布局
- ✅ **零依赖部署**：UI 编译时嵌入到二进制文件，无需额外依赖
- ✅ **自动重连**：网络断开自动恢复连接

### 快速体验

```bash
# 方式 1: 使用演示脚本（推荐）
./demo.sh  # 或 demo.bat (Windows)

# 方式 2: 手动启动
./goclaw gateway run --port 28789
# 然后访问 http://localhost:28789/
```

### 开发 UI

```bash
# 构建 UI
./build-ui.sh  # 或 build-ui.bat (Windows)

# 开发模式（支持热重载）
cd ui && npm run dev
# 访问 http://localhost:5173/
```

### 技术栈

- **前端**: Lit 3.3.2 (Web Components)
- **构建**: Vite 7.3.1
- **语言**: TypeScript
- **后端**: Go embed.FS

详细文档请参考：
- [快速开始指南](QUICKSTART.md)
- [前端移植文档](FRONTEND_MIGRATION.md)
- [完整项目报告](MIGRATION_REPORT.md)

## 🔥 配置热重载 (New!)

goclaw 支持配置文件热重载，无需重启服务即可应用配置变更。

### 特性

- ✅ **自动检测**：监听配置文件变化，自动触发重载
- ✅ **防抖机制**：500ms 防抖延迟，避免频繁重载
- ✅ **配置验证**：重载前验证新配置的有效性
- ✅ **组件更新**：自动更新 Gateway、Channel Manager、Session Manager 等组件
- ✅ **客户端通知**：向所有连接的 WebSocket 客户端广播配置重载事件

### 使用方法

```bash
# 启动 Gateway（自动启用热重载）
goclaw gateway run

# 修改配置文件
vim ~/.goclaw/config.json

# 配置会自动重载，无需重启服务
```

### 手动触发重载

```bash
goclaw gateway reload
```

详细文档请参考：[配置热重载文档](docs/CONFIG_HOT_RELOAD.md)

## 📜 配置历史和回滚 (New!)

goclaw 自动记录所有配置变更，支持查看历史和一键回滚。

### 特性

- ✅ **自动记录**：每次配置变更自动记录
- ✅ **详细信息**：记录时间、变更内容、成功/失败状态
- ✅ **一键回滚**：快速恢复到之前的配置
- ✅ **智能回滚**：自动回滚到最近一次成功的配置

### 使用方法

```bash
# 查看配置变更历史
goclaw gateway history

# 回滚到最近一次成功的配置
goclaw gateway rollback

# 回滚到指定索引的配置
goclaw gateway rollback 2
```

详细文档请参考：[高级功能文档](docs/ADVANCED_FEATURES_COMPLETION.md)

## 🧠 高级内存功能 (New!)

goclaw 提供了强大的内存管理功能，包括会话索引、搜索去重和原子重索引。

### 特性

- ✅ **会话文件索引**：自动索引会话文件，支持全文搜索
- ✅ **搜索结果去重**：基于内容哈希和相似度的智能去重
- ✅ **原子重索引**：安全的数据库重建，支持并发控制

### 使用方法

```go
// 会话文件索引
indexer := memory.NewSessionIndexer(store, sessionDir, 30)
indexer.Start()

// 搜索并去重
results, err := store.SearchWithDeduplication("query", 10)

// 原子重索引
store.ReindexAsync()
```

详细文档请参考：[高级功能文档](docs/ADVANCED_FEATURES_COMPLETION.md)

## ⚡ Agent 架构优化 (New!)

goclaw 实现了先进的 Agent 架构优化，显著提升性能和可靠性。

### 特性

- ✅ **并行工具执行**：多个工具调用并行执行，性能提升高达 80%
- ✅ **认证配置轮换**：自动切换多个 API 配置，可靠性提升 99.75%
- ✅ **增强错误分类**：8 种错误类型，智能识别和处理
- ✅ **指数退避重试**：自动重试临时性错误，成功率提升至 99.99%
- ✅ **智能上下文管理**：4 级优先级，渐进式压缩，保留关键信息

### 使用方法

**并行工具执行**（自动启用）
```bash
# 当 Agent 需要调用多个工具时，自动并行执行
goclaw gateway run
```

**认证配置轮换**
```json
{
  "providers": {
    "failover": {
      "enabled": true,
      "strategy": "round_robin",
      "default_cooldown": "5m"
    },
    "profiles": [
      {
        "name": "primary",
        "provider": "openai",
        "api_key": "sk-xxx",
        "priority": 1
      },
      {
        "name": "backup",
        "provider": "anthropic",
        "api_key": "sk-ant-xxx",
        "priority": 2
      }
    ]
  }
}
```

详细文档请参考：[Agent 架构优化文档](docs/AGENT_OPTIMIZATION_COMPLETION.md)

## 技能系统

goclaw 引入了先进的技能系统，允许用户通过编写 Markdown 文档 (`SKILL.md`) 来扩展 Agent 的能力。

### 特性
*   **Prompt-Driven**: 技能本质上是注入到 System Prompt 中的指令集，指导 LLM 使用现有工具 (exec, read_file 等) 完成任务。
*   **OpenClaw 兼容**: 完全兼容 OpenClaw 的技能生态。您可以直接将 `openclaw/skills` 目录下的技能复制过来使用。
*   **自动准入 (Gating)**: 智能检测系统环境。例如，只有当系统安装了 `curl` 时，`weather` 技能才会生效；只有安装了 `git` 时，`git-helper` 才会加载。

### 使用方法

#### 配置文件加载优先级

goclaw 按以下顺序查找配置文件（找到第一个即使用）：

1. `~/.goclaw/config.json` (用户全局目录，**最高优先级**)
2. `./config.json` (当前目录)

可通过 `--config` 参数指定配置文件路径覆盖默认行为。

#### Skills 加载顺序

技能按以下顺序加载，**同名技能后面的会覆盖前面的**：

| 顺序 | 路径 | 说明 |
|-----|------|------|
| 1 | `传入的自定义目录` | 通过 `NewSkillsLoader()` 指定 |
| 2 | `workspace/skills/` | 工作区目录 |
| 3 | `workspace/.goclaw/skills/` | 工作区隐藏目录 |
| 4 | `<可执行文件路径>/skills/` | 可执行文件同级目录 |
| 5 | `./skills/` (当前目录) | **最后加载，优先级最高** |

默认 `workspace` 为 `~/.goclaw/workspace`。

1.  **列出可用技能**
    ```bash
    ./goclaw skills list
    ```

2.  **安装技能**
    将技能文件夹放入以下任一位置：
    *   `./skills/` (当前目录，最高优先级)
    *   `${WORKSPACE}/skills/` (工作区目录)
    *   `~/.goclaw/skills/` (用户全局目录)

3.  **编写技能**
    创建一个目录 `my-skill`，并在其中创建 `SKILL.md`：
    ```yaml
    ---
    name: my-skill
    description: A custom skill description.
    metadata:
      openclaw:
        requires:
          bins: ["python3"] # 仅当 python3 存在时加载
    ---
    # My Skill Instructions
    When the user asks for X, use `exec` to run `python3 script.py`.
    ```

## 项目结构

```
goclaw/
├── agent/              # Agent 核心逻辑
│   ├── loop.go         # Agent 循环
│   ├── context.go      # 上下文构建器
│   ├── memory.go       # 记忆系统
│   ├── skills.go       # 技能加载器
│   ├── subagent.go     # 子代理管理器
│   └── tools/          # 工具系统
│       ├── filesystem.go   # 文件系统工具
│       ├── shell.go        # Shell 工具
│       ├── web.go          # Web 工具
│       ├── browser.go      # 浏览器工具
│       └── message.go      # 消息工具
├── channels/           # 消息通道
│   ├── base.go         # 通道接口
│   ├── manager.go      # 通道管理器
│   ├── telegram.go     # Telegram 实现
│   ├── whatsapp.go     # WhatsApp 实现
│   ├── feishu.go       # 飞书实现
│   ├── qq.go           # QQ 实现
│   ├── wework.go       # 企业微信实现
│   ├── googlechat.go   # Google Chat 实现
│   └── teams.go        # Microsoft Teams 实现
├── bus/                # 消息总线
│   ├── events.go       # 消息事件
│   └── queue.go        # 消息队列
├── config/             # 配置管理
│   ├── schema.go       # 配置结构
│   └── loader.go       # 配置加载器
├── providers/          # LLM 提供商
│   ├── base.go         # 提供商接口
│   ├── factory.go      # 提供商工厂
│   ├── openai.go       # OpenAI 实现
│   ├── anthropic.go    # Anthropic 实现
│   └── openrouter.go   # OpenRouter 实现
├── gateway/            # WebSocket 网关
│   ├── server.go       # 网关服务器
│   ├── handler.go      # 消息处理器
│   └── protocol.go     # 协议定义
├── cron/               # 定时任务调度
│   ├── scheduler.go    # 调度器
│   └── cron.go         # Cron 任务
├── session/            # 会话管理
│   └── manager.go      # 会话管理器
├── cli/                # 命令行界面
│   ├── root.go         # 根命令
│   ├── agent.go        # Agent 命令
│   ├── agents.go       # Agents 管理命令
│   ├── sessions.go     # 会话命令
│   ├── cron_cli.go     # Cron 命令
│   ├── approvals.go    # 审批命令
│   ├── system.go       # 系统命令
│   └── commands/       # 子命令
│       ├── tui.go      # TUI 命令
│       ├── gateway.go  # Gateway 命令
│       ├── browser.go  # Browser 命令
│       ├── health.go   # 健康检查
│       ├── status.go   # 状态查询
│       ├── memory.go   # 记忆管理
│       └── logs.go     # 日志查询
├── internal/           # 内部包
│   ├── logger/         # 日志
│   └── utils/          # 工具函数
├── docs/               # 文档
│   ├── cli.md          # CLI 详细文档
│   └── INTRODUCTION.md # 项目介绍
└── main.go             # 主入口
```

## 快速开始

### 安装

```bash
# 克隆仓库
git clone https://github.com/smallnest/goclaw.git
cd goclaw

# 安装依赖
go mod tidy

# 编译
go build -o goclaw .

# 或直接运行
go run main.go
```

### 配置

goclaw 按以下顺序查找配置文件（找到第一个即使用）：

1. `~/.goclaw/config.json` (用户全局目录，**最高优先级**)
2. `./config.json` (当前目录)

可通过 `--config` 参数指定配置文件路径覆盖默认行为。

**数据与存储位置**（默认均在 `~/.goclaw/` 下，Windows 为 `%USERPROFILE%\.goclaw\`）：

| 用途 | 默认路径 | 配置项 |
|------|----------|--------|
| 配置文件 | `~/.goclaw/config.json` | 见上方查找顺序 |
| 会话（对话记录） | `~/.goclaw/sessions/*.jsonl` | `session.store` |
| 记忆 DB（builtin） | `~/.goclaw/memory/store.db` | `memory.builtin.database_path` |
| 技能 | `~/.goclaw/skills/` | 见技能系统说明 |
| 工作区 | `~/.goclaw/workspace` | `workspace.path` |

创建 `config.json` (参考 `config.example.json`):

```json
{
  "agents": {
    "defaults": {
      "model": "deepseek-chat",
      "max_iterations": 15,
      "temperature": 0.7,
      "max_tokens": 4096
    }
  },
  "providers": {
    "openai": {
      "api_key": "YOUR_OPENAI_API_KEY_HERE",
      "base_url": "https://api.deepseek.com",
      "timeout": 30,
      "extra_body": {
        "reasoning": {
          "enabled": false
        }
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "your-telegram-bot-token",
      "allowed_ids": ["123456789"]
    }
  },
  "tools": {
    "filesystem": {
      "allowed_paths": ["/home/user/projects"],
      "denied_paths": ["/etc", "/sys"]
    },
    "shell": {
      "enabled": true,
      "allowed_cmds": [],
      "denied_cmds": ["rm -rf", "dd", "mkfs"],
      "timeout": 30,
      "sandbox": {
        "enabled": false,
        "image": "golang:alpine",
        "remove": true
      }
    },
    "browser": {
      "enabled": true,
      "headless": true,
      "timeout": 30
    }
  }
}
```

#### 记忆 (Memory) 与嵌入

当使用内置记忆后端 (`memory.backend: builtin`) 时，可配置 `memory.builtin.embedding` 以启用语义搜索与批量嵌入：

| 字段 | 说明 |
|------|------|
| `provider` | 主嵌入提供商，如 `openai`。需在 `providers.openai` 中配置 `api_key`，或设置环境变量 `OPENAI_API_KEY` |
| `fallback` | 可选。主提供商不可用时的备用提供商（当前实现支持主 provider；fallback 需额外实现） |

- 不配置 `embedding` 时，builtin 仍可工作（仅元数据/FTS，无向量检索）。
- CLI 在无配置文件时会默认启用 `embedding.provider: "openai"`，若已设置 `OPENAI_API_KEY` 即可使用记忆搜索与索引。

### 运行

```bash
# 启动 Web 控制界面（推荐）
./goclaw gateway run --port 28789
# 访问 http://localhost:28789/

# 或使用演示脚本
./demo.sh  # 或 demo.bat (Windows)

# 交互式 TUI 模式
./goclaw tui

# 单次执行 Agent
./goclaw agent --message "你好，介绍一下你自己"

# 查看配置
./goclaw config show

# 查看帮助
./goclaw --help
```

### 启动与测试（从零到跑通）

**1. 前置条件**

- 已安装 Go 1.21+
- （可选）LLM：在 `~/.goclaw/config.json` 或当前目录 `config.json` 中配置 `providers.openai` 的 `api_key`，或设置环境变量 `OPENAI_API_KEY`、`DEEPSEEK_API_KEY` 等
- 记忆嵌入（可选）：同上；不配置则记忆仅元数据，无向量搜索

**2. 构建**

```bash
# 仅构建后端（不打包 UI）
go build -o goclaw .

# Windows 可生成 goclaw.exe
go build -o goclaw.exe .
```

若需要 Web 控制界面，需先构建前端并嵌入（见 [QUICKSTART.md](QUICKSTART.md)）：

```bash
# Windows
build-ui.bat

# Linux/Mac
./build-ui.sh
go build -o goclaw .
```

**3. 启动方式**

| 方式 | 命令 | 说明 |
|------|------|------|
| Web 控制台 | `./goclaw gateway run --port 28789` | 浏览器打开 http://localhost:28789/ |
| 终端 TUI | `./goclaw tui` | 交互式对话 |
| 单次对话 | `./goclaw agent --message "你好"` | 发一条消息并退出 |

**4. 验证新功能**

```bash
# 配置与会话
./goclaw config show
./goclaw sessions list

# 记忆状态（若配置了 memory.builtin.embedding 或 OPENAI_API_KEY）
./goclaw memory status

# 记忆索引（将工作区 MEMORY.md 等做嵌入索引，需 API Key）
./goclaw memory index

# 语义搜索
./goclaw memory search "用户偏好"

# 单次 Agent（会走上下文窗口、截断与可选摘要压缩）
./goclaw agent --message "介绍一下你自己"
```

在 Web 或 TUI 中与 Agent 对话时，可让模型使用 `sessions_list`、`sessions_history`、`session_status` 等会话类工具；长对话触发上下文溢出时会先截断历史再重试，仍超限则会尝试 LLM 摘要压缩后重试。

### 使用示例

```bash
# 查看所有可用命令
./goclaw --help

# 列出所有技能
./goclaw skills list

# 列出所有会话
./goclaw sessions list

# 查看 Gateway 状态
./goclaw gateway status

# 查看 Cron 任务
./goclaw cron list

# 健康检查
./goclaw health
```

## CLI 命令参考

goclaw 提供了丰富的命令行工具，主要命令包括：

### 基本命令

| 命令 | 描述 |
|-----|------|
| `goclaw start` | 启动 Agent 服务 |
| `goclaw tui` | 启动交互式终端界面 |
| `goclaw agent --message <msg>` | 单次执行 Agent |
| `goclaw config show` | 显示当前配置 |

### Agent 管理

| 命令 | 描述 |
|-----|------|
| `goclaw agents list` | 列出所有 agents |
| `goclaw agents add` | 添加新 agent |
| `goclaw agents delete <name>` | 删除 agent |

### Channel 管理

| 命令 | 描述 |
|-----|------|
| `goclaw channels list` | 列出所有 channels |
| `goclaw channels status` | 检查 channel 状态 |
| `goclaw channels login --channel <type>` | 登录到 channel |

### Gateway 管理

| 命令 | 描述 |
|-----|------|
| `goclaw gateway run` | 运行 WebSocket Gateway |
| `goclaw gateway install` | 安装为系统服务 |
| `goclaw gateway status` | 查看 Gateway 状态 |

### Cron 定时任务

| 命令 | 描述 |
|-----|------|
| `goclaw cron list` | 列出所有定时任务 |
| `goclaw cron add` | 添加定时任务 |
| `goclaw cron edit <id>` | 编辑定时任务 |
| `goclaw cron run <id>` | 立即运行任务 |

### Browser 自动化

| 命令 | 描述 |
|-----|------|
| `goclaw browser status` | 查看浏览器状态 |
| `goclaw browser open <url>` | 打开 URL |
| `goclaw browser screenshot` | 截图 |
| `goclaw browser click <selector>` | 点击元素 |

### 其他命令

| 命令 | 描述 |
|-----|------|
| `goclaw skills list` | 列出所有技能 |
| `goclaw sessions list` | 列出所有会话 |
| `goclaw memory status` | 查看记忆状态 |
| `goclaw logs` | 查看日志 |
| `goclaw health` | 健康检查 |
| `goclaw status` | 状态查看 |

详细的 CLI 文档请参考 [docs/cli.md](docs/cli.md)

## 架构概述

goclaw 采用模块化架构设计，主要组件包括：

![](docs/architecture.png)

### 核心组件

1. **Agent Loop** - 主循环，处理消息、调用工具、生成响应
2. **Message Bus** - 消息总线，连接各组件
3. **Channel Manager** - 通道管理器，管理多个消息通道
4. **Gateway** - WebSocket 网关，提供实时通信接口
5. **Tool Registry** - 工具注册表，管理所有可用工具
6. **Skills Loader** - 技能加载器，动态加载技能
7. **Session Manager** - 会话管理器，管理用户会话
8. **Cron Scheduler** - 定时任务调度器

### 通信流程

```
用户消息 → Channel → Message Bus → Agent Loop → LLM Provider
                                                     ↓
                                            Tool Registry → 工具执行
                                                     ↓
Agent Loop ← Message Bus ← Channel ← 响应消息
```

## 开发

### 添加新工具

在 `agent/tools/` 目录下创建新工具文件，实现 `Tool` 接口：

```go
type Tool interface {
    Name() string
    Description() string
    Parameters() map[string]interface{}
    Execute(ctx context.Context, params map[string]interface{}) (string, error)
}
```

然后在 `cli/root.go` 或相关启动文件中注册工具。

### 添加新通道

在 `channels/` 目录下创建新通道，实现 `BaseChannel` 接口：

```go
type BaseChannel interface {
    Name() string
    Start(ctx context.Context) error
    Send(msg OutboundMessage) error
    IsAllowed(senderID string) bool
}
```

### 添加新 CLI 命令

1. 在 `cli/` 目录下创建新文件或添加到 `cli/commands/` 目录
2. 使用 `cobra` 创建命令
3. 在 `cli/root.go` 的 `init()` 函数中注册命令

### 环境变量

goclaw 支持以下环境变量：

| 变量 | 描述 |
|-----|------|
| `GOCRAW_CONFIG_PATH` | 配置文件路径 |
| `GOCRAW_WORKSPACE` | 工作区目录 (默认: `~/.goclaw/workspace`) |
| `ANTHROPIC_API_KEY` | Anthropic API Key |
| `OPENAI_API_KEY` | OpenAI API Key |
| `GOCRAW_GATEWAY_URL` | Gateway WebSocket URL |
| `GOCRAW_GATEWAY_TOKEN` | Gateway 认证 Token |

## 常见问题

### Q: 如何切换不同的 LLM 提供商？

A: 修改配置文件中的 `model` 字段和 `providers` 配置：
- `gpt-4` - OpenAI
- `claude-3-5-sonnet-20241022` - Anthropic
- `deepseek-chat` - DeepSeek (通过 OpenAI 兼容接口)
- `openrouter:anthropic/claude-opus-4-5` - OpenRouter

### Q: 工具调用失败怎么办？

A: 检查工具配置，确保 `enabled: true`，且没有权限限制。查看日志获取详细错误信息：

```bash
./goclaw logs -f
```

### Q: 如何限制 Shell 工具的权限？

A: 在配置中设置 `denied_cmds` 列表，添加危险的命令。也可以启用 Docker 沙箱：

```json
{
  "tools": {
    "shell": {
      "denied_cmds": ["rm -rf", "dd", "mkfs", ":(){ :|:& };:"],
      "sandbox": {
        "enabled": true,
        "image": "golang:alpine",
        "remove": true
      }
    }
  }
}
```

### Q: 如何配置多个 LLM 提供商实现故障转移？

A: 使用 `providers.profiles` 和 `providers.failover` 配置：

```json
{
  "providers": {
    "profiles": [
      {
        "name": "primary",
        "provider": "openai",
        "api_key": "...",
        "priority": 1
      },
      {
        "name": "backup",
        "provider": "anthropic",
        "api_key": "...",
        "priority": 2
      }
    ],
    "failover": {
      "enabled": true,
      "strategy": "round_robin"
    }
  }
}
```

### Q: Browser 工具需要什么依赖？

A: Browser 工具使用 Chrome DevTools Protocol，需要安装 Chrome 或 Chromium 浏览器：

```bash
# Ubuntu/Debian
sudo apt-get install chromium-browser

# macOS
brew install chromium

# 确保 Chrome/Chromium 在 PATH 中
which chromium
```

### Q: 如何调试 Agent 行为？

A: 使用 `--thinking` 参数查看思考过程，或查看日志：

```bash
./goclaw agent --message "测试" --thinking
./goclaw logs -f
```

## 相关文档

- [CLI 详细文档](docs/cli.md) - 完整的命令行参考
- [项目介绍](docs/INTRODUCTION.md) - 深入了解项目设计
- [OpenClaw 文档](https://docs.openclaw.ai) - 原始项目文档
- [AgentSkills 规范](https://agentskills.io) - 技能系统规范

## 许可证

MIT

---

Made with ❤️ by [smallnest](https://github.com/smallnest)