AstrBot

English

简体中文

English

简体中文

Toggle dark mode

Intro & DeployMessaging PlatformsAI IntegrationUsageDevelopment

Connect to DeerFlow ​

Starting from v4.19.2, AstrBot supports connecting to the DeerFlow Agent Runner.

Preparation: Deploy DeerFlow ​

If you have not deployed DeerFlow yet, please complete installation and startup by following the official DeerFlow documentation:

Make sure DeerFlow is running properly and that AstrBot can reach the DeerFlow gateway. By default, the DeerFlow gateway address is http://127.0.0.1:2026.

TIP

  • API Base URL must start with http:// or https://.
  • If AstrBot and DeerFlow run in different containers or on different hosts, replace 127.0.0.1 with the actual reachable LAN address, hostname, or domain of your DeerFlow service.

Configure DeerFlow in AstrBot ​

In the WebUI, open Config, select the profile to edit, and open AI. Click More actions (…) beside the heading → Change Execution Mode, select DeerFlow, read and check the reset acknowledgement, then click Use This Mode. Make sure Enable AI is on, then enter the connection settings on this page. Switching resets the current mode's configuration; see Agent Runner.

Fill in the following fields:

  • API Base URL: DeerFlow API gateway URL. Default: http://127.0.0.1:2026
  • API Key: Optional. Fill this if your DeerFlow gateway is protected by Bearer auth
  • Authorization Header: Optional. Custom Authorization header value. This takes precedence over API Key
  • Assistant ID: Maps to LangGraph assistant_id. Default: lead_agent
  • Model Name Override: Optional. Overrides the default model configured in DeerFlow
  • Enable Thinking Mode: Whether to enable DeerFlow thinking mode
  • Enable Plan Mode: Maps to DeerFlow is_plan_mode
  • Enable Subagents: Maps to DeerFlow subagent_enabled
  • Maximum Concurrent Subagents: Maps to max_concurrent_subagents. Effective only when subagents are enabled. Default: 3
  • Recursion Limit: Maps to LangGraph recursion_limit. Default: 1000

After filling in the configuration, click Save Configuration.

TIP

  • If DeerFlow already has a default model configured on its side, you can leave Model Name Override empty.
  • Only enable plan mode or subagent related options when the corresponding DeerFlow capabilities are already configured on the DeerFlow side.

Save the Configuration ​

When all fields are complete, click Save Configuration at the bottom right. This profile uses the selected execution mode and connection settings directly; no separate runner provider or provider ID selection is needed.

Common Checks ​

If requests are not being executed through DeerFlow correctly, check the following first:

  • whether the DeerFlow service is running properly
  • whether API Base URL is reachable from the AstrBot environment
  • whether the authentication settings are correct
  • whether Assistant ID matches an actual available assistant in DeerFlow

Deployed on Rainyun Logo