dr-claw

环境要求

• Node.js 与 npm 环境（npx / npm install 需要）
• Python 环境（用于安装 drclaw CLI：pip install -e ./agent-harness）
• 现代浏览器，用于访问 http://localhost:3001
• 至少准备一个执行后端：Claude Code、Gemini CLI 或 Codex
• 可选：OpenRouter API Key，用于接入数百个模型

安装与启动步骤

1. 1一键运行

   推荐方式，无需克隆仓库。运行后浏览器打开 http://localhost:3001 创建账号即可使用。首次运行会下载包，需保持网络畅通。

   npx dr-claw

   复制

2. 2全局安装命令

   需要反复使用时，把 dr-claw 装成全局命令，之后任意目录直接执行 dr-claw 启动。

   npm install -g dr-claw
   dr-claw

   复制

3. 3源码安装与配置

   面向开发者的方式：克隆仓库、安装依赖，并把 .env.example 复制为 .env 以便后续调整端口等设置。

   git clone https://github.com/OpenLAIR/dr-claw.git
   cd dr-claw
   npm install
   cp .env.example .env

   复制

4. 4启动开发服务器

   在项目目录内启动前后端服务；也可改用 drclaw server on 启动守护进程。默认访问地址为 http://localhost:3001。

   npm install && npm run dev

   复制

5. 5安装 drclaw CLI

   在仓库根目录下以可编辑模式安装 agent-harness，得到 drclaw 命令行工具，用于认证与项目管理。

   pip install -e ./agent-harness
   drclaw --help

   复制

6. 6登录认证

   用账号密码登录本地服务，然后用 projects list 验证是否已取得项目列表；把示例账号密码换成你自己的。

   drclaw auth login --username admin --password your-password
   drclaw --json projects list

   复制

7. 7连接 OpenClaw

   把 OpenClaw 指向本地服务器地址，完成后即可通过 OpenClaw 的 shell/exec 能力驱动 Dr. Claw 执行任务。

   drclaw install --server-url http://localhost:3001

   复制

关键配置

如何确认成功

浏览器打开 http://localhost:3001 能创建账号并进入界面；或执行 drclaw --json auth status 验证服务可达、drclaw --json projects list 能返回项目列表。

常见问题

注意事项

• 桌面应用（.dmg / .exe）目前仍是 Beta，追求稳定请走 npx 或源码安装流程。
• 项目免费、模型无关，可搭配 Claude Code、Gemini CLI、Codex 以及 OpenRouter 上的数百个模型，数据与 GPU 都在本机。
• 若安装后 agent 的联网搜索不可用，请参考 README 中的 Troubleshooting Web Search 章节排查。
• Auto Research 的邮件通知需在应用内 Settings → Email 配置，并确保项目已生成 .pipeline/docs/research_brief.json 与 .pipeline/tasks/tasks.json。