Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
163 changes: 89 additions & 74 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -504,6 +504,80 @@ drclaw daemon -f web
```
</details>

<details>
<summary>OAuth LLM 提供商(OpenAI Codex / GitHub Copilot)</summary>

除 API Key 之外,DrClaw 支持通过 OAuth 登录 OpenAI Codex 和 GitHub Copilot,无需提供 API 密钥。

**完整步骤(从零开始):**

#### 1. 初始化

```bash
drclaw onboard
```

#### 2. OAuth 登录

根据你使用的提供商选择一个:

```bash
# OpenAI Codex
drclaw provider login openai-codex

# GitHub Copilot
drclaw provider login github-copilot
```

OpenAI Codex 会启动浏览器交互式 OAuth 流程;GitHub Copilot 使用设备码流程(device flow),终端会显示一个验证码和链接。

#### 3. 修改配置

编辑 `~/.drclaw/config.json`,将 OAuth 提供商配置写到 `providers.default`,并把 `active_provider` 指向 `default`;`api_key` 留空即可:

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

为了防止用户误解并直接复制粘贴覆盖整个 config.json 文件,建议在此处添加一句提示,说明这只是配置文件的一部分,需要合并而非替换。这可以避免用户丢失其他重要的配置项。

Suggested change
> **注意**:以下代码片段仅为 config.json 的相关部分,请将其合并到您的配置中,而不是直接覆盖整个文件。

```json
{
"providers": {
"default": {
"model": "openai-codex/gpt-5.1-codex",
"api_key": ""
}
},
"active_provider": "default"
}
```

GitHub Copilot 示例:

```json
{
"providers": {
"default": {
"model": "github_copilot/gpt-4o",
"api_key": ""
}
},
"active_provider": "default"
}
```

#### 4. 启动

```bash
# 命令行聊天
drclaw chat

# 或 macOS 托盘模式
drclaw tray

# 或 daemon 模式
drclaw daemon -f web
```

登录后的 OAuth token 会被缓存,后续启动自动使用,无需重复登录。

</details>

**Serper网页搜索:**
```json
{
Expand Down Expand Up @@ -544,7 +618,8 @@ docker run -p 127.0.0.1:8080:8080 ...

一系列测试中功能正在逐步完善。这些功能未经过充分测试,请谨慎使用。

### 单 Project 多 Agent
<details>
<summary>单 Project 多 Agent</summary>

单个 project 现在支持一个 `project manager` 加多个 `student agent` 的层级结构。

Expand All @@ -560,7 +635,10 @@ docker run -p 127.0.0.1:8080:8080 ...
- `/api/agents` 和 daemon 运行时已经能区分 `project_manager` 与 `project_student`
- daemon 在 `--debug` / `--debug-full` 下会输出 student agent 的执行摘要,并在 debug jsonl 中记录 `agent_id`

### Docker Sandbox Job
</details>

<details>
<summary>Docker Sandbox Job</summary>

Student agent 现在可以通过 `create_job` 启动一个 Docker sandbox job 来执行高风险 shell 任务。

Expand All @@ -571,7 +649,10 @@ Student agent 现在可以通过 `create_job` 启动一个 Docker sandbox job
- 容器完成后会自动退出并清理;保留 job 记录、workspace 和 artifacts
- 仍属于测试中能力,后续补充 approval、容器内 agent worker 和更严格的网络/权限控制

### 外部智能体接入(External Agent Protocol)
</details>

<details>
<summary>外部智能体接入(External Agent Protocol)</summary>

将任意外部智能体连接到DrClaw中,让DrClaw一并管理,派发任务,收取结果会汇报给你。

Expand Down Expand Up @@ -639,7 +720,10 @@ Student agent 现在可以通过 `create_job` 启动一个 Docker sandbox job
- 出于安全考虑,当前版本只建议和本地部署的外部智能体通信
- 当前版本不支持鉴权机制

### 通过 ACPX 让 Project Agent 使用 Codex
</details>

<details>
<summary>通过 ACPX 让 Project Agent 使用 Codex</summary>

DrClaw 现在支持让 `project agent` 通过现有的 `exec` / `long_exec` 工具直接执行标准 `acpx` CLI,从而使用 Codex。当前实现**不新增专用 acpx tool**,也**不把 acpx 做成 provider**;agent 看到的是 ACPX 使用说明和内置 skill,然后自己调用 shell 工具执行命令。

Expand Down Expand Up @@ -729,76 +813,7 @@ drclaw projects create "acpx-test"
acpx codex sessions close drclaw-proj-<project-id>-<task-suffix>
```

### OAuth LLM 提供商(OpenAI Codex / GitHub Copilot)

除 API Key 之外,DrClaw 支持通过 OAuth 登录 OpenAI Codex 和 GitHub Copilot,无需提供 API 密钥。

**完整步骤(从零开始):**

#### 1. 初始化

```bash
drclaw onboard
```

#### 2. OAuth 登录

根据你使用的提供商选择一个:

```bash
# OpenAI Codex
drclaw provider login openai-codex

# GitHub Copilot
drclaw provider login github-copilot
```

OpenAI Codex 会启动浏览器交互式 OAuth 流程;GitHub Copilot 使用设备码流程(device flow),终端会显示一个验证码和链接。

#### 3. 修改配置

编辑 `~/.drclaw/config.json`,将 OAuth 提供商配置写到 `providers.default`,并把 `active_provider` 指向 `default`;`api_key` 留空即可:

```json
{
"providers": {
"default": {
"model": "openai-codex/gpt-5.1-codex",
"api_key": ""
}
},
"active_provider": "default"
}
```

GitHub Copilot 示例:

```json
{
"providers": {
"default": {
"model": "github_copilot/gpt-4o",
"api_key": ""
}
},
"active_provider": "default"
}
```

#### 4. 启动

```bash
# 命令行聊天
drclaw chat

# 或 macOS 托盘模式
drclaw tray

# 或 daemon 模式
drclaw daemon -f web
```

登录后的 OAuth token 会被缓存,后续启动自动使用,无需重复登录。
</details>

## 使用

Expand Down