b2fc94db9e
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>
99 lines
2.8 KiB
TypeScript
99 lines
2.8 KiB
TypeScript
/**
|
|
* 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`;
|
|
}
|