feat: LLM-powered model auto-configuration and improved onboarding

Major changes:
- Add autoconfigure_models tool for intelligent model assignment
- Implement LLM-based model selection using openclaw agent
- Improve onboarding flow with better model access checks
- Update README with clearer installation and onboarding instructions

Technical improvements:
- Add model-fetcher utility to query authenticated models
- Add smart-model-selector for LLM-driven model assignment
- Use session context for LLM calls during onboarding
- Suppress logging from openclaw models list calls

Documentation:
- Add prerequisites section to README
- Add conversational onboarding example
- Improve quick start flow

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Lauren ten Hoor
2026-02-12 20:37:15 +08:00
parent 84483176f4
commit b2fc94db9e
12 changed files with 835 additions and 304 deletions

View File

@@ -0,0 +1,98 @@
/**
* smart-model-selector.ts — LLM-powered model selection for DevClaw roles.
*
* Uses an LLM to intelligently analyze and assign models to DevClaw roles.
*/
export type ModelAssignment = {
dev: {
junior: string;
medior: string;
senior: string;
};
qa: {
reviewer: string;
tester: string;
};
};
/**
* Intelligently assign available models to DevClaw roles using an LLM.
*
* Strategy:
* 1. If 0 models → return null (setup should be blocked)
* 2. If 1 model → assign it to all roles
* 3. If multiple models → use LLM to intelligently assign
*/
export async function assignModels(
availableModels: Array<{ model: string; provider: string; authenticated: boolean }>,
sessionKey?: string,
): Promise<ModelAssignment | null> {
// Filter to only authenticated models
const authenticated = availableModels.filter((m) => m.authenticated);
if (authenticated.length === 0) {
return null; // No models available - setup should be blocked
}
// If only one model, use it for everything
if (authenticated.length === 1) {
const model = authenticated[0].model;
return {
dev: { junior: model, medior: model, senior: model },
qa: { reviewer: model, tester: model },
};
}
// Multiple models: use LLM-based selection
const { selectModelsWithLLM } = await import("./llm-model-selector.js");
const llmResult = await selectModelsWithLLM(authenticated, sessionKey);
if (!llmResult) {
throw new Error("LLM-based model selection failed. Please try again or configure models manually.");
}
return llmResult;
}
/**
* Format model assignment as a readable table.
*/
export function formatAssignment(assignment: ModelAssignment): string {
const lines = [
"| Role | Level | Model |",
"|------|----------|--------------------------|",
`| DEV | senior | ${assignment.dev.senior.padEnd(24)} |`,
`| DEV | medior | ${assignment.dev.medior.padEnd(24)} |`,
`| DEV | junior | ${assignment.dev.junior.padEnd(24)} |`,
`| QA | reviewer | ${assignment.qa.reviewer.padEnd(24)} |`,
`| QA | tester | ${assignment.qa.tester.padEnd(24)} |`,
];
return lines.join("\n");
}
/**
* Generate setup instructions when no models are available.
*/
export function generateSetupInstructions(): string {
return `❌ No authenticated models found. DevClaw needs at least one model to work.
To configure model authentication:
**For Anthropic Claude:**
export ANTHROPIC_API_KEY=your-api-key
# or: openclaw auth add --provider anthropic
**For OpenAI:**
export OPENAI_API_KEY=your-api-key
# or: openclaw auth add --provider openai
**For other providers:**
openclaw auth add --provider <provider>
**Verify authentication:**
openclaw models list
(Look for "Auth: yes" in the output)
Once you see authenticated models, re-run: onboard`;
}