Skip to content

Commit 0eb9d28

Browse files
authored
Update agent.md
1 parent 2d4b963 commit 0eb9d28

1 file changed

Lines changed: 30 additions & 31 deletions

File tree

docs/user_manual/ai/agent.md

Lines changed: 30 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -48,46 +48,46 @@ Docker not detected, install it? [y/n]: y
4848
## 2.5. Step 5: Configure Image Accelerator and Set Default Parameters
4949
After Docker is installed, the system will prompt whether to configure the image accelerator and then guide you to set the 1Panel port, secure access entry, panel user password, etc., as shown in the figure below. Configure these settings according to your actual situation, and ensure that the specified port is open.
5050

51-
图片1
51+
![img.png](./img/ai/1Panel_Image_Accelerator_Configuration_Log.png)
5252

5353
## 2.6. Step 6: Obtain 1Panel Login Information
5454
After completing all settings, the system will automatically print out the 1Panel login and access information, as shown in the figure below. Save this information for subsequent use.
5555

56-
图片2
56+
![img.png](./img/ai/1Panel_Login_Information_Log.png)
5757

5858
## 2.7. Step 7: Verify the Successful Deployment of 1Panel
5959
Enter the external address obtained in Step 6 into the browser to access the 1Panel login page. Enter the corresponding panel user and password to confirm that 1Panel has been successfully installed and deployed.
60-
图片3
60+
![img.png](./img/ai/1Panel_Login_Page.png)
6161

6262
## 2.8. Step 8: Set the 1Panel Access Address
6363
After entering the panel, switch to the "Panel Settings" page and set the default access address to the public network IP for 1Panel access, so that subsequently deployed applications can be accessed by clicking the "Jump" button.
64-
图片4
64+
![img.png](./img/ai/1Panel_Panel_Settings_Page.png)
6565

6666
## 2.9. Step 9: Upgrade to the Latest Version V2.1.0 (Optional)
6767
For an existing 1Panel installation, log in to the panel and click the update button in the lower right corner to upgrade the current 1Panel to version v2.1.0.
68-
图片5
68+
![img.png](./img/ai/1Panel_Overview_Page_Version_Update.png)
6969

7070
# 3. Large Language Model API Application
7171
You can check the list of models supported on the OpenClaw official website and obtain the API Key of the large language model respectively. This document takes DeepSeek as an example. For other public models and local models, prepare the relevant API Keys by referring to the corresponding documents on your own.
7272

7373
## 3.1. Step 1: Register on the DeepSeek Developer Platform
7474
Access the DeepSeek Developer Platform via the link: https://platform.deepseek.com/, first complete personal real-name authentication and registration, and then make a recharge, as shown in the figure below.
75-
图片6
75+
![img.png](./img/ai/DeepSeek_Developer_Platform_Billing_Page.png)
7676

7777
## 3.2. Step 2: Obtain the DeepSeek API Key
7878
As shown in the figure below, enter the API keys page, click "Create API key", and keep the generated API Key in a safe place for subsequent use after creation.
79-
图片7
79+
![img.png](./img/ai/DeepSeek_API_Key_Creation_Page.png)
8080

8181
# 4. OpenClaw Installation and Deployment
8282
The installation of OpenClaw is deployed based on the agent management of 1Panel, and the DeepSeek large model API key obtained in the previous step needs to be used during the deployment process. In 1Panel, the deployment of OpenClaw and the management of large model API key accounts are divided into two separate parts and decoupled from each other, mainly to facilitate the adjustment of model configurations for your OpenClaw personal assistant.
8383

8484
## 4.1. Step 1: Add a Model Account
8585
Enter the "Agent" management menu under "AI" management, click to enter and switch to "Model Account" management first, then click "Add model account". Select the model provider and enter the model account information as required to complete the model account creation.
86-
图片8
86+
![img.png](./img/ai/1Panel_Add_Model_Account_Page.png)
8787

8888
## 4.2. Step 2: Create an Agent
8989
After preparing the model account, switch to the "Agent" page and click "Create Agent", then enter the relevant parameters as required, as shown in the figure below:
90-
图片9
90+
![img.png](./img/ai/1Panel_Create_Agent_Parameter_Page.png)
9191

9292
The parameter definitions during agent creation are detailed as follows:
9393

@@ -97,24 +97,24 @@ The parameter definitions during agent creation are detailed as follows:
9797
- Bridge Port: The default port of OpenClaw is 18790, which can be customized and must be open.
9898
- Model Provider: The currently supported models are shown in the figure. Select the DeepSeek model provider added just now. If the model account for the corresponding model provider has been added, the number of model accounts will be prompted directly.
9999

100-
图片10
100+
![img.png](./img/ai/1Panel_Model_Provider_Select_Page.png)
101101

102102
- Other Model Parameters: After selecting the model provider, the system will automatically retrieve the maintained model accounts, as shown in the figure below. You can also check "Manual input" to enter the model information manually. If no model account has been created, click "Create model account" to complete the creation.
103103

104-
图片11
104+
![img.png](./img/ai/1Panel_Model_Account_Associate_Page.png)
105105

106106
- Token: A token for the OpenClaw Web UI access address, which is automatically generated by the system for direct access in the follow-up.
107107
- Other Parameters: Keep the default configurations for all other parameters.
108108

109109
After configuring all the above parameters, click "Confirm" directly to start the installation of OpenClaw. The installation is completed when the prompt as shown in the figure below appears.
110-
图片12
110+
![img.png](./img/ai/1Panel_OpenClaw_Installation_Log.png)
111111

