From cbdf5bd1ba2380db1db08096430a78dac06039a0 Mon Sep 17 00:00:00 2001 From: qzzqzzb Date: Fri, 20 Mar 2026 11:52:08 +0800 Subject: [PATCH] docs: reorganize readme config entries --- README.md | 163 +++++++++++++++++++++++++++++------------------------- 1 file changed, 89 insertions(+), 74 deletions(-) diff --git a/README.md b/README.md index 5d0bf41..9766a7b 100644 --- a/README.md +++ b/README.md @@ -504,6 +504,80 @@ drclaw daemon -f web ``` +
+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 会被缓存，后续启动自动使用，无需重复登录。 + +
+ **Serper网页搜索:** ```json { @@ -544,7 +618,8 @@ docker run -p 127.0.0.1:8080:8080 ... 一系列测试中功能正在逐步完善。这些功能未经过充分测试，请谨慎使用。 -### 单 Project 多 Agent +
+单 Project 多 Agent 单个 project 现在支持一个 `project manager` 加多个 `student agent` 的层级结构。 @@ -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 +
+ +
+Docker Sandbox Job Student agent 现在可以通过 `create_job` 启动一个 Docker sandbox job 来执行高风险 shell 任务。 @@ -571,7 +649,10 @@ Student agent 现在可以通过 `create_job` 启动一个 Docker sandbox job - 容器完成后会自动退出并清理；保留 job 记录、workspace 和 artifacts - 仍属于测试中能力，后续补充 approval、容器内 agent worker 和更严格的网络/权限控制 -### 外部智能体接入（External Agent Protocol） +
+ +
+外部智能体接入（External Agent Protocol） 将任意外部智能体连接到DrClaw中，让DrClaw一并管理，派发任务，收取结果会汇报给你。 @@ -639,7 +720,10 @@ Student agent 现在可以通过 `create_job` 启动一个 Docker sandbox job - 出于安全考虑，当前版本只建议和本地部署的外部智能体通信 - 当前版本不支持鉴权机制 -### 通过 ACPX 让 Project Agent 使用 Codex +
+ +
+通过 ACPX 让 Project Agent 使用 Codex DrClaw 现在支持让 `project agent` 通过现有的 `exec` / `long_exec` 工具直接执行标准 `acpx` CLI，从而使用 Codex。当前实现**不新增专用 acpx tool**，也**不把 acpx 做成 provider**；agent 看到的是 ACPX 使用说明和内置 skill，然后自己调用 shell 工具执行命令。 @@ -729,76 +813,7 @@ drclaw projects create "acpx-test" acpx codex sessions close drclaw-proj-- ``` -### 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 会被缓存，后续启动自动使用，无需重复登录。 +
## 使用