112112
## 4.3. Step 3: Verify the Successful Deployment of OpenClaw
113113
After the installation and deployment of OpenClaw are completed, enter the agent list page and click "WebUI" to jump directly to the OpenClaw page, as shown in the figure below.
114-
图片13
114+
![img.png](./img/ai/1Panel_Agent_List_OpenClaw_Page.png)
115115

116116
After entering the OpenClaw page, send a message and check if the AI assistant responds. A normal response, as shown in the figure below, indicates that OpenClaw has been successfully deployed.
117-
图片14
117+
![img.png](./img/ai/OpenClaw_WebUI_Chat_Test_Page.png)
118118

119119
# 5. Feishu Channel Configuration
120120
Up to this point, OpenClaw has been fully deployed. Next, we will configure the Feishu channel. To configure the Feishu channel, we first need to create an available robot in Feishu. Follow the steps below to complete the configuration step by step.
@@ -123,21 +123,21 @@ Note: A personal Feishu account is used in this guide. For enterprise accounts,
123123

124124
## 5.1. Step 1: Create a Custom Enterprise App
125125
First, log in to Feishu and enter the Feishu Open Platform (link: https://open.feishu.cn/app), then access the "Developer Console" and select "Custom Apps", click "Create Custom App", as shown in the figure below.
126-
图片15
126+
![img.png](./img/ai/Feishu_Open_Platform_Custom_Apps_List.png)
127127

128128
As shown in the figure below, enter the relevant app name and basic information as required and click "Create".
129-
图片16
129+
![img.png](./img/ai/Feishu_Create_Custom_App_Page.png)
130130

131131
## 5.2. Step 2: Create a Bot
132132
As shown in the figure below, click to create a bot to complete the bot creation process.
133-
图片17
133+
![img.png](./img/ai/Feishu_Add_Bot_Feature_Page.png)
134134

135135
After entering the bot page, click the edit button after bot configuration to define the bot name, as shown in the figure below:
136-
图片18
136+
![img.png](./img/ai/Feishu_Bot_Setting_Page.png)
137137

138138
## 5.3. Step 3: Permission Configuration
139139
After creating the bot, click to enter "Permissions & Scopes" and then click "Batch import/export scopes".
140-
图片19
140+
![img.png](./img/ai/Feishu_Permissions_Scopes_Page.png)
141141

142142
Click "Batch import/export scopes", clear the default permission configuration information, copy and paste the permission authorization script as shown below, and click "Save".
143143

@@ -180,43 +180,42 @@ Click "Batch import/export scopes", clear the default permission configuration i
180180
```
181181

182182
The effect after pasting is shown in the figure below:
183-
图片20
183+
![img.png](./img/ai/Feishu_Batch_Import_Scopes_Page.png)
184184

185185
Click "Next, Review New Scopes" and finally ensure that all permissions are enabled. For personal accounts, confirm the permissions by yourself; for enterprise accounts, administrator review is required. Ensure all permissions are enabled as shown in the figure below:
186-
图片21
186+
![img.png](./img/ai/Feishu_Permissions_Scopes_Review_Page.png)
187187

188188
## 5.4. Step 4: Obtain Credentials and Configure in 1Panel
189189
Enter the Feishu platform and obtain the app credentials in "Credentials & Basic Info", as shown in the figure below:
190-
图片22
190+
![img.png](./img/ai/Feishu_Credentials_Basic_Info_Page.png)
191191

192192
After obtaining the credentials, enter the "Configuration" page of "Agent" in 1Panel, complete the Feishu chat channel configuration, and click "Save", as shown in the figure below:
193-
图片23
193+
![img.png](./img/ai/1Panel_OpenClaw_Feishu_Channel_Config.png)
194194

195195
## 5.5. Step 5: Create Events and Callbacks
196196
As shown in the figure below, enter the "Events & Callbacks" menu and complete the subscription method setting and event addition respectively.
197-
图片24
197+
![img.png](./img/ai/Feishu_Events_Callbacks_Page.png)
198198

199199
### Subscription Method Setting
200200
Select the persistent connection subscription method as shown in the figure below:
201-
图片25
201+
![img.png](./img/ai/Feishu_Event_Subscription_Mode_Setting.png)
202202

203203
### Add Events:
204204
Enter "im.message.receive_v1" to search, check "Receive messages" based on "App-based Subscription", and finally confirm the addition.
205-
图片26
205+
![img.png](./img/ai/Feishu_Add_Event_Im_Message_Receive.png)
206206

207207
## 5.6. Step 6: Create and Release a Version
208208
After confirmation, click "Create Version", then enter the relevant version information as required and release it. No approval is required for personal accounts, while enterprise accounts need enterprise approval.
209-
图片27
209+
![img.png](./img/ai/Feishu_Create_App_Version_Page.png)
210210

211211
## 5.7. Step 7: Verify the Feishu Channel Configuration
212212
After completing all the above configurations, open the app in the Feishu client as shown in the figure below:
213-
图片28
213+
![img.png](./img/ai/Feishu_Client_OpenClaw_Bot_List.png)
214214

215215
Finally, perform a simple test. The prompt as shown in the figure below indicates that the configuration is successful.
216-
图片29
216+
![img.png](./img/ai/Feishu_OpenClaw_Bot_Chat_Test_Page.png)
217217

218218
# 6. Model Configuration Modification
219219
If you need to switch the model when using the OpenClaw personal AI assistant, also enter the "Agent" list, click "Configuration", enter the model switching menu, complete the model configuration modification and click "Save", as shown in the figure below:
220-
图片30
220+
![img.png](./img/ai/1Panel_OpenClaw_Model_Configuration_Modify.png)
221221

222-
图片31

0 commit comments

Comments
 (0